47 lines
4.0 KiB
Markdown
47 lines
4.0 KiB
Markdown
<!-- gitea-wiki-mirror:start -->
|
||
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
|
||
wiki_page: Home
|
||
wiki_url: https://git.ilapage.cn/OPC/lexgo/wiki/Home
|
||
wiki_revision: 12dedab75c6f6cc4ca07af118afe97f653c435b2
|
||
synchronized_at: 2026-09-10T08:09:12Z
|
||
<!-- gitea-wiki-mirror:end -->
|
||
|
||
# LexGo 文档入口
|
||
|
||
## 第一次阅读
|
||
|
||
1. [项目档案](https://git.ilapage.cn/OPC/lexgo/wiki/Project-Profile.-)：已确认使用轻量模式、MySQL 8 和本地 go-admin 管理端；学习端采用 Vue 3 + TypeScript + Vite 独立工程；其余技术候选与范围状态。
|
||
2. [需求总览](https://git.ilapage.cn/OPC/lexgo/wiki/Product-Requirements-Overview.-)、[工作量估算](https://git.ilapage.cn/OPC/lexgo/wiki/Workload-Estimate.-)：首版闭环与后续范围。
|
||
3. [架构与代码地图](https://git.ilapage.cn/OPC/lexgo/wiki/Architecture-and-Code-Map.-)、[业务规则](https://git.ilapage.cn/OPC/lexgo/wiki/Business-Rules-and-Glossary.-)。
|
||
4. [开发工作流](https://git.ilapage.cn/OPC/lexgo/wiki/Development-Workflow.-)、[本地开发与验证](https://git.ilapage.cn/OPC/lexgo/wiki/Local-Development-and-Verification.-)。
|
||
|
||
## 五分钟开始
|
||
|
||
项目目前只有需求与设计资料、治理工具，没有产品代码。当前先审核 Quant-UX 原型，再拆 MVP 实施工单并安排技术验证。数据库已确定 MySQL 8，管理端已确定采用指定本地 go-admin/go-admin-ui；不把候选技术建议当作已实现能力。
|
||
|
||
命令从仓库根目录执行：`python dev_scripts/harness.py sync --verify` 同步线上页面并校验结构，预期退出码 0；`python -m unittest discover -s tests -v` 验证治理工具，预期全部通过。产品启动命令尚不存在。
|
||
|
||
## 简单修改从哪里开始
|
||
|
||
先看[常见修改](https://git.ilapage.cn/OPC/lexgo/wiki/Common-Changes.-)和[故障排查](https://git.ilapage.cn/OPC/lexgo/wiki/Troubleshooting)。轻量局部改动做最小验证；新功能和数据/权限变化建单。长期规则先改 Wiki，再导出镜像。
|
||
|
||
## 事实来源
|
||
|
||
Wiki 保存长期规则，工单保存单次实施与验收，Git 保存源码和镜像。当前产品实现为零，已有调研不等于运行验收。数据库选择以用户确认的 MySQL 8 为准，历史 PostgreSQL 建议不再适用。
|
||
|
||
原有四份调研资料作为证据页面保留：[需求提取](https://git.ilapage.cn/OPC/lexgo/wiki/LinguaCafe-Requirements.-)、[Go 分析](https://git.ilapage.cn/OPC/lexgo/wiki/Go-Architecture-Analysis.-)、[另一份需求提取](https://git.ilapage.cn/OPC/lexgo/wiki/LinguaCafe-Requirements-Alternative.-)、[另一份 Go 分析](https://git.ilapage.cn/OPC/lexgo/wiki/Go-Analysis-Alternative.-)。其正文为既有调研记录，不将整份建议视为已批准方案。
|
||
|
||
[初始化记录与流程](https://git.ilapage.cn/OPC/lexgo/wiki/New-Project-Documentation-Setup.-)、[接入指南](https://git.ilapage.cn/OPC/lexgo/wiki/Existing-Project-Adoption-Guide.-)、[交付文档指南](https://git.ilapage.cn/OPC/lexgo/wiki/Delivery-Documentation-Guide.-)。不默认创建任务快照。
|
||
|
||
## 当前 MVP 讨论入口
|
||
|
||
已确认定位：支持多账号、数据独立的自托管学习工具，先邀请少量用户使用。[需求总览](https://git.ilapage.cn/OPC/lexgo/wiki/Product-Requirements-Overview.-)已记录 F01～F12 纳入 MVP，X01～X14 暂不纳入；其他研究功能未获批准。
|
||
|
||
## 当前设计阶段
|
||
|
||
F01～F12 已获用户确认，X 系列暂不纳入。当前制作 Quant-UX 桌面与手机原型；先审核学习闭环与异常状态，再拆实施工单。默认学习语言为英语，原型文章为虚构样例。
|
||
|
||
原型制作进度与证据见[原型工单 #1](https://git.ilapage.cn/OPC/lexgo/issues/1)。
|
||
|
||
Quant-UX 原型 v1 已建立，等待用户审核。[桌面预览](https://qux.ilapage.cn/#/simulate.html?h=a2aa10as5WpKpxe9fjDXETLqmigWeGWqsSjGmNmERlfgTpjXambHTDwagN8C&s=true&log=false)、[手机预览](https://qux.ilapage.cn/#/simulate.html?h=a2aa10aFDLzpVy0xPE70ftx5adTPyjWy5bj6nhPk2kDkJEwtIf1GiZjqx1n6&s=true&log=false)。产品实现尚未开始。
|