blp/railwaysystem
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

文档维护：纠偏现行真理中心构建源与已闭环事实

Browse Source 
1. 明确 build_ui/ 为前端唯一构建与部署真源，RuoYi-Vue/ruoyi-ui 标记为历史归档备份；
2. 标记 ACCOM-PERM-01 为 RESOLVED_2026-09-23 已彻底闭环，内部 P0 阻断项清零；
3. 对全量 104 项内部 API 端点完成源码级表追踪 (VERIFIED_FROM_SOURCE) 与 build_ui 视图引用验证；
4. 外部 Client API 矩阵全面引入最后验证时间、验证方式、证据源与实时响应四项证据字段；
5. 更新下一阶段标准化行动路线图为严格 16 步标准流。
This commit is contained in:
wangzhibiao committed 2026-09-24 00:03:47 +08:00
1 parent 8ad0f5172e
commit 122a242dd0
9 files changed
+292 -233
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

docs/current/00-START-HERE.md
+12 -8
View File
@@ -22,6 +22,10 @@ docs/reports/** MUST NOT be treated as current truth.
1. **真理优先级铁律**：如首屏声明，`docs/current/**` 拥有最高文档解释权，任何 `docs/reports/**` 下的历史报告仅作为时间序列凭证，**绝对不得覆盖本目录所载明的当前事实**。
2. **唯一入口导航**：人类读者与 Agent 接手任务时，必须以本文件为第一入口，禁止直接引用散落在历史报告中的过期结论。
3. **实事求是原则**：所有现状描述直接锚定底层 Git HEAD 代码与 Kingbase 物理迁移，严禁虚报、浮夸或把未实现能力写为已完成。
4. **代码真源权威原则**：
- **前端唯一构建与部署真源**：`build_ui/`（`RuoYi-Vue/ruoyi-ui` 仅为历史非活跃归档备份，非构建源、非部署源）；
- **后端源码真源**：`RuoYi-Vue/`（Spring Boot 2.5.15 / Java 8）；
- **数据库 DDL 权威**：`RuoYi-Vue/sql/train/v2/` 与 `RuoYi-Vue/sql/system/kingbase/` 迁移脚本链。
---
@@ -33,7 +37,7 @@ docs/reports/** MUST NOT be treated as current truth.
- **共享试用部署分支**：`feat/cicd-pipeline`
- **共享试用访问地址**：[http://192.168.139.230:8082/](http://192.168.139.230:8082/)
- **数据库系统**：国产人大金仓 KingbaseES V9 (schema: `public`, 共享试用库: `training`)
- **当前试用就绪度**：`READY_WITH_EXTERNAL_BLOCKERS`（核心教务主闭环打通，具备现场局域网试用条件；外部智能门锁硬件因无资源处于客观阻塞）
- **当前试用就绪度**：`READY_WITH_EXTERNAL_BLOCKERS`（核心教务主闭环打通，内部 P0 阻断清零；外部智能门锁硬件因无资源处于客观阻塞）
---
@@ -43,14 +47,14 @@ docs/reports/** MUST NOT be treated as current truth.
| 编号 | 文档名称 | 核心职责与回答的关键问题 | 适用对象 |
| :---: | :--- | :--- | :--- |
| **01** | [**01-CURRENT-SYSTEM-STATE.md**](01-CURRENT-SYSTEM-STATE.md) | **系统当前真实状态速览**<br>Git基线、前后端源码、部署状态、阻断项、活跃Worktree、Demo状态与文档状态。 | 全体成员、新接手人员、Agent |
| **01** | [**01-CURRENT-SYSTEM-STATE.md**](01-CURRENT-SYSTEM-STATE.md) | **系统当前真实状态速览**<br>Git基线、前端源码真源 (build_ui/)、后端源码、部署状态、阻断项（ACCOM-PERM-01已解决）、活跃Worktree、Demo状态与文档状态。 | 全体成员、新接手人员、Agent |
| **02** | [**02-FUNCTION-MODULES.md**](02-FUNCTION-MODULES.md) | **业务功能模块全量判定**<br>按教师、学员、课程、场地、计划、排课、考勤、住宿、成绩、统计、DMS等逐项给出五级状态判定。 | 产品经理、业务主管、交付验收 |
| **03** | [**03-DATABASE-AND-TABLES.md**](03-DATABASE-AND-TABLES.md) | **数据库架构、迁移链与数据表总账**<br>KingbaseES DDL、21张业务表、系统表、迁移链顺序与CLEAN_DEMO_DATABASE重建说明。 | 后端开发、DBA、数据审计人员 |
| **04** | [**04-API-INVENTORY.md**](04-API-INVENTORY.md) | **全量 API 接口总账**<br>全量后端 Controller 接口路径、HTTP 方法、源分类、关联物理表与 UI 调用关系。 | 前后端研发、接口自动化测试 |
| **05** | [**05-CLIENT-API-STATUS.md**](05-CLIENT-API-STATUS.md) | **甲方与外部接口状态清单**<br>仅记录 DMS 及电子班牌等外部接口的实时连通、鉴权与 Mock 状态，严禁 Mock 冒充真实。 | 集成工程师、外部联调人员 |
| **04** | [**04-API-INVENTORY.md**](04-API-INVENTORY.md) | **全量 API 接口总账**<br>全量后端 Controller 接口路径、HTTP 方法、源码级校验表关联、build_ui 实际调用关系与实现状态。 | 前后端研发、接口自动化测试 |
| **05** | [**05-CLIENT-API-STATUS.md**](05-CLIENT-API-STATUS.md) | **甲方与外部接口状态清单**<br>记录 DMS 及电子班牌等外部接口的实时连通、鉴权、真实联调凭据与 Mock 状态，严禁 Mock 冒充真实。 | 集成工程师、外部联调人员 |
| **06** | [**06-DEMO-BASELINE.md**](06-DEMO-BASELINE.md) | **演示基线准则与重构要求**<br>明确旧 Demo 不可信与新 Demo 尚未开始的事实，确立纯净数据库与确定性数据等 7 大原则。 | QA、测试架构师、验收人员 |
| **07** | [**07-KNOWN-GAPS.md**](07-KNOWN-GAPS.md) | **内部已知缺口与外部阻塞清单**<br>仅记录经过严格验证的真实缺口（包括 ACCOM-PERM-01 阻断项、DMS 硬件阻塞、C03成绩收敛等）。 | 研发团队、排期人员、问题排查 |
| **08** | [**08-NEXT-ACTIONS.md**](08-NEXT-ACTIONS.md) | **下一阶段标准化行动路线图**<br>固定从环境冻结、纯净库重建、种子数据灌入到最终 Docs Phase B 的 14 步标准流。 | 项目经理、技术负责人 |
| **07** | [**07-KNOWN-GAPS.md**](07-KNOWN-GAPS.md) | **内部已知缺口与外部阻塞清单**<br>仅记录经过严格验证的真实缺口（ACCOM-PERM-01 已解决闭环，记录 DMS 外部硬件阻塞与 C03 成绩收敛等）。 | 研发团队、排期人员、问题排查 |
| **08** | [**08-NEXT-ACTIONS.md**](08-NEXT-ACTIONS.md) | **下一阶段标准化 16 步行动路线图**<br>固定从环境冻结、纯净库重建、种子数据灌入到最终 Docs Phase B 的 16 步标准流。 | 项目经理、技术负责人 |
---
@@ -61,8 +65,8 @@ docs/reports/** MUST NOT be treated as current truth.
- `01-current-status.md`：**STALE**，基于 2026-09-17 早期快照，已被 `01-CURRENT-SYSTEM-STATE.md` 取代。
- `02-phase1-status.md`：**STALE**，粗粒度判定，已被 `02-FUNCTION-MODULES.md` 精确五级判定取代。
- `03-shared-trial.md`：**STALE**，描述 2026-09-17 部署快照，安全移入归档。
- `04-known-gaps.md`：**STALE / NEEDS_REWRITE**，遗漏了最新的 `ACCOM-PERM-01` 阻塞项，已被 `07-KNOWN-GAPS.md` 取代。
- `05-next-actions.md`：**STALE**，编写于 2026-09-18，待办已过期，已被 `08-NEXT-ACTIONS.md` 的 14 步路线图取代。
- `04-known-gaps.md`：**STALE / NEEDS_REWRITE**，已被 `07-KNOWN-GAPS.md` 取代。
- `05-next-actions.md`：**STALE**，编写于 2026-09-18，待办已过期，已被 `08-NEXT-ACTIONS.md` 的 16 步路线图取代。
- `06-shared-trial-accounts.md`：**STALE**，早期演示账号清单，安全移入归档。
- `07-analytics-attendance-semantics.md`：**CURRENT (SPECIALIZED)**，Package C 考勤专题统计语义，属专项技术规范，为保持顶层 9 篇架构精简，归入归档留存备查。