dkorunic/e-dnevnik-bot

e-dnevnik-bot

https://goreportcard.com/badge/github.com/dkorunic/e-dnevnik-bot](https://goreportcard.com/report/github.com/dkorunic/e-dnevnik-bot) https://github.com/dkorunic/e-dnevnik-bot/actions/workflows/goreleaser.yml/badge.svg](https://github.com/dkorunic/e-dnevnik-bot/actions/workflows/goreleaser.yml)

镜像概述和主要用途

e-Dnevnik bot是一个自托管警报系统，用于从官方CARNet e-Dnevnik平台定期轮询新信息（如所有科目的新成绩、新安排的考试等）。该系统支持以多个AAI/AOSI用户身份登录skole.hr，可单次运行或作为服务定期（如每小时）检查所有用户的新信息，通过多种消息服务发送未查看过的新警报。所有认证信息仅存储在本地设备或服务器上。

重要更新（2023年5月）：由于CARNet实施了防火墙限制，仅允许克罗地亚境内IP访问，因此该bot若托管在境外（如Oracle Cloud、AWS、Azure等主流VM/VPS提供商）将无法获取信息，建议在家庭或办公室自行托管。

核心功能和特性

• 多用户支持：可配置多个skole.hr域的AAI/AOSI用户账号，并行处理信息
• 多消息渠道：支持通过***、***、Slack和电子邮件发送警报，每个渠道可配置多个接收者
• 运行模式：支持单次运行或服务模式（定期轮询，默认每小时）
• 本地数据存储：所有认证信息和警报数据库本地存储，不向外部传输
• 资源占用低：运行时内存占用约20-25MB，磁盘空间需求小（约1MiB可存储50条成绩记录）
• Google日历集成：可将考试事件添加到Google日历（遵循Google API用户数据政策）

使用场景和适用范围

• 学生和家长：实时获取学校成绩和考试安排更新，无需频繁手动查看e-Dnevnik
• 多子女家庭：通过配置多个用户账号，同时监控多个学生的学习情况
• 教育机构：作为内部工具帮助教师或管理员跟踪学生成绩更新

系统要求

• 存储：运行目录及少量磁盘空间（约1MiB可存储50条成绩记录）
• 账号：skole.hr域的AAI/AOSI登录账号，至少一个消息服务账号（//Slack/电子邮件）
• 环境：可运行在任何嵌入式设备（如Raspberry Pi）或支持的操作系统，需位于克罗地亚境内网络

安装和使用方法

安装

从https://github.com/dkorunic/e-dnevnik-bot/releases%E4%B8%8B%E8%BD%BD%E4%BA%8C%E8%BF%9B%E5%88%B6%E6%96%87%E4%BB%B6%EF%BC%8C%E5%B9%B6%E4%B8%8B%E8%BD%BDhttps://raw.githubusercontent.com/dkorunic/e-dnevnik-bot/main/.e-dnevnik.toml.example%E3%80%82

命令参数

shell
NAME
  e-dnevnik-bot

FLAGS
  -v, --verbose                详细/调试日志级别
  -0, --fulldebug              记录所有抓取事件（仅在详细模式下）
  -d, --daemon                 启用守护进程模式（作为服务运行）
  -?, --help                   显示帮助信息
  -t, --test                   发送测试事件（检查消息服务是否正常）
  -l, --colorlogs              启用彩色控制台日志
      --version                显示程序版本
  -f, --conffile STRING        配置文件（TOML格式）（默认：.e-dnevnik.toml）
  -b, --database STRING        警报数据库文件（默认：.e-dnevnik.db）
  -g, --calendartoken STRING   Google日历令牌文件（默认：calendar_token.json）
  -x, --calendarcred STRING    Google日历凭据文件（默认：calendar_credentials.json）
  -c, --cpuprofile STRING      CPU性能分析输出文件
  -m, --memprofile STRING      内存性能分析输出文件
  -i, --interval DURATION      守护进程模式下的轮询间隔（默认：1h0m0s）
  -r, --retries UINT           错误时的重试次数（默认：3）

配置说明

配置文件采用https://github.com/toml-lang/toml%E6%A0%BC%E5%BC%8F%EF%BC%8C%E5%8C%85%E5%90%AB%E7%94%A8%E6%88%B7%E9%85%8D%E7%BD%AE%E5%92%8C%E6%B6%88%E6%81%AF%E6%9C%8D%E5%8A%A1%E9%85%8D%E7%BD%AE%E3%80%82%E7%94%A8%E6%88%B7%E9%85%8D%E7%BD%AE%E5%8F%AF%E9%87%8D%E5%A4%8D%E5%A4%9A%E6%AC%A1%EF%BC%8C%E6%B6%88%E6%81%AF%E6%9C%8D%E5%8A%A1%E9%85%8D%E7%BD%AE%EF%BC%88***/***/Slack/%E9%82%AE%E4%BB%B6%EF%BC%89%E5%90%84%E6%9C%80%E5%A4%9A%E5%87%BA%E7%8E%B0%E4%B8%80%E6%AC%A1%E3%80%82

用户配置

toml
[[user]]
username = "ime.prezime@skole.hr"  # skole.hr域的AAI/AOSI用户名
password = "lozinka"               # 对应密码

可配置多个用户块，系统将并行处理所有用户的信息。

***配置

toml
[telegram]
token = "telegram_bot_token"  # Telegram机器人令牌
chatids = [ "chat_id", "chat_id2" ]  # 接收警报的聊天ID列表

配置步骤：

1. 通过***机器人创建指南创建机器人，获取令牌
2. 使用每个接收账号向机器人发送消息，通过https://api.telegram.org/botTOKEN/getUpdates（替换TOKEN为实际令牌）获取聊天ID

***配置

toml
[discord]
token = "discord_bot_token"   # Discord机器人令牌
userids = [ "user_id", "user_id2" ]  # 接收警报的用户ID列表

配置步骤：

1. 参考***机器人创建指南创建机器人并邀请至服务器
2. 仅授予"Send Messages"权限
3. 在***客户端启用"开发者模式"，通过消息获取用户ID

Slack配置

toml
[slack]
token = "xoxb-slack_bot_token"  # Slack机器人令牌
chatids = [ "chat_id", "chat_id2" ]  # 接收警报的聊天ID/频道ID列表

配置步骤：

1. 参考Slack机器人创建指南创建机器人
2. 授予"chat:write"权限
3. 通过用户资料"Copy member ID"获取用户ID，或使用频道ID发送群消息

邮件/SMTP配置

toml
[mail]
server = "smtp.gmail.com"      # SMTP服务器地址
port = "587"                   # SMTP端口
username = "user.name@gmail.com"  # SMTP用户名
password = "legacy_app_password"  # SMTP密码（Gmail需使用应用专用密码）
from = "user.name@gmail.com"   # 发件人邮箱
subject = "Nova ocjena iz e-Dnevnika"  # 邮件主题
to = [ "user.name@gmail.com", "user2.name2@gmail.com" ]  # 收件人列表

配置步骤：参考Gmail SMTP配置指南，其他SMTP服务配置类似。

Docker部署示例

Docker run命令

shell
# 创建持久化目录并下载配置文件
mkdir ednevnik
curl https://raw.githubusercontent.com/dkorunic/e-dnevnik-bot/main/.e-dnevnik.toml.example --output ednevnik/.e-dnevnik.toml
# 编辑配置文件
editor ednevnik/.e-dnevnik.toml

# 拉取镜像并运行容器
docker pull dkorunic/e-dnevnik-bot
docker run --detach \
    --volume "$(pwd)/ednevnik:/ednevnik" \
    --restart unless-stopped \
    dkorunic/e-dnevnik-bot \
    --daemon \
    --verbose \
    --database /ednevnik/.e-dnevnik.db \
    --conffile /ednevnik/.e-dnevnik.toml

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: "3"
services:
  ednevnik:
    container_name: e-dnevnik
    image: dkorunic/e-dnevnik-bot:latest
    command:
      - "--daemon"
      - "--database=/ednevnik/.e-dnevnik.db"
      - "--conffile=/ednevnik/.e-dnevnik.toml"
    volumes:
      - ./ednevnik:/ednevnik  # 挂载本地目录以持久化配置和数据库
    restart: unless-stopped

使用步骤：

1. 创建项目目录并创建上述docker-compose.yml
2. 创建ednevnik子目录并下载配置文件：

   bash
   mkdir ednevnik
   curl https://raw.githubusercontent.com/dkorunic/e-dnevnik-bot/main/.e-dnevnik.toml.example --output ednevnik/.e-dnevnik.toml
   

3. 编辑配置文件后启动容器：

   bash
   docker compose up -d
   

4. 停止容器：

   bash
   docker compose down
   

隐私政策

该bot使用Google API服务将学校考试事件添加到Google日历，获取的信息使用遵循Google API服务用户数据政策及有限使用要求。所有Google授权数据（如API令牌）仅本地存储，不向外传输，不收集或存储用户数据，不跟踪使用情况。