generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Home wiki_url: https://git.ilapage.cn/OPC/lexgo/wiki/Home wiki_revision: 5ff3348f14ba1ffa810be3996b9340526a689529 synchronized_at: 2026-09-10T09:38:08Z
LexGo 文档入口
第一次阅读
- 项目档案：已确认使用轻量模式、MySQL 8 和本地 go-admin 管理端；学习端采用 Vue 3 + TypeScript + Vite 独立工程；其余技术候选与范围状态。
- 需求总览、工作量估算：首版闭环与后续范围。
- 架构与代码地图、业务规则。
- 开发工作流、本地开发与验证。
五分钟开始
项目已有账号与独立空间工程基础代码，尚未实现阅读学习业务。当前原型已通过用户验收，已拆 MVP 实施工单并安排技术验证。数据库已确定 MySQL 8，管理端已确定采用指定本地 go-admin/go-admin-ui；不把候选技术建议当作已实现能力。
命令从仓库根目录执行：python dev_scripts/harness.py sync --verify 同步线上页面并校验结构，预期退出码 0；python -m unittest discover -s tests -v 验证治理工具，预期全部通过。产品启动命令尚不存在。
简单修改从哪里开始
先看常见修改和故障排查。轻量局部改动做最小验证；新功能和数据/权限变化建单。长期规则先改 Wiki，再导出镜像。
事实来源
Wiki 保存长期规则，工单保存单次实施与验收，Git 保存源码和镜像。当前工程基础已实现待验收，已有调研不等于运行验收。数据库选择以用户确认的 MySQL 8 为准，历史 PostgreSQL 建议不再适用。
原有四份调研资料作为证据页面保留：需求提取、Go 分析、另一份需求提取、另一份 Go 分析。其正文为既有调研记录，不将整份建议视为已批准方案。
初始化记录与流程、接入指南、交付文档指南。不默认创建任务快照。
当前 MVP 讨论入口
已确认定位：支持多账号、数据独立的自托管学习工具，先邀请少量用户使用。需求总览已记录 F01～F12 纳入 MVP，X01～X14 暂不纳入；其他研究功能未获批准。
当前设计阶段
F01～F12 已获用户确认，X 系列暂不纳入。Quant-UX 桌面与手机原型 v1 已通过用户验收；进入四阶段实施准备。默认学习语言为英语，原型文章为虚构样例。
原型制作进度与证据见原型工单 #1。
Quant-UX 原型 v1 已通过用户验收。桌面预览、手机预览。工程基础 #2 已实现并完成本地验证，等待用户验收：两端用户名登录、管理员创建/启停/重置学习账号、可撤销会话和本人英语空空间。阅读、导入、词典和复习尚未实现。代码在 feat/2-account-foundation 分支。
当前实施入口
四阶段实施总览 #16。14 张单元工单，预计 52～84 人日；实际产品实现未开始。学习端与管理端均使用账号（用户名）＋密码登录，不要求邮箱。详见需求总览和工作量表。