OPC/lexgo
2
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 接入两端用户名登录和独立学习空间 (#2)

Browse Source
This commit is contained in:
ila
2026-09-10 17:39:57 +08:00
parent 596543b0e2
commit 2c8e9b3ca0
82 changed files with 14148 additions and 30 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/00-project-profile.md
+17 -6
View File
@@ -2,8 +2,8 @@
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
wiki_page: Project-Profile
wiki_url: https://git.ilapage.cn/OPC/lexgo/wiki/Project-Profile.-
wiki_revision: 5b119f72802ffb7a58222e04a2b887925e50ce2e
synchronized_at: 2026-09-10T09:11:19Z
wiki_revision: 80cd91be7e64552b0205f45c59a2234934760b0e
synchronized_at: 2026-09-10T09:38:10Z
<!-- gitea-wiki-mirror:end -->
# LexGo 项目档案
@@ -29,7 +29,7 @@ LinguaCafe 参考基线由现有调研记录为 `c1ea298ce40c65b9dd33e9b26fd2e52
## 子项目与交付单元
当前独立交付物只有文档和治理工具。目标按一个产品版本、一个仓库规划：基于 go-admin 扩展的共享 Go API/Worker、独立学习前端和独立管理前端；内部 NLP 服务暂为建议。学习端与管理端分开构建，共用后端与账号体系。暂不创建不存在的产品目录或子项目规则。
当前独立交付物包括文档、治理工具、账号后端和两个前端。目标按一个产品版本、一个仓库规划：基于 go-admin 扩展的共享 Go API/Worker、独立学习前端和独立管理前端；内部 NLP 服务暂为建议。学习端与管理端分开构建，共用后端与账号体系。当前目录为 server、admin、learner 和 scripts，实际入口见代码地图。
## 技术栈与运行环境
@@ -80,7 +80,7 @@ LinguaCafe 参考基线由现有调研记录为 `c1ea298ce40c65b9dd33e9b26fd2e52
M0 在 LexGo 隔离工程中验证：指定前后端配套构建；MySQL 8 迁移与启动；登录、菜单和 API 权限；普通学习者的数据所有权隔离；用户区与管理区的身份衔接。管理 UI 的 dev/build 脚本使用类 Unix 的内联环境变量写法，Windows 执行方式需验证并最小适配，不假定 PowerShell 下直接成功。
复用范围为通用管理界面及其配套 API/身份能力；阅读器、词汇、短语与复习仍需实现 LexGo 领域逻辑。学习端另建 Vue 3 + TypeScript + Vite 工程，管理端继续使用其现有 Vue CLI/Vuex 结构；不要求两端统一构建工具和状态库。实际引入前核对代码和资源许可、排除本地配置及数据库等运行文件；按固定提交建立上游差异记录，后续升级先验证再更新基线。当前只完成选型记录，未宣称管理端已接入 LexGo。
复用范围为通用管理界面及其配套 API/身份能力；阅读器、词汇、短语与复习仍需实现 LexGo 领域逻辑。学习端另建 Vue 3 + TypeScript + Vite 工程，管理端继续使用其现有 Vue CLI/Vuex 结构；不要求两端统一构建工具和状态库。实际引入前核对代码和资源许可、排除本地配置及数据库等运行文件；按固定提交建立上游差异记录，后续升级先验证再更新基线。管理端已按选用模块接入 LexGo，范围与差异见本页末尾。
## 学习端技术方案（2026-09-10）
@@ -106,7 +106,7 @@ M0 在 LexGo 隔离工程中验证：指定前后端配套构建；MySQL 8 迁
## MVP 功能范围确认
2026-09-10 用户确认 F01～F12 全部进入首版，X01～X14 暂不纳入；随后授权使用 Quant-UX 制作原型，并同意先建原型工单，原型审核后再拆实施工单。桌面和手机均覆盖；默认学习语言已确认英语。产品代码未开始，具体交互通过原型审核固定。
2026-09-10 用户确认 F01～F12 全部进入首版，X01～X14 暂不纳入；随后授权使用 Quant-UX 制作原型，并同意先建原型工单，原型审核后再拆实施工单。桌面和手机均覆盖；默认学习语言已确认英语。工程基础已实现待验收，其余范围沿用已验收原型。
原型站点为 https://qux.ilapage.cn/；v1 编辑源和预览统一见需求总览及工单 #1。用户要求减少页面说明、按目标页面呈现。账号配置不进入仓库。
@@ -119,4 +119,15 @@ M0 在 LexGo 隔离工程中验证：指定前后端配套构建；MySQL 8 迁
学习端与管理端均使用账号（用户名）＋密码登录，账号不要求邮箱格式；邮箱不作为必填登录标识。两端共用账号体系，管理权限由服务端单独校验。用户名唯一性和大小写规则在账号工单中细化。
[四阶段实施总览 #16](https://git.ilapage.cn/OPC/lexgo/issues/16) 已建立四阶段、14 张单元工单；详见需求总览与工作量估算。产品实现尚未开始。
[四阶段实施总览 #16](https://git.ilapage.cn/OPC/lexgo/issues/16) 已建立四阶段、14 张单元工单；详见需求总览与工作量估算。工程基础 #2 已实现并完成本地验证，等待用户验收：两端用户名登录、管理员创建/启停/重置学习账号、可撤销会话和本人英语空空间。阅读、导入、词典和复习尚未实现。代码在 feat/2-account-foundation 分支。
## 工程基础实际基线（#2，2026-09-10）
MySQL 服务端实际为 8.4.3，连接本机 127.0.0.1:3308；项目专用库 lexgo_dev、lexgo_test_issue2。连接凭据只存本机忽略的 .env.local；文档和 Git 不保存密码。已有非项目数据库未连接读写业务数据、未迁移。
Go 1.26.5 通过 Go 独立工具链下载并校验，系统 Go 1.24.0 保持不变；脚本只为子进程设置 GOTOOLCHAIN/GOSUMDB。Node 22.22.1，两个前端锁定 pnpm 9.15.1。管理端保留 Vue CLI/Vuex，学习端由官方 create-vue 3.23.0 生成，保留 Vue/TypeScript/Vite/Router/Pinia/Element Plus，实际包版本以各自 pnpm-lock.yaml 为准，不要求两端依赖版本一致。
server 是 go-admin 的选用模块接入：原样保留 SysUser、SysDept、必要 common/models 和 MIT 许可，新增 LexGo 路由、账号服务、会话与显式迁移；未接入整套后台路由、代码生成或任意任务执行。server/upstream.json 记录来源和文件摘要。admin/upstream.json 区分原样复用与适配的 go-admin-ui 布局、组件、页面和依赖，原始三个 go-admin 源工作区保持只读。
当前采用随机 Bearer 会话而非直接启用上游开发模式的超长 JWT。已验证退出、禁用、密码重置和到期拒绝；该差异是为满足当前可撤销会话要求，不宣称上游默认实现满足此要求。
docs/02-architecture-and-code-map.md
+38 -3
View File
@@ -2,8 +2,8 @@
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: 1c6333435f539af5253b18c563bce56bc336afc8
synchronized_at: 2026-09-10T09:11:22Z
wiki_revision: 51d40a6d4f7d0bcc0882bcd7d9c544aae964afa8
synchronized_at: 2026-09-10T09:38:13Z
<!-- gitea-wiki-mirror:end -->
# 架构与代码地图
@@ -43,7 +43,7 @@ Go 承担业务与后台任务，浏览器提供阅读学习界面，NLP 保留
管理端采用用户指定的 `D:/github_project/goadmin`，前后端固定 commit 见项目档案。后端现有入口为源仓库 main.go，业务分布于 app/cmd/common；管理前端入口为 go-admin-ui/src/main.js，页面位于 src/views，路由/API 封装位于 src/router、src/api。这些是外部参考仓库路径，尚未复制或运行于 LexGo。
M0 验证配套后再确定 LexGo 内部目录和身份衔接契约；通用管理能力可复用，用户与语言的数据所有权检查由业务层实现。既有分析中 gin-vue-admin 的推荐已被本次用户决策替代。
当前 #2 已固定首批 LexGo 目录和身份衔接契约；通用管理能力可复用，用户与语言的数据所有权检查由业务层实现。既有分析中 gin-vue-admin 的推荐已被本次用户决策替代。
## 学习端与管理端的目标架构
@@ -87,3 +87,38 @@ flowchart TD
源码检查发现 common/actions/permission.go 允许关闭 EnableDP，且 DataScope 默认分支不添加过滤；该机制用于管理数据范围，不能单独保证私人学习数据隔离。学习接口必须强制按认证用户归属查询，不允许客户端指定用户替代认证身份。
仅当管理流程引入多步安装、处理中/失败重试等明显交互不确定性时，补关键状态原型。通常的列表、编辑、删除确认沿用 go-admin 表格、表单和弹窗，记录字段、权限、异常和验收即可。
## 已实现工程入口（#2）
| 路径 | 职责 |
|---|---|
| server/cmd/lexgo/main.go | 配置连接、migrate/bootstrap/serve 命令；默认只监听 127.0.0.1:8000 |
| server/app/admin/models、server/common/models | 按 upstream.json 原样选用的 go-admin 模型和约定 |
| server/app/lexgo/database.go | MySQL 8 显式版本迁移、所有权标记、启动检查 |
| server/app/lexgo/service.go | 用户名校验、账号创建、bcrypt、随机会话摘要和撤销 |
| server/app/lexgo/router.go | JSON 请求、角色和归属授权、API 路由和安全错误响应 |
| server/app/lexgo/*_test.go | 真实 MySQL 隔离、撤销、并发创建、迁移拒绝/恢复、bootstrap 验证 |
| admin/src/views、admin/src/session.mjs | 基于 go-admin-ui 的账号页面与管理端会话 |
| learner/src/views、learner/src/stores/session.ts | 独立学习端登录与私人空空间、会话及迟到响应隔离 |
| scripts/server.py | 安全读取本机 .env.local，传入子进程；不输出秘密 |
### 账号 API v1
请求使用 JSON；受保护接口使用 Authorization: Bearer。成功结构 {code:200,data:...}，创建账号 HTTP 201；失败使用实际 HTTP 400/401/403/404/409/429/500 和 {code:状态码,msg:必要提示}。响应 Cache-Control:no-store。
| 方法与路径 | 行为和权限 |
|---|---|
| POST /api/v1/login | username/password，返回 token、expiresAt、user；不要求邮箱 |
| GET /api/v1/me | 当前登录者 id/username/role/disabled |
| POST /api/v1/logout | 撤销当前会话 |
| GET /api/v1/space | 当前用户英语空间；拒绝查询参数指定用户 |
| GET /api/v1/spaces/:id | 仅本人的空间可读，他人编号返回 404 |
| GET /api/v1/accounts | 管理员查看账号列表；只输出必要字段 |
| POST /api/v1/accounts | 管理员创建 learner；拒绝客户端 role 等未知字段 |
| PATCH /api/v1/accounts/:id | 管理员启停或重置 learner 密码；不能修改自己或其他管理员 |
| GET /healthz | 检查数据库连接，仅返回健康状态 |
schema v1：sys_user 保留选用 go-admin 模型字段，唯一小写用户名；lexgo_spaces 以 owner_id 为主键；lexgo_sessions 保存 token_hash/owner_id/expires_at；lexgo_schema 记录版本与产品所有权。服务启动不自动迁移。迁移仅接受空库或合法已有 LexGo marker，拒绝空 marker、其他产品、负版本与未来版本；版本 0 可重试部分迁移，版本 1 幂等。
凭据字段只存在本地环境和必要数据库哈希中。后台账号密码更新使用表/字段更新，避免上游 BeforeUpdate hook 对已有哈希再次加密。账号行再会话行的锁顺序用于串行化撤销与请求；API 在事务提交后才返回成功。
docs/03-business-rules-and-glossary.md
+12 -2
View File
@@ -2,8 +2,8 @@
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
wiki_page: Business-Rules-and-Glossary
wiki_url: https://git.ilapage.cn/OPC/lexgo/wiki/Business-Rules-and-Glossary.-
wiki_revision: 2230cceecec064fdfa4116cb683cc02c16d29dbe
synchronized_at: 2026-09-10T09:11:23Z
wiki_revision: 3f2294d5f038cc6f3c3e707a44f528c697c01b38
synchronized_at: 2026-09-10T09:38:15Z
<!-- gitea-wiki-mirror:end -->
# 业务规则与术语
@@ -48,3 +48,13 @@ M0 固定首发语言语料、词条身份规则、短语选择与重叠规则
学习端与管理端均使用账号（用户名）＋密码登录，账号不要求邮箱格式；邮箱不作为必填登录标识。两端共用账号体系，管理权限由服务端单独校验。用户名唯一性和大小写规则在账号工单中细化。
私人学习记录必须由服务端强制按当前用户归属过滤；管理员角色、部门范围或关闭 go-admin 数据权限开关均不能自动解除学习接口的本人归属约束。共享词典和个人释义分开维护。
## 账号与会话实现规则（#2）
- 账号去首尾空白并转小写，3～32 位、ASCII 字母开头，可含数字、点、下划线和连字符；唯一约束阻止大小写和并发重复。密码 10～72 字节，使用 bcrypt，不填写必需邮箱。
- 初始管理员只通过显式 bootstrap 建立；库中已有账号时拒绝再次 bootstrap，不覆盖密码。管理页面只创建学习者，不能将输入角色升级为管理员；本阶段不提供账号删除。
- 同一账号可以登录多个会话。随机令牌仅在客户端保存，服务端存 SHA-256 摘要，8 小时过期。退出仅撤销当前会话，启停/重置会撤销目标账号全部会话；重新启用不能恢复旧会话。
- 每次请求读取账号当前状态与会话有效期；学习数据由认证身份确定，管理员权限不能解除学习接口的本人过滤。
- 两端分别使用 lexgo-admin-token、lexgo-learner-token 的 sessionStorage；401、退出和账号切换清除私人状态，以代次检查阻止迟到响应恢复旧数据。管理端拒绝学习者并撤销其新会话；撤销服务异常会提示未确认，不冒充服务端退出成功。
- 新建账号拥有英语空空间。此处没有书籍、阅读、词典或复习功能，不把空页面视为学习业务已实现。
docs/04-local-development-and-verification.md
+50 -2
View File
@@ -2,8 +2,8 @@
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
wiki_page: Local-Development-and-Verification
wiki_url: https://git.ilapage.cn/OPC/lexgo/wiki/Local-Development-and-Verification.-
wiki_revision: 71ede783b059584cdfd7e5b8c3076def704407f6
synchronized_at: 2026-09-10T06:50:01Z
wiki_revision: a0c03d3474ef610a4c842298db8c3df2f91054c7
synchronized_at: 2026-09-10T09:38:16Z
<!-- gitea-wiki-mirror:end -->
# 本地开发与验证
@@ -87,3 +87,51 @@ rg -n -g '*.md' 'PowerShell' docs
学习端拟使用 create-vue + Vite，测试组合为 Vitest + Playwright；管理端保持指定 go-admin-ui 的现有工具链。当前未创建学习端工程，因此尚无可执行的产品 npm/pnpm 脚本。本轮技术方案记录不改变该事实。
正式工程建立时记录精确 Node/包管理器/依赖版本、锁文件、构建和测试命令；分别验证两端构建、共享登录/API 授权，以及阅读选择、Unicode 定位和学习闭环。具体测试范围依赖后续 MVP，不提前声称全部业务场景已有覆盖。
## 工程基础运行与验证（#2）
已验证主机为 Windows PowerShell；Node 22.22.1、pnpm 9.15.1、Go 1.26.5、MySQL 8.4.3。默认本地入口：学习端 http://127.0.0.1:5173、管理端 http://127.0.0.1:5174、API http://127.0.0.1:8000。前端 /api 由开发代理转发到后端，不开启宽泛跨域。
1. 在 MySQL 8 中准备独立空库 lexgo_dev 与 lexgo_test_issue2（utf8mb4）；不要把既有业务库用作测试库。
2. 复制根 .env.example 为 .env.local，填写本机 DB 凭据与初始管理员密码；.env.local 已被 Git 忽略。优先读取进程中已有 LEXGO_* 配置，文件仅补缺项。
3. 在仓库根执行以下后端命令。migrate 显式建表，bootstrap 仅首次执行，serve 不修改结构。
```powershell
python scripts/server.py migrate
python scripts/server.py bootstrap
python scripts/server.py serve
```
分别开终端启动两个前端：
```powershell
npx --yes pnpm@9.15.1 --dir admin install --frozen-lockfile
npx --yes pnpm@9.15.1 --dir admin dev
```
```powershell
npx --yes pnpm@9.15.1 --dir learner install --frozen-lockfile
npx --yes pnpm@9.15.1 --dir learner dev
```
验证命令（仓库根执行）：
```powershell
python scripts/server.py test-integration
python scripts/server.py build
npx --yes pnpm@9.15.1 --dir admin test
npx --yes pnpm@9.15.1 --dir admin lint
npx --yes pnpm@9.15.1 --dir admin build
npx --yes pnpm@9.15.1 --dir learner test:unit --run
npx --yes pnpm@9.15.1 --dir learner test:e2e
npx --yes pnpm@9.15.1 --dir learner build
```
test-integration 默认使用 lexgo_test_issue2，可由 LEXGO_TEST_DB_NAME/LEXGO_TEST_DSN 指定其他 lexgo_test_ 前缀专用库；拒绝其他名字。迁移测试创建随机同前缀空库并仅清理自己创建的库，因此测试账号需具备该测试实例中的建库权限。普通 test 命令在没有测试库设置时跳过 MySQL 用例，不能当作集成通过。
学习端 Playwright 用例使用已安装的 Chrome 和虚构 API 响应；真实 MySQL/API 的浏览器联测结果在工单记录，不能混为同一种测试。管理端会话测试使用 Node 内置 runner。新增功能需针对行为写测试，而不是只验证打包。
本次本机初始管理员名为 admin，密码由工具随机生成，保存在忽略的 .env.local 的 LEXGO_BOOTSTRAP_PASSWORD；虚构浏览器学习账号 learner_a/learner_b 的本机测试口令记录在忽略的 .local/browser-accounts.json。这些本机文件不随 Git 交付，其他环境应自行设置。
停止开发服务器使用对应终端 Ctrl+C。回退本单代码可切换前一提交，保留项目库；前一版本只有文档，不存在需要启动的旧产品。删除测试/开发库不是自动回退步骤；生产升级与完整备份恢复由交付工单 #15 另行验证。
docs/06-troubleshooting.md
+13 -2
View File
@@ -2,8 +2,8 @@
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
wiki_page: Troubleshooting
wiki_url: https://git.ilapage.cn/OPC/lexgo/wiki/Troubleshooting
wiki_revision: c202a8adb9b720981761e07f52fb7c0033d6d7d2
synchronized_at: 2026-09-10T06:27:43Z
wiki_revision: 139b4b3c61a26143577a8450a6abf53965737534
synchronized_at: 2026-09-10T09:38:20Z
<!-- gitea-wiki-mirror:end -->
# 故障排查
@@ -22,3 +22,14 @@ synchronized_at: 2026-09-10T06:27:43Z
## 必须停止的情况
目标仓库身份不清时停止远端写入；页面无法回读、无 revision 或同步失败时停止产品编码。数据越权、破坏性操作超出授权时停止相关操作。独立文档整理可以继续。
## 工程基础常见问题（#2）
- Go 工具链提示 GOSUMDB=off：scripts/server.py 仅在子进程启用 sum.golang.org 校验并固定 go1.26.5，不修改全局 go env。原理见 https://go.dev/doc/toolchain 。
- Windows 执行上游类 Unix 环境变量脚本失败：使用本项目 admin/package.json 的跨平台脚本，保留 Vue CLI，不直接调用原始源码目录中的脚本。
- 本地接口受到系统代理影响：访问 loopback；PowerShell 验证可用 Invoke-WebRequest -NoProxy。测试仅对 loopback 追加 NO_PROXY，不关闭其他网络代理。
- 原生前端依赖下载停滞：本次安装指定官方 npm registry 后成功；锁文件已生成，不更改全局 registry。不要通过关闭包完整性检查解决安装问题。
- serve 报需先迁移：核对 LEXGO_DB_NAME，显式执行 migrate；未知产品或版本必须先诊断，不手工植入 marker 绕过保护。
- 登录失效：重新登录；账号停用或重置密码会撤销全部会话。用户名不是邮箱，区分格式错误与凭据失败。
- 管理端构建中的 Sass 旧 API 弃用和 vendor 大小警告来自当前选用工具链，不影响已验证构建；生产体积优化不作为本单完成条件。
docs/09-product-requirements-overview.md
+12 -5
View File
@@ -2,8 +2,8 @@
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
wiki_page: Product-Requirements-Overview
wiki_url: https://git.ilapage.cn/OPC/lexgo/wiki/Product-Requirements-Overview.-
wiki_revision: 838c096a1ea3a1c030e857e5229dfe366ea3acba
synchronized_at: 2026-09-10T09:11:31Z
wiki_revision: e506edcf2487b3d0faf035bf0a6826332bccd994
synchronized_at: 2026-09-10T09:38:24Z
<!-- gitea-wiki-mirror:end -->
# 产品需求总览
@@ -15,7 +15,7 @@ synchronized_at: 2026-09-10T09:11:31Z
## 事实来源边界
当前产品实现：无。用户已确认多账号、数据独立、自托管和 F01～F12；已建立原型工单 #1 及 Quant-UX 桌面/手机设计。下方 U/A/N 与 M0～M4 保留为研究索引，不能扩大已批准 MVP，也不能用原型完成度代替产品实现进度。
当前产品实现：账号与独立空间工程基础已实现待验收，其余学习业务待实施。用户已确认多账号、数据独立、自托管和 F01～F12；已建立原型工单 #1 及 Quant-UX 桌面/手机设计。下方 U/A/N 与 M0～M4 保留为研究索引，不能扩大已批准 MVP，也不能用原型完成度代替产品实现进度。
## 当前需求索引
@@ -156,7 +156,7 @@ Anki（U20）、YouTube/Jellyfin 远程字幕（U07/A08）、全量旧实例迁
| F01～F12 / X01～X14 | 用户已确认 F 全部进入，X 暂不纳入 |
| 默认学习语言 | 用户已确认英语；原型文章为虚构样例 |
| 交互和页面细节 | 当前 v1 已通过用户审核，见工单 #1 验收记录 |
| 产品实现与运行验收 | 未开始 |
| 产品实现与运行验收 | 工程基础 #2 已实现并本地验证，待用户验收；其余学习业务未实现 |
## Quant-UX 原型任务
@@ -193,7 +193,7 @@ Anki（U20）、YouTube/Jellyfin 远程字幕（U07/A08）、全量旧实例迁
学习端与管理端均使用账号（用户名）＋密码登录，账号不要求邮箱格式；邮箱不作为必填登录标识。两端共用账号体系，管理权限由服务端单独校验。用户名唯一性和大小写规则在账号工单中细化。
[四阶段实施总览 #16](https://git.ilapage.cn/OPC/lexgo/issues/16) 汇总四阶段与依赖，各单均包含完整路径、参考模块、设计证据、验收和人日估算。产品实现尚未开始。
[四阶段实施总览 #16](https://git.ilapage.cn/OPC/lexgo/issues/16) 汇总四阶段与依赖，各单均包含完整路径、参考模块、设计证据、验收和人日估算。工程基础 #2 已实现并完成本地验证，等待用户验收：两端用户名登录、管理员创建/启停/重置学习账号、可撤销会话和本人英语空空间。阅读、导入、词典和复习尚未实现。代码在 feat/2-account-foundation 分支。
| 阶段 | 工单 | 覆盖 | 预计人日 |
|---|---|---|---:|
@@ -211,3 +211,10 @@ Anki（U20）、YouTube/Jellyfin 远程字幕（U07/A08）、全量旧实例迁
| 4 | [#13 完成章节并查看个人基础进度](https://git.ilapage.cn/OPC/lexgo/issues/13) | F11 | 2～3 |
| 4 | [#14 补齐桌面与手机学习体验、主题及键盘操作](https://git.ilapage.cn/OPC/lexgo/issues/14) | F12 收尾 | 3～5 |
| 4 | [#15 自托管试用交付：安装、完整恢复与两账号验收](https://git.ilapage.cn/OPC/lexgo/issues/15) | B04、F01–F12 集成验收 | 4～6 |
## 工程基础交付边界（#2）
工程基础 #2 已实现并完成本地验证，等待用户验收：两端用户名登录、管理员创建/启停/重置学习账号、可撤销会话和本人英语空空间。阅读、导入、词典和复习尚未实现。代码在 feat/2-account-foundation 分支。
用户名登录与账号管理覆盖 B01/B02 和 F12 的登录基础；所有 F 学习业务仍需按 #3～#15 验收。#2 的会话和权限测试不能证明尚未存在的书籍/词汇/复习权限已通过。
docs/10-workload-estimate.md
+7 -2
View File
@@ -2,8 +2,8 @@
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
wiki_page: Workload-Estimate
wiki_url: https://git.ilapage.cn/OPC/lexgo/wiki/Workload-Estimate.-
wiki_revision: 012c30f72b07cc9ff583c357409513a5362ca80a
synchronized_at: 2026-09-10T09:11:37Z
wiki_revision: de8fcf81b07bd7e96df1c68e5a63914139c62b6c
synchronized_at: 2026-09-10T09:38:31Z
<!-- gitea-wiki-mirror:end -->
# LexGo MVP 工作量估算
@@ -147,3 +147,8 @@ W00 后续需验证双前端与共享后端的接口/身份衔接、学习端构
用户已确认 F01～F12，X 系列不进入本轮 MVP。当前先进行 Quant-UX 原型工单，审核交互后再细化实施工单及估算。此前 M2/M3 及完整 P0～P2 的总量不应作为该 MVP 的已批准排期；管理端仅覆盖需要新增或调整的基础能力。原型制作与原型验收是不同状态，不把演示完成折算为产品实现完成。
Quant-UX 桌面和手机原型 v1 已建立，待人工审核；这不计为产品实现完成。原型实际投入未计时，不回填虚构工时。实施包和人日区间在原型审核后重新拆解，历史全量估算仅供参考。
## 工程基础进展（#2）
账号与独立空间基础已实现并本地验证，待用户验收。原计划 #2 为 6～9 人日，这不是实际消耗；未记录人工有效工时，不按 AI 会话耗时反推。#2 验收后，原拆分中 #3～#15 的规划工作量合计 46～75 人日，仍需在英语资源/划词验证后重估。本页顶部 52～84 为本轮开始时的完整 MVP 基线，不重复计入新增工作。
docs/README.md
+5 -5
View File
@@ -2,8 +2,8 @@
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
wiki_page: Home
wiki_url: https://git.ilapage.cn/OPC/lexgo/wiki/Home
wiki_revision: f77415b6507f85cabef2e1ea808628129deee2b7
synchronized_at: 2026-09-10T09:11:18Z
wiki_revision: 5ff3348f14ba1ffa810be3996b9340526a689529
synchronized_at: 2026-09-10T09:38:08Z
<!-- gitea-wiki-mirror:end -->
# LexGo 文档入口
@@ -17,7 +17,7 @@ synchronized_at: 2026-09-10T09:11:18Z
## 五分钟开始
项目目前只有需求与设计资料、治理工具，没有产品代码。当前原型已通过用户验收，已拆 MVP 实施工单并安排技术验证。数据库已确定 MySQL 8，管理端已确定采用指定本地 go-admin/go-admin-ui；不把候选技术建议当作已实现能力。
项目已有账号与独立空间工程基础代码，尚未实现阅读学习业务。当前原型已通过用户验收，已拆 MVP 实施工单并安排技术验证。数据库已确定 MySQL 8，管理端已确定采用指定本地 go-admin/go-admin-ui；不把候选技术建议当作已实现能力。
命令从仓库根目录执行：`python dev_scripts/harness.py sync --verify` 同步线上页面并校验结构，预期退出码 0；`python -m unittest discover -s tests -v` 验证治理工具，预期全部通过。产品启动命令尚不存在。
@@ -27,7 +27,7 @@ synchronized_at: 2026-09-10T09:11:18Z
## 事实来源
Wiki 保存长期规则，工单保存单次实施与验收，Git 保存源码和镜像。当前产品实现为零，已有调研不等于运行验收。数据库选择以用户确认的 MySQL 8 为准，历史 PostgreSQL 建议不再适用。
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.-)。其正文为既有调研记录，不将整份建议视为已批准方案。
@@ -43,7 +43,7 @@ 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)。产品实现尚未开始。
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)。工程基础 #2 已实现并完成本地验证，等待用户验收：两端用户名登录、管理员创建/启停/重置学习账号、可撤销会话和本人英语空空间。阅读、导入、词典和复习尚未实现。代码在 feat/2-account-foundation 分支。
## 当前实施入口