wangzhibiao
8ad0f5172e
docs: bootstrap canonical current truth portal (00-START-HERE through 08-NEXT-ACTIONS)
5.6 KiB
5.6 KiB
00 - RailwaySystem 现行系统唯一权威真理入口 (Start Here)
SOURCE OF TRUTH PRIORITY
1. docs/current/**
2. current source code / migrations
3. confirmed client requirements
4. current test evidence
5. historical reports
docs/reports/** MUST NOT be treated as current truth.
1. 核心定位与真理唯一性法则
本目录（docs/current/）是 SYFJGYD学员管理系统（内部工程代号：RailwaySystem）面向所有研发人员、测试工程师、交付团队、管理人员以及 AI 智能体 (Agent) 的唯一权威真理中心。
在过去多轮并行迭代与验证过程中，项目沉淀了大量历史测试、审计与阶段报告（存放于 docs/reports/**）。为防止历史快照篡权和事实失真，确立以下不可动摇的法则：
- 真理优先级铁律：如首屏声明，
docs/current/**拥有最高文档解释权，任何docs/reports/**下的历史报告仅作为时间序列凭证，绝对不得覆盖本目录所载明的当前事实。 - 唯一入口导航：人类读者与 Agent 接手任务时，必须以本文件为第一入口，禁止直接引用散落在历史报告中的过期结论。
- 实事求是原则：所有现状描述直接锚定底层 Git HEAD 代码与 Kingbase 物理迁移，严禁虚报、浮夸或把未实现能力写为已完成。
2. 系统核心标识与运行基线
- 正式业务名称：
SYFJGYD学员管理系统 - 内部工程代号：
RailwaySystem - 当前开发分支：
fix/phase0-product-defects-20260923 - 共享试用部署分支：
feat/cicd-pipeline - 共享试用访问地址：http://192.168.139.230:8082/
- 数据库系统：国产人大金仓 KingbaseES V9 (schema:
public, 共享试用库:training) - 当前试用就绪度：
READY_WITH_EXTERNAL_BLOCKERS（核心教务主闭环打通，具备现场局域网试用条件；外部智能门锁硬件因无资源处于客观阻塞）
3. Current 权威文档中心导航表
本目录现行收录且仅收录以下 8 份相互解耦、权责明确的真理文档：
| 编号 | 文档名称 | 核心职责与回答的关键问题 | 适用对象 |
|---|---|---|---|
| 01 | 01-CURRENT-SYSTEM-STATE.md | 系统当前真实状态速览 Git基线、前后端源码、部署状态、阻断项、活跃Worktree、Demo状态与文档状态。 |
全体成员、新接手人员、Agent |
| 02 | 02-FUNCTION-MODULES.md | 业务功能模块全量判定 按教师、学员、课程、场地、计划、排课、考勤、住宿、成绩、统计、DMS等逐项给出五级状态判定。 |
产品经理、业务主管、交付验收 |
| 03 | 03-DATABASE-AND-TABLES.md | 数据库架构、迁移链与数据表总账 KingbaseES DDL、21张业务表、系统表、迁移链顺序与CLEAN_DEMO_DATABASE重建说明。 |
后端开发、DBA、数据审计人员 |
| 04 | 04-API-INVENTORY.md | 全量 API 接口总账 全量后端 Controller 接口路径、HTTP 方法、源分类、关联物理表与 UI 调用关系。 |
前后端研发、接口自动化测试 |
| 05 | 05-CLIENT-API-STATUS.md | 甲方与外部接口状态清单 仅记录 DMS 及电子班牌等外部接口的实时连通、鉴权与 Mock 状态，严禁 Mock 冒充真实。 |
集成工程师、外部联调人员 |
| 06 | 06-DEMO-BASELINE.md | 演示基线准则与重构要求 明确旧 Demo 不可信与新 Demo 尚未开始的事实，确立纯净数据库与确定性数据等 7 大原则。 |
QA、测试架构师、验收人员 |
| 07 | 07-KNOWN-GAPS.md | 内部已知缺口与外部阻塞清单 仅记录经过严格验证的真实缺口（包括 ACCOM-PERM-01 阻断项、DMS 硬件阻塞、C03成绩收敛等）。 |
研发团队、排期人员、问题排查 |
| 08 | 08-NEXT-ACTIONS.md | 下一阶段标准化行动路线图 固定从环境冻结、纯净库重建、种子数据灌入到最终 Docs Phase B 的 14 步标准流。 |
项目经理、技术负责人 |
4. 历史版本审计与归档记录
在本次 Bootstrap 启动前，原 docs/current/ 目录下共存有 8 份历史文件。经逐篇与底层代码及 Git HEAD 审计，判定结论如下：
README.md：STALE，原速览索引缺少真理优先级声明与新架构映射，已被本文件彻底重构替代。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 步路线图取代。06-shared-trial-accounts.md：STALE，早期演示账号清单，安全移入归档。07-analytics-attendance-semantics.md：CURRENT (SPECIALIZED)，Package C 考勤专题统计语义，属专项技术规范，为保持顶层 9 篇架构精简，归入归档留存备查。
所有上述 8 份原文档均已完整保留在：
docs/archive/shared-trial-baseline-20260920/
（无任何物理删除，历史凭证完全可追溯）。