[{"_1":2,"_164":-5,"_165":-5},"loaderData",{"_3":4,"_17":18,"_25":26,"_143":144},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","routes/_layout",{"_19":-5,"_20":21,"_22":21,"_23":11,"_24":21},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_27":28,"_29":-5,"_30":11,"_31":11,"_32":33,"_34":35,"_36":-5,"_37":11,"_38":39,"_88":-5,"_89":90,"_131":-5,"_132":11,"_133":21,"_134":11,"_135":11,"_136":-5,"_137":11,"_138":-5,"_139":140,"_141":91,"_142":-7},"canonicalUrl","https://hub.docker.com/r/brian9909/class-schuedule/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","brian9909","reponame","class-schuedule","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_42":43,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":55,"_57":35,"_32":33,"_58":59,"_60":44,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":33,"_73":74,"_79":11,"_80":81,"_85":33,"_86":87},"categories",[],"content_types",[44],"image","date_registered","2026-10-13T08:00:06.696488Z","description","课程表 + 天气 + 备忘 + 展示看板,家校一体化应用(React + 零依赖 Node)","is_private","last_updated","2026-10-14T04:28:31.187129Z","last_modified","2026-10-14T04:28:32.381392Z","media_types",[56],"application/vnd.oci.image.index.v1+json","name","pull_count",193,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# 课程表 · 家校助手\n\n课程表 + 天气 + 备忘 + 展示看板的一体化应用。前端 React + Vite,后端是一个**零依赖**的 Node HTTP 服务(只用 `node:` 内置模块,没有一个 npm 运行时依赖),所有数据都保存在容器挂载的本地目录里 —— 换手机、换浏览器、清缓存都还是同一份数据。\n\n

\n $\"课程表\"$ \n

