docs: 重写 README —— 按 1.0.0 现状重排为「产品说明书 + 验收对照表」
结构重排：组成部分 → 交付产物与部署形态 → 快速开始 → 功能说明（Web 端 / 客户端 / 灵动岛 / 作业 / 叫人 / 上课时段 / 导入 / ClassIsland 联动 / 数据库管理）→ 技术参考（目录结构 / 技术栈 / REST API / WebSocket / RBAC / 模块化 / 数据库与迁移）→ 验收 → 打包与交付 → 常见问题 → 后续增强。 1594 行 → 1236 行，去掉的是与 AGENTS.md 重复的踩坑叙述与「按阶段的交付清单」文件流水（后者改由目录结构 与 git 历史承载）。 修正过期内容： - 迁移数 9 → 10（补回 add_schedule_source），迁移清单同步 - verify:e2e 173 项 → 186 项；verify:web 30/31、verify:desktop 99/102、插件静态契约 68/68 按最近一次实测重写 - 删掉两条与现状相反的验收行（「客户端设置页提供修改密码」），改为「客户端有意不提供改密入口」， 与 AGENTS.md §5 第 31 条、冒烟断言「改密入口存在=false」一致 - 服务端安装包体积口径统一为 ~71MB（切库依赖内置后）；插件版本 1.0.0.0；正文标注当前版本 1.0.0 新增与加强： - 补 1.0.0 的内容：数据库管理（仅管理员）、新手引导（Web 端 el-tour + 客户端六步向导）、 设置拆 6 个子路由、深色模式、客户端主窗口与 ClassIsland 对齐（1242x582）、 课表 source 字段与「幽灵行清理」口径 - 6.3「已知的时序 / 环境相关用例」：写明 verify:desktop 那 3 项在「当前正在上课」时必然失败的原因， 并给出各验证脚本覆盖凭据的方式（ELECTRON_SMOKE_* / UI_SMOKE_* 支持环境变量，verify:e2e 不支持） 验证（2026-10-02 本机）：verify:e2e 186/186；verify:web 30/31（1 项为既有脆弱用例）； verify:desktop 99/102（3 项时序相关）；verify:classisland-plugin 68/68；typecheck 与 lint 通过。
This commit is contained in:
LoveChengke committed
1 parent
572295c297
commit
aad22df4fd
1 file changed
+639
-997