Просмотр исходного кода

docs(mrc): define demo source structure

anubis 2 месяцев назад
Родитель
Сommit
71e3ab6117

+ 27 - 0
docs/plans/2026-09-17-mrc-demo-source-structure-design.md

@@ -0,0 +1,27 @@
+# HIS 病案复印 Demo 源码分层设计
+
+## 目标
+
+将 `src/pages/mrcDemo/` 内平铺的页面、状态逻辑、工具函数、样式和测试按 HIS 既有模块的目录习惯分层,提升可读性和后续维护性。此次仅进行目录治理:页面功能、Mock 数据边界、对外路由、菜单数量和交互行为均不变。
+
+## 采用结构
+
+```text
+mrcDemo/
+├── page/       # 可渲染的业务页面:入口页、订单工作台
+├── route/      # 兼容路由桥:审核、交付均转回工作台
+├── model/      # 本地 Mock 状态和订单作业规则
+├── utils/      # 无状态路由参数工具
+├── style/      # 模块私有样式
+└── __tests__/  # 离线单元与原型契约测试
+```
+
+页面文件继续使用 `MRCDemoEntry.jsx` 与 `MRCWorkbench.jsx` 两个独立页面;`MRCAudit.jsx`、`MRCDelivery.jsx` 只保留为历史直达地址的兼容桥接,不作为新的业务菜单页。路由配置的组件路径将同步改为新目录,仍保持 `/mrc-demo`、`/mrc-demo/orders`、`/mrc-demo/audit`、`/mrc-demo/delivery` 四个地址。
+
+## 菜单决议
+
+配置一个菜单即可:`病案复印(Demo)`,菜单 path 为 `/mrc-demo`,对应 `page/MRCDemoEntry.jsx`。订单、审核/核算和交付均从入口场景进入工作台完成;不得增加审核、交付的独立菜单,以免破坏订单上下文。
+
+## 验收依据
+
+目录迁移后,静态路由必须指向实际 JSX 文件;8 个已有 `mrcDemo` 离线测试全部通过;新增目录结构契约测试必须证明四个对外路由仍指向预期组件或桥接页;`git diff --check` 不得报错。

+ 66 - 0
docs/plans/2026-09-17-mrc-demo-source-structure.md

@@ -0,0 +1,66 @@
+# HIS 病案复印 Demo 源码分层 Implementation Plan
+
+> **For Codex:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** 将 HIS 病案复印 Demo 的平铺源码整理为页面、路由桥、模型、工具、样式和测试分层,保持菜单与路由行为不变。
+
+**Architecture:** 路由仍由 `StaticRouterData.js` 统一声明;仅将其 JSX 组件地址调整到 `mrcDemo/page/` 和 `mrcDemo/route/`。页面继续从 `model/`、`utils/`、`style/` 导入模块私有能力;测试移动至 `__tests__/` 并改用相对引用。无接口、无持久化、无业务交互变更。
+
+**Tech Stack:** React、react-router-dom、Ant Design、Node.js assert、Git。
+
+---
+
+### Task 1: 写出目录与路由契约测试
+
+**Files:**
+- Create: `04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/__tests__/structure.test.js`
+- Test: `04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/__tests__/structure.test.js`
+
+**Step 1: Write the failing test**
+
+断言迁移后的 4 个 JSX 文件、模型、工具和样式文件都位于目标目录;断言 `StaticRouterData.js` 的 4 个组件路径使用新目录。
+
+**Step 2: Run test to verify it fails**
+
+Run: `node 04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/__tests__/structure.test.js`
+
+Expected: FAIL,因为迁移前目标目录不存在。
+
+**Step 3: Move files and update imports**
+
+使用 `git mv` 迁移文件;调整页面、路由桥、测试的相对导入;更新静态路由组件路径。
+
+**Step 4: Run test to verify it passes**
+
+Run: `node 04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/__tests__/structure.test.js`
+
+Expected: `mrcDemo structure tests passed`。
+
+**Step 5: Commit**
+
+```bash
+git add docs/plans 04-新项目源码_source/项目源码/cloudhis-pr/src
+git commit -m "refactor(mrc): organize demo source structure"
+```
+
+### Task 2: 回归验证并记录菜单映射
+
+**Files:**
+- Modify: `01-项目文档_docs/03-功能模块/整改中(Demo)_MRC-PC-ORDER-001_订单管理工作台/13-Demo正式复审记录.md`
+- Test: `04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/__tests__/*.test.js`
+
+**Step 1: Add the menu-routing evidence**
+
+写入唯一菜单 `/mrc-demo` 与 `page/MRCDemoEntry.jsx` 的对应关系,并标注其余三条路由为工作台或兼容桥接,不新增菜单。
+
+**Step 2: Run all offline tests**
+
+Run: `for f in 04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/__tests__/*.test.js; do node "$f"; done`
+
+Expected: 所有 9 组测试通过。
+
+**Step 3: Validate references and diff**
+
+Run: `node 04-新项目源码_source/项目源码/pri-smart-hospital-miniprogram/scripts/validate-doc-links.js && git diff --check`
+
+Expected: 文档链接与差异格式均通过。