ila
ab23ff60e5
- schema v8：lexgo_book_attachments（按 book_id+kind 唯一，bytes MEDIUMBLOB）与 lexgo_playback_positions（owner_id+book_id 主键），只用可重放 DDL，外键级联删书 - 后端：按文件头 magic bytes 判定类型（MP3 / JPG / PNG / WebP，含 WebP 维度解析）， 音频 ≤20 MiB、封面 ≤2 MiB 且 ≤4096²；上传/替换/移除；binaryResponse 交给 http.ServeContent 提供 Range 206、416、ETag 与 304；播放位置 upsert，替换音频时重置 - 学习端：带凭据的 fetch + 对象 URL（令牌不进 URL），书库封面、书籍页「音频与封面」 区块、阅读页常驻播放器（播放/暂停、进度、0.75–1.5 倍速、错误重试、位置上报） - 测试：Go 86 项（新增附件单测/集成与 v7→v8 迁移）、学习端 157 单测与 26 项 E2E - 顺带修掉 e2e/phrase.spec.ts 的偶发失败：重试条件改为断言期望词数、重读坐标、关面板后重试 - 文档：Architecture / Business-Rules / Local-Development / Requirements / Home / Deployment-and-Operations（备份范围含附件与体积提示）
LexGo
面向自托管场景的阅读式语言学习项目，规划提供内容导入、阅读查词、词汇与短语、复习和实例管理。
已确认：DevHarness 轻量模式、MySQL 8、go-admin 管理端。工程基础 #2 已通过验收：两端用户名登录、学习账号管理、可撤销会话和本人英语空空间。管理端基于指定 go-admin/go-admin-ui 选用模块，学习端为独立 Vue 3 + TypeScript + Vite 工程，共用 Go 后端和 MySQL 8.4.3。#18 登录日志与操作审计已通过用户验收，支持管理员查询和 90 天保留清理。#5 粘贴导入与章节原文阅读已验收并合入 main；#6 全 Go 英语词典与点词查义已通过用户验收，PR #25 已合入 main；#7 个人词条与学习状态已通过用户验收，PR #26 已合入 main；#8 到期单词复习已通过用户验收，PR #27 已合入 main；#9 上传 TXT、校验编码后导入本人书库已通过用户验收，PR #28 已合入 main；#10 编辑与删除本人书籍章节已通过用户验收，PR #29 已合入 main；#11 连续短语的选择、保存与复习已通过用户验收，PR #30 已合入 main；#12 词汇库的搜索、筛选与编辑已通过用户验收，PR #31 已合入 main。#13 完成章节与个人基础进度已通过用户验收，PR #33 已合入 main（schema v7 需显式迁移）。#14 桌面与手机体验、主题与键盘操作已通过用户验收，PR #34 已合入 main。试用交付仍未实现。MVP 定位为“支持多账号、数据独立的自托管学习工具”，先邀请少量用户使用；F01～F12 已确认，X 系列后置。
- 文档入口 · 线上 Wiki
- 英语分词与离线词典验证小样（#3 已验收，独立本机入口）
- 阅读选择验证小样（#4 已验收，真机详细测试证据缺口保留）
- 项目档案 · 需求总览
- 工作量估算：#2、#3、#4、#5、#6、#7、#8、#9、#10、#11、#12、#13、#14、#18 已验收，原规划中的 #5 已完成；#15 与 #21 已实现待验收；#24 待排期；缺陷 #32 待确认修复方案；后续结合集成结果重估，旧全量研究仅供参考。
- 四阶段实施总览 #16：14 张单元工单，工程基础 → 技术验证 → 首条学习闭环 → 补齐 MVP；原型 v1 已获用户验收。两端使用账号（用户名）＋密码登录，不要求邮箱。
- 原型工单 #1：Quant-UX 桌面/手机原型 v1，预览入口与审核记录见工单及需求总览。
- 运维命令：
./lexgo migrate|bootstrap|serve|backup|restore|verify（纯二进制），开发便利与交叉验证走python scripts/server.py …/python scripts/ops.py … - 工作流 · 开发与验证 · 部署与运维
本地工程基础
运行前在 MySQL 8 中准备项目专用空库，复制 .env.example 为忽略的 .env.local 并填写本机连接及初始管理员密码。首次执行 python scripts/server.py migrate、python scripts/server.py bootstrap（等价纯二进制路径：./server/lexgo migrate / bootstrap）；随后执行 python scripts/server.py serve。两端分别通过 npx --yes pnpm@9.15.1 --dir admin dev、npx --yes pnpm@9.15.1 --dir learner dev 启动，首次需安装锁定依赖。书籍封面与音频附件（#21）存于数据库，包含在 scripts/ops.py backup 与 ./server/lexgo backup 的备份范围内。
本地入口：学习端 http://127.0.0.1:5173，管理端 http://127.0.0.1:5174。完整安装与测试命令见开发与验证。账号使用用户名，无需邮箱；没有随代码交付的默认密码。
本机三个服务已由 D:/supervisord/supervisord.conf 中的 lexgo-learner、lexgo-admin、lexgo-api 托管，使用时不要重复手动启动同端口。当前 schema v4；从 #2/#18 升级时停止 API，执行 build、migrate 后再启动。审计过期清理可执行 python scripts/server.py audit-cleanup，只影响超过 90 天的日志。
英语词典与点词查义（#6）
正式后端为纯 Go，lexgo.exe serve 不启动 Python NLP。开发辅助脚本与历史小样保留。
管理员在“英语词典”页下载并导入指定 WordNet 3.0 ZIP；来源、固定摘要及许可见 资源清单。词典提供英语释义，保存在 MySQL 中；导入失败保留当前资源，重复导入不新增资源并重新启用。也可在管理页停用。
学习者打开本人就绪章节，点击词语或聚焦后按 Enter/空格查询；Escape/关闭返回阅读。精确词形优先，未命中再查规则候选，例如 went → go。个人释义当前是未保存的临时草稿，保存功能在 #7 实现。真机测试证据尚未补齐。
文档与治理
远端为 https://git.ilapage.cn/OPC/lexgo.git，默认分支 main。需要工单的任务以 Gitea 工单为单次任务事实来源；轻量直接实施项通过 Git 提交和结果报告留痕。长期规则以 Wiki 为主源，docs 为单向镜像；默认不创建任务归档。
新项目接入顺序：创建 Gitea 远端仓库并推送当前引导提交，启用工单和 Wiki；优先使用已配置的 Gitea MCP。Home 不存在时先创建并回读 Home，再逐页发布并读取 revision，最后运行下列验证。本地 docs/ 的存在不能证明线上 Wiki 已初始化。
python dev_scripts/harness.py sync --verify
python -m unittest discover -s tests -v
预期同步/严格检查成功且治理测试全部通过。产品验证另见开发与验证页面，治理测试不代表学习业务已实现。当前 MCP 指向另一 Gitea 站点，本轮回退目标站点 API，原因与证据边界见初始化记录。凭据只使用安全配置或环境变量，不写入仓库。