OPC/lexgo

Files

T

ila ffa81901cf docs: import verified LexGo Wiki baseline

Online sync and strict structure checks pass. Full governance tests identify two documentation gaps; follow-up will add lightweight exemptions and verified Windows shell guidance.

2026-09-10 14:28:41 +08:00

2.5 KiB

Raw Blame History

generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Architecture-and-Code-Map wiki_url: https://git.ilapage.cn/OPC/lexgo/wiki/Architecture-and-Code-Map.- wiki_revision: 2f5461e714febafd5a25b6e43f7cad635deaac05 synchronized_at: 2026-09-10T06:27:41Z

架构与代码地图

项目定位

Go 承担业务与后台任务，浏览器提供阅读学习界面，NLP 保留独立边界是现有分析的建议。用户区与管理区共享身份服务，但功能权限与个人数据所有权分别校验。

代码地图

现有位置	内容	能证明什么
`docs/01-LinguaCafe需求提取.md`、`docs/linguacafe-requirements.md`	两份需求研究	参考需求与上游证据索引
`docs/02-Go复刻与框架选型分析.md`、`docs/linguacafe-go-analysis.md`	两份设计建议	候选方案，含未解决差异
`docs/` 核心页面	Gitea Wiki 的单向镜像	仅文档与治理准备，不是产品实现
`dev_scripts/harness.py`、`dev_scripts/wiki_docs.py`	原样复制的 DevHarness 工具	治理工具入口，无业务 API
`tests/`	上游治理工具与文档结构测试	不验证阅读、NLP 或 SRS

不存在产品入口、数据库迁移或前端页面。拟定职责：identity（身份）、library（书库）、ingestion（导入）、lexicon（全局词典）、vocabulary（个人词语）、review（复习）、progress（统计）、administration（管理）。底座固定后再决定具体目录。

两条主要执行路径

目标路径一：上传文本 → 创建有所有者的导入任务 → 提取/分词/索引 → 章节就绪 → 阅读器按 token 展示原文和用户词语状态。

目标路径二：阅读保存词语或短语 → 写入个人学习状态与例句 → 查询到期词条 → 服务端计算作答后的状态 → 写入幂等事件 → 更新统计。

不可破坏的边界

词典资源与个人释义分离，共享缓存不能混入个人记录。
Go/Python/JavaScript 的偏移契约必须统一；原文与内容版本必须保留。
API 与 Worker 复用业务规则；NLP 通过明确契约调用，不泄露模型内部对象到前端。
任务至少可重试而不重复产出；学习事件不重复计数。
共享 API/NLP/状态契约在批准后的主题 Wiki 中建立唯一来源，字段和版本尚未定案；不能以本页概要直接生成冻结接口。

2.5 KiB Raw Blame History