OPC/lexgo
2
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Releases Wiki Activity
149 Commits 21 Branches 0 Tags
728f7d6c1e20352be07c32ecaaefd7758fb4ba48
Commit Graph
8 Commits
Author SHA1 Message Date
ila ab23ff60e5 feat: 书籍封面与音频附件、播放器与播放位置 (#21) 
- 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（备份范围含附件与体积提示）
 2026-09-15 18:39:56 +08:00
ila e069894c4e feat: 补齐桌面与手机体验、显示偏好与键盘操作 (#14) 
- 主题（浅色/深色/跟随系统）与正文字号（标准/大/特大）按账号存在本机，
  账号切换不串、退出回默认；深色走 html[data-theme] 与 Element Plus 的 html.dark
- style.css 收敛为语义调色板：:root 的 53 个变量是文件内仅有的颜色字面量，
  其余规则全部走 var()，暗色只覆盖变量
- 字号经 --reader-font-scale 只作用于阅读面，不做全局缩放
- 阅读位置按账号＋章节保存滚动比例与该章 content_sha256，正文换版本后不恢复
- 复习页键盘：空格/Enter 显示答案、1/2/3 评分；输入控件与聚焦按钮的按键不被劫持
- 站点头部新增「显示」控件，七个学习页面共用
- Playwright 新增 390×844 hasTouch 的 mobile 项目与移动用例（无溢出、可返回、
  触摸滑动不误开面板、深色与字号持久化、账号隔离）；新增主题变量回归用例
- Wiki 记录 Architecture、Business-Rules、Local-Development 与需求更新
 2026-09-15 15:11:30 +08:00
ila a9952b3516 feat: 完成章节并查看个人基础进度 (#13) 
- schema v7 新增 lexgo_chapter_progress（chapter_id 主键、read_sha256 内容版本门控、
  外键级联到章节/书籍/账号），仍然只用可重放的 CREATE TABLE IF NOT EXISTS
- POST /api/v1/chapters/:id/complete：只记已读、不改词语状态；只有 ready 章节可标记；
  重复调用返回同一行并带 duplicate，不移动已读时间也不重复计数；正文新版本后该章
  回到未读但保留记录，重新标记更新同一行
- GET /api/v1/progress：已读/可阅读章节、已知/学习中/新词/忽略、已保存词条、待复习
  与每本书的已读进度；到期数量与复习队列共用 dueTermsQuery 与同一时钟
- ChapterSummary 增加 readAt，书籍列表、阅读器与编辑响应都会解析
- 学习端新增 /progress 页面与导航、stores/progress.ts，阅读器新增显式「标记本章已读」
  区块，书籍页显示已读标记
- Wiki 记录 Architecture、Business-Rules、Local-Development 与需求更新
 2026-09-15 12:31:53 +08:00
ila 3ebec5b11b feat: 词汇库搜索、筛选与编辑 (#12) 
- GET /api/v1/terms 列表：查询键白名单、page/limit 边界（默认 20、上限 100）、
  排序 updated_at DESC；搜索同时匹配身份键、显示原文与个人释义，转小写后比较（term 为
  二进制排序规则），%/_/\ 按字面值转义；status 与 kind 可组合
- PATCH /api/v1/terms/:id 编辑：复用释义/例句与状态/等级校验，身份不可编辑；
  只有状态或等级变化才重排复习时间，历史作答记录与计数保留
- 学习端新增 /vocab 路由与导航、stores/vocabulary.ts、VocabView.vue（搜索、筛选、
  分页、空态与无结果清除、编辑对话框含 1～7 等级选择器、筛选与页码写入 URL）
- 释义/例句/状态/等级抽成 TermFormFields.vue，与阅读器面板共用，避免规则漂移
- Wiki 记录 Architecture、Business-Rules、Local-Development 与需求更新
 2026-09-14 23:46:42 +08:00
ila 35ed692c4b feat: 编辑和删除本人书籍与章节 (#10) 
- PATCH /books/:id 改名、GET /chapters/:id/source 读取编辑用原文（任意状态）、
  PATCH /chapters/:id 改标题与正文、DELETE /books/:id 与 DELETE /chapters/:id
- 版本门控：任务只在 job.content_sha256 与章节版本一致时才能影响章节；过期版本任务
  被标为 superseded 且完全不触碰章节，认领与恢复扫描跳过并作废它们，重试旧版本任务 409
- 只有正文变化才重新处理：重复保存或改回原内容不新建任务；只改标题不改状态
- 删除在事务内硬删除并沿用外键级联，章节删除后重排序号；个人词条、复习排期与作答记录保留
- 处理中删除章节后，在途任务不再发布也不报错；并发删除同一章由书籍行锁序列化
- 学习端：书名与章节编辑对话框、删除确认弹窗、章节行编辑入口、书库删除提示
- Wiki 记录 Architecture、Business-Rules、Local-Development 与需求更新
 2026-09-13 23:20:52 +08:00
ila 0328505b77 feat: 完成到期单词复习与幂等答题 (#8) 
- schema v6 新增 lexgo_term_reviews 与 lexgo_review_answers：语句都是可重试的加法迁移，
  既有已保存词汇按 created_at 立即进入队列；旧二进制回到 v5 仍可写入个人词条
- 固定间隔表 1/2/4/7/15/30/60 天：答对升级封顶 7、答错降级最低 1、再学一次不改等级，
  答错与再学立即回到本轮；已知与忽略不入队
- GET /api/v1/reviews/queue 与 POST /api/v1/reviews/:termId/answers：按 answerId 去重、
  按 expectedDueAt 判定过期标签页，重复提交与并发都不重复更新次数和间隔
- 学习端新增 /review 路由与到期复习入口，正面挖空例句、答案面评分、完成页与空队列页
- 同步 Architecture-and-Code-Map、Business-Rules-and-Glossary、
  Local-Development-and-Verification、Product-Requirements-Overview 与 Home
 2026-09-11 20:54:17 +08:00
ila a55708cd37 feat: 粘贴英语文本、章节处理与本人阅读 (#5) 
schema v3 新增 lexgo_books、lexgo_chapters、lexgo_ingest_jobs；一次粘贴生成一个章节，
原文按收到的字符串逐字保存；处理任务具备持久状态机、启动恢复与 requestId 幂等。
新增书籍/章节/任务 API 一律按认证身份过滤归属，他人编号返回 404，后台任务不使用
客户端用户编号；学习端补齐粘贴导入、书库、章节状态与失败重试、原文阅读与章节切换。

测试：MySQL 集成测试覆盖导入→处理中→就绪→阅读完整路径、失败重试、幂等、越权与
Unicode 原文保真；学习端 Vitest 31 项、Playwright 3 项与构建通过；lexgo_dev 已显式
迁移到 v3，迁移前后既有数据指纹不变。

文档：Wiki 先写后回读（架构、业务规则、本地验证、需求总览、Home），导出核心镜像。
 2026-09-11 00:36:23 +08:00
ila 2c8e9b3ca0 feat: 接入两端用户名登录和独立学习空间 (#2) 2026-09-10 17:39:57 +08:00