\n\n## ⚠️ 部署提醒(必读)\n\n**本项目的写接口不校验登录**,是刻意保留的:看板页要写备忘,而家长后台 `/admin` 的保护是\"每个学生一把页面密码\"(首次进入时设置,超管可重置),它拦的是页面入口、不是后端接口本身。账号密码登录只用于 `/superadmin` 管理界面。因此:\n\n- ✅ 部署在**家庭内网 / NAS / 小主机**,没问题\n- ❌ **不要直接暴露到公网**。要暴露的话,请在前面套一层反向代理(Nginx / Caddy + Basic Auth,或 frp + 白名单)做整体鉴权\n\n---\n\n## 快速开始 · 拉预构建镜像(推荐)\n\n**1. 新建一个目录,里面放这个 `docker-compose.yml`**:\n\n```yaml\nservices:\n class-schedule:\n # Docker Hub 镜像;也可改用 GHCR:ghcr.io/brian099/class-schedule:latest\n image: brian9909/class-schuedule:latest\n container_name: class-schedule\n restart: unless-stopped\n ports:\n - \"21873:21873\"\n volumes:\n - ./data:/app/data\n environment:\n TZ: Asia/Shanghai\n # 你自己的对外访问地址(分享到微信生成图文卡片时会用到)\n # PUBLIC_ORIGIN: \"https://your-domain.example.com\"\n```\n\n**2. 一条命令启动**:\n\n```bash\ndocker compose up -d\n```\n\n**3. 浏览器打开** `http://<机器IP>:21873/superadmin`,首次会引导你创建超管账号,登进去添加学生即可。\n\n预构建镜像只发布 `linux/amd64`(CI 里 arm64 需 QEMU 模拟、构建极慢且不稳定,暂未开启)。arm64 设备(树莓派、Apple Silicon Mac)请改用下面的「从源码构建」在本地构建;Apple Silicon 也可让该 amd64 镜像以模拟方式运行,性能略差。\n\n## 快速开始 · 从源码构建\n\n想改代码或者不想拉预构建镜像:\n\n```bash\ngit clone https://github.com/Brian099/class-schedule.git\ncd class-schedule\ndocker compose up -d --build\n```\n\n国内网络较慢的话,打开 `docker-compose.yml`,把 `image:` 那行注释掉、启用下面的 `build:` 段,并把 `NPM_REGISTRY` / `NODE_IMAGE` 改成国内镜像(注释里有示例)。\n\n## 访问地址\n\n| 用途 | 地址 | 说明 |\n| --- | --- | --- |\n| 学生主页 | `http://IP:21873/?id=<学生ID>` | 日常查看当天课程,**必须带 `?id=`** |\n| 家长后台 | `http://IP:21873/admin?id=<学生ID>` | **需家长密码**(首次进入时设置,超管可重置);改课表 / 课程库 / 备忘 |\n| 展示看板 | `http://IP:21873/board?id=<学生ID>` | 平板 / 墨水屏 / 电视常亮用 |\n| 超管 | `http://IP:21873/superadmin` | 账号密码,管理学生列表与全局设置 |\n\n学生 ID 在超管里创建学生时生成,后台「基本信息」里可以直接复制各个链接。\n\n## 数据保存与备份\n\n全部在 compose 挂载的 `./data` 目录(容器内 `/app/data`):\n\n```\ndata/\n├── config.json # 课表配置:学生、课程库、节次、假期(引用头像)\n├── memos.json # 备忘(文字、提醒时间)\n├── avatars/ # 头像文件本体\n├── attachments/ # 备忘附件本体(图片/视频/音频/文件)+ .meta.json\n├── auth.json # 超管账号(scrypt 加盐哈希)\n├── admin-auth.json # 各学生的家长后台密码(scrypt 加盐哈希)\n├── sessions.json # 登录会话(超管 / 家长后台,按作用域区分)\n└── cache/ # 节假日数据缓存(可随时删)\n```\n\n- **备份**:`cp -r data data-backup-$(date +%F)`,不必停服务\n- **恢复**:把 `data/` 拷回原位,`docker compose up -d`\n- **迁移**:整个项目目录(含 `data/`)拷到新机器,再 `docker compose up -d`\n\n## 环境变量\n\n在 `docker-compose.yml` 的 `environment` 里改,改完 `docker compose up -d`。\n\n| 变量 | 默认 | 说明 |\n| --- | --- | --- |\n| `PORT` | `21873` | 容器内监听端口(改对外端口请改 compose 的 `ports`) |\n| `PUBLIC_ORIGIN` | 空 | 对外访问根地址,如 `https://kcb.example.com`。分享到微信 / QQ 生成图文卡片时,配图和链接要用绝对地址;留空则按请求头推断(反代后面可能不准) |\n| `DATA_DIR` | `/app/data` | 数据目录,不建议改 |\n| `TZ` | `Asia/Shanghai` | 时区。错了会导致\"今天是周几\"和上课高亮不对 |\n| `MAX_UPLOAD_MB` | `512` | 单个附件上限(要传长视频就调大) |\n| `MAX_JSON_MB` | `64` | 配置/备忘单次提交上限 |\n| `PRUNE_GRACE_HOURS` | `6` | 附件回收宽限期:刚上传还没保存进备忘的附件,这段时间内不会被清掉 |\n\n## 常用命令\n\n```bash\ndocker compose logs -f # 看日志\ndocker compose restart # 重启(数据不丢)\ndocker compose down # 停掉(数据不丢,在 ./data 里)\ndocker compose pull # 拉最新镜像\ndocker compose up -d # 拉完后重启使用新镜像\n```\n\n## 分享到微信显示图文卡片\n\n把学生课表链接发到微信,想显示成带图文的卡片而不是一串网址 —— 已经内置支持,不需要公众号 / 小程序 / 后端签名:\n\n- 服务端会按 `?id=` 给每个页面注入 Open Graph 标签(`og:title` / `og:description` / `og:image` / `og:url`)\n - **标题** = 该学生的标题\n - **描述** = 后台「分享描述」里填的内容,留空则按标题自动生成\n - **配图** = 该学生的头像(没设头像时用入口图)\n- 前提:`PUBLIC_ORIGIN` 要配成用户实际访问的域名(微信要求配图 / 链接是绝对地址)\n\n两个使用注意(属于微信机制,与本项目代码无关):\n\n1. **直接把链接粘到聊天框仍是纯文本**。微信只对\"在内置浏览器里打开过再分享\"的链接抓卡片。首次可以:发到「文件传输助手」→ 长按 →「搜一搜」→「访问网页」→ 右上角「···」→「分享给朋友」,这次就是卡片了;之后再分享都会优先显示卡片\n2. **新域名可能被拦(\"无法确认安全性\")**。到提交申诉,一般 1–2 个工作日解除\n\n分享配图建议正方形(微信按 478×478 裁剪)、`< 2MB`、JPG / PNG —— 后台上传的头像满足即可。\n\n## 本地开发\n\n需要两个进程:后端提供 `/api`,Vite 提供热更新并把 `/api` 代理过去。\n\n```bash\nnpm install\nnpm run dev:server # 后端,数据落在 ./.data,端口 8787\nnpm run dev # 前端 http://localhost:3000\n```\n\n其他脚本:\n\n```bash\nnpm run typecheck # tsc\nnpm run lint # oxlint\nnpm run build # 产出 dist/\nnpm run serve # 用后端直接托管 dist/(生产模式,默认端口 21873)\n```\n\n## 项目结构\n\n```\nserver/ 零 npm 依赖的后端(只用 node: 内置模块)\n├── index.mjs HTTP 入口:静态托管 dist/ + /api 路由\n├── store.mjs 数据落盘:原子写(.tmp + rename)、写入串行排队、附件回收\n├── static.mjs 静态文件:MIME、ETag/304、Range/206(视频拖进度条)、SPA 回落\n└── upstream.mjs 外网代理:中国天气网反代(需 VITE_NMC_BASE 启用)、节假日数据(带缓存与降级)\n\nsrc/api/\n├── client.ts 前端唯一的数据出入口:启动时 /api/state 灌满缓存,\n│ 读走同步缓存、写乐观更新 + PUT,失败回滚;\n│ 轮询 /api/rev 做跨设备同步\n└── migrate.ts 老浏览器数据(localStorage / IndexedDB)一次性上传\n```\n\n天气默认由浏览器直连中国天气网(`https://www.nmc.cn` 已放开 CORS);若改为走后端反代(nmc 收紧 CORS、或想统一走服务器出口),构建时把 `VITE_NMC_BASE` 设为 `/api/nmc` 即可 —— 后端 `server/upstream.mjs` 已内置该反代,无需改代码。节假日优先走后端 `/api/holidays/<年>`,后端会去试几个公开数据源并把结果缓存到 `data/cache/`,拿不到时回落到缓存,离线也能用。\n\n## License\n\n[MIT](LICENSE) © 2026 Brian099\n","has_starred","hub_user","immutable_tags_settings",{"_75":11,"_76":77},"enabled","rules",[78],".*","is_automated","permissions",{"_82":21,"_83":11,"_84":11},"read","write","admin","user","storage_size",78539682,"orgData","recentTags",[91],{"_92":44,"_93":94,"_95":96,"_97":98,"_99":100,"_101":102,"_50":119,"_120":94,"_121":33,"_122":56,"_57":123,"_124":125,"_126":127,"_128":119,"_129":66,"_130":21},"content_type","creator",37355349,"digest","sha256:96082f4744170868d2daa336b58d9bc7741fec68a9c5898595be006d14b7746b","full_size",66719771,"id",1346560549,"images",[103],{"_104":105,"_95":106,"_107":108,"_109":110,"_111":112,"_113":114,"_115":108,"_116":-5,"_117":98,"_63":66,"_118":-5},"architecture","amd64","sha256:70a7697a80a6dbc651ad5896ab1d18181df9d8ed575798bac80961cd12b92e74","features","","last_pulled","2026-10-15T02:43:25.52989937Z","last_pushed","2026-10-14T04:28:29.946920292Z","os","linux","os_features","os_version","size","variant","2026-10-14T04:28:30.813759Z","last_updater","last_updater_username","media_type","latest","repository",32862342,"tag_last_pulled","2026-10-16T19:02:36.578804235Z","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxRunInCloud","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_38":145,"_152":153,"_139":162,"_163":11},{"_40":146,"_42":147,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":148,"_57":35,"_32":33,"_58":59,"_60":44,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":33,"_73":149,"_79":11,"_80":151,"_85":33,"_86":87},[],[44],[56],{"_75":11,"_76":150},[78],{"_82":21,"_83":11,"_84":11},"tags",{"_154":64,"_155":-5,"_156":-5,"_157":158},"count","next","previous","results",[159],{"_92":44,"_93":94,"_95":96,"_97":98,"_99":100,"_101":160,"_50":119,"_120":94,"_121":33,"_122":56,"_57":123,"_124":125,"_126":127,"_128":119,"_129":66,"_130":21},[161],{"_104":105,"_95":106,"_107":108,"_109":110,"_111":112,"_113":114,"_115":108,"_116":-5,"_117":98,"_63":66,"_118":-5},[],"canDeleteTags","actionData","errors"]

brian9909/class-schuedule

Tags for brian9909/class-schuedule