0 Fork 0

Files

T

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

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 步标准流。

2026-09-24 00:03:47 +08:00

_meta

文档最终交付：完成最终项目文档与Human Portal交付层

2026-09-15 11:59:00 +08:00

api-v2

文档优化：将核心架构与流程字符图转换为Mermaid

2026-09-18 09:36:39 +08:00

README.md

SYFJGYD学员管理系统 — 文档中心全景地图 (Docs Map)

正式业务名称：SYFJGYD学员管理系统（内部工程代号：RailwaySystem） 共享试用环境：http://192.168.139.230:8082/（部署分支：feat/cicd-pipeline，运行状态请参见 01-CURRENT-SYSTEM-STATE.md） 核心质量结论：核心教务正向闭环全面就绪，三角色工作台验证通过，测试全绿 331 / 331 PASS。

🧭 第一屏直达：按你的目标快速找文档

请直接根据你当下的工作任务，点击下方直达通道：

┌────────────────────────────────────────────────────────────────────────┐
│ 🎯 你当前的目标是？                                                     │
├────────────────────────────────────────────────────────────────────────┤
│ 1. 只想快速了解当前系统做到哪了、能不能用？     ──► [docs/current/]      │
│ 2. 想看一期功能列表、代码对照与甲方确认项？   ──► [docs/requirements/] │
│ 3. 想系统学习业务流程、系统架构与操作手册？   ──► [docs/handbook/]     │
│ 4. 想开发新功能、对接接口或查数据库字段？     ──► [docs/contracts/]    │
│    (包含 api-v2 / database-v2 / development)                          │
│ 5. 想给领导、老师或评审专家进行生动展示？     ──► [docs/visual/]       │
│ 6. 想查阅最终验收报告或历史自动化测试证据？   ──► [docs/reports/]      │
│ 7. 想查阅甲方原始需求与早期设计演进草案？     ──► [docs/archive/]      │
└────────────────────────────────────────────────────────────────────────┘

📚 各目录体系深度说明

1. 🌟 docs/current/00-START-HERE.md — 【唯一首选入口】当前系统现行真理中心

专为人类与 Agent 设立的唯一权威现行真理门户，杜绝历史长日志篡权：

00-START-HERE.md：第一入口（真理优先级声明与全量当前文档导航）
01-CURRENT-SYSTEM-STATE.md：当前系统真实运行基线、技术栈与工作树状态
02-FUNCTION-MODULES.md：业务功能模块全量五级判定 (IMPLEMENTED/PARTIAL/MOCK/BLOCKED_EXTERNAL/NOT_IMPLEMENTED)
03-DATABASE-AND-TABLES.md：KingbaseES 物理表结构、迁移链与纯净演示库重建规约
04-API-INVENTORY.md：全量 API 接口账本（路径、方法、源码分类、控制器、关联物理表）
05-CLIENT-API-STATUS.md：甲方与外部接口状态清单（REAL_LIVE/NOT_YET_TESTED/MOCK）
06-DEMO-BASELINE.md：演示基线准则（旧Demo不可信声明与新Demo确定性构建七大原则）
07-KNOWN-GAPS.md：内部已知缺口与外部阻塞清单（内部阻断项已清零，仅存外部 DMS 硬件阻塞）
08-NEXT-ACTIONS.md：下一阶段标准化 16 步行动路线图

2. 📋 docs/requirements/ — 业务需求与确认清单

连接业务与代码的正式事实依据：

一期PRD-V1.0.md：一期系统正式业务需求冻结基线（领域对象、业务规则与输入输出约束）
一期需求实现进度表.md：按模块逐项核对每一条需求的前后端代码实现、页面位置与测试证据
甲方需求确认清单.md：面向沈阳房建公寓段业务老师提炼的待确认分级清单（P0 核心 18 项、P1 细节 12 项、P2 规划 8 项）

3. 📖 docs/handbook/ — 团队操作白皮书与全景指南

面向人类可读的系统级白皮书，涵盖业务、技术与运维全链路：

01-project-overview.md：系统建设背景、业务痛点与角色价值
02-business-process.md：核心业务闭环流程与状态机流转规则
03-system-architecture.md：系统分层架构、核心组件与技术选型
04-data-model-overview.md：数据模型概念设计与关键实体关系
05-module-guide.md：14 大业务功能模块使用与代码扩展指南
06-api-and-permission-overview.md：接口分类体系与 RBAC 权限矩阵
07-testing-and-acceptance.md：测试规范与自动化验证体系
08-deployment-and-release.md：共享试用环境部署拓扑与运维规范
09-current-status.md：团队级现状综合看板

4. 🔒 研发契约与开发规范 (Contracts & Development)

技术人员与智能 Agent 研发的核心事实源（只读冻结）：

docs/api-v2/：RESTful API 契约总纲、Module A~D 接口规范、DTO/VO 字典与业务错误码
docs/database-v2/：国产人大金仓 KingbaseES 物理表清单、索引约束设计与迁移说明
docs/development/：
- git-commit-convention.md：项目 Git 提交中文格式规范
- dms-r3/：DMS 智能门禁适配器架构设计与 Token 策略
- rbac-r2/：多角色 RBAC、业务身份绑定与防 IDOR 越权设计

5. 🖥️ docs/visual/ — 数字化离线交付门户

纯静态 HTML + CSS + JS 构建的交互式展示门户，浏览器直接双击打开，适合大屏展示：

index.html：交付门户主页
architecture.html：架构与技术栈
business-flow.html：全景业务状态机
data-model.html：实体关系 (ER) 与表字典
modules.html：14 大模块导览
testing.html：质量与验证体系
deployment.html：部署拓扑与 Delta 增量
release-status.html：发版进度与门禁看板

6. 📑 docs/reports/ — 质量验收与历史证据

当前唯一终验报告：FINAL_PHASE1_20260917_101044/（含执行总摘要）
过程性测试证据：Round 1~3B 自动化测试日志、DMS 实测探针、Playwright 无头浏览器运行截图
早期归档报告：archive/20260915/（已被终检报告全面覆盖的早期旧报告）

7. 🏛️ docs/archive/ — 历史资料归档中心

归档项目启动与早期研发阶段的原始交付与过程资产（HISTORICAL REFERENCE）：

raw-materials/：甲方原始交付需求、功能分析与初版数据表设计（docx / md 原件）
requirements-history/：需求演进过程稿（PRD V0.9、V0.1 调研表、业务基线草案）
legacy-design/：早期技术原型资料（详细开发说明书草案、ELK 拓扑原型）
database-history/：历史数据库设计资料（Kingbase DDL 规范草稿）

README.md Unescape Escape