docs: plan his mrc prototype remediation

docs/plans/2026-09-17-mrc-his-prototype-remediation.md

@@ -0,0 +1,205 @@
+# HIS MRC Demo 原型整改 Implementation Plan
+
+> **For Codex:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** 在 HIS 前端以本端脱敏 Mock 数据实现病案复印 PC 原型的订单工作台、详情、审核核算、交付、进度与允许的变更交互。
+
+**Architecture:** 保留 `mrcDemo/demoState.js` 作为唯一的本端内存状态 Adapter；将 `/mrc-demo/orders` 重建为原型的唯一工作台入口，抽屉/弹层由该工作台编排。`/mrc-demo/audit` 与 `/mrc-demo/delivery` 保留为兼容路由，但应重定向或承载同一工作台选中订单，不能再呈现独立的简化业务页面。
+
+**Tech Stack:** React class components、Ant Design、现有 HIS 样式体系、Node `assert` 离线测试、HTML 原型 `PC端原型/01-订单管理页.html`。
+
+---
+
+### Task 1: 固化当前 Demo 授权与整改状态
+
+**Files:**
+- Create: `01-项目文档_docs/07-项目记录/01-启动与规划记录/2026-09-17_HIS-Demo原型整改授权记录.md`
+- Modify: `01-项目文档_docs/00-项目管理/项目总控入口.md`
+- Modify: `01-项目文档_docs/00-项目管理/03-交付验收/功能模块总进度表.md`
+
+**Step 1: 写入授权结论**
+
+记录项目负责人授权：HIS Demo 按正式用户交互和原型实现；所有数据/状态均为本端 Mock；不连接真实接口、支付、物流、身份、病历或跨端同步；不以严格业务校验阻断 Demo 操作。
+
+**Step 2: 更新唯一当前口径**
+
+将 `MRC-PC-AUTH-001`、`MRC-PC-ORDER-001/002/003` 标记为 `整改中（Demo）`，下一动作为“完成原型整改与 HIS 宿主视觉走查”；不变更后端、配置、报表或真实联调状态。
+
+**Step 3: 校验 Markdown 结构和差异**
+
+Run: `git diff --check`
+
+**Step 4: Commit**
+
+```bash
+git add 01-项目文档_docs
+git commit -m "docs: authorize his demo prototype remediation"
+```
+
+### Task 2: 扩展本端 Mock 状态与动作契约
+
+**Files:**
+- Modify: `04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/demoState.js`
+- Modify: `04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/audit.js`
+- Modify: `04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/delivery.js`
+- Create: `04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/prototypeFlow.test.js`
+
+**Step 1: 写失败测试**
+
+覆盖本端订单可执行：审核通过、驳回、核算确认、复印完成、发货/自取、确认领取、改为自取、撤销/退回和操作日志；断言动作只更新快照并产生时间轴事件。
+
+**Step 2: 确认 RED**
+
+Run: `node src/pages/mrcDemo/prototypeFlow.test.js`
+
+Expected: FAIL，原因是动作映射或 Adapter API 尚未存在。
+
+**Step 3: 最小实现**
+
+在 `demoState` 明确维护可见状态、Mock 表单字段和所有允许动作；所有输入只在内存快照中生效。`audit.js`、`delivery.js` 只暴露当前状态可见的动作描述。
+
+**Step 4: 确认 GREEN**
+
+Run: `node src/pages/mrcDemo/prototypeFlow.test.js && node src/pages/mrcDemo/demoState.test.js`
+
+Expected: PASS。
+
+**Step 5: Commit**
+
+```bash
+git add 04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo
+git commit -m "feat(demo): add his prototype mock flow actions"
+```
+
+### Task 3: 重建工作台与详情抽屉视觉骨架
+
+**Files:**
+- Modify: `04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/MRCWorkbench.jsx`
+- Modify: `04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/MRCDemoEntry.jsx`
+- Modify: `04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/mrcDemo.css`
+- Create: `04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/prototypeVisualContract.test.js`
+
+**Step 1: 写失败视觉/结构契约**
+
+断言工作台具备原型关键节点：宿主顶部导航、财务统计、状态卡、完整筛选（单号/人员/服务/日期）、表格/分页、1040px 详情抽屉、申请/材料/病案/费用/交付/日志分区。
+
+**Step 2: 确认 RED**
+
+Run: `node src/pages/mrcDemo/prototypeVisualContract.test.js`
+
+Expected: FAIL，当前仅含通用卡片/Select/500px 摘要抽屉。
+
+**Step 3: 最小实现**
+
+工作台使用原型信息层级和视觉 token；所有筛选、状态卡、分页、详情/日志开关由本端快照驱动。详情抽屉使用 1040px 双栏结构，保留原型中可操作节点的入口。
+
+**Step 4: 确认 GREEN**
+
+Run: `node src/pages/mrcDemo/prototypeVisualContract.test.js && node src/pages/mrcDemo/workbench.test.js`
+
+Expected: PASS。
+
+**Step 5: Commit**
+
+```bash
+git add 04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo
+git commit -m "feat(demo): rebuild his mrc prototype workbench"
+```
+
+### Task 4: 在详情上下文实现审核与核算作业
+
+**Files:**
+- Modify: `04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/MRCWorkbench.jsx`
+- Modify: `04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/MRCAudit.jsx`
+- Modify: `04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/mrcDemo.css`
+- Modify: `04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/prototypeFlow.test.js`
+
+**Step 1: 写失败测试**
+
+增加审核通过/驳回原因/意见、核算页数和费用预览、确认后返回详情时间轴的本端流程断言。
+
+**Step 2: 确认 RED**
+
+Run: `node src/pages/mrcDemo/prototypeFlow.test.js`
+
+Expected: FAIL，因为当前无法表达审核/核算表单状态。
+
+**Step 3: 最小实现**
+
+实现原型形式的审核与核算抽屉，含本地确认反馈。仅保留轻量演示必填提示，禁止 `fetch`、真实支付或真实业务校验。
+
+**Step 4: 确认 GREEN**
+
+Run: `node src/pages/mrcDemo/prototypeFlow.test.js && node src/pages/mrcDemo/audit.test.js`
+
+Expected: PASS。
+
+**Step 5: Commit**
+
+```bash
+git add 04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo
+git commit -m "feat(demo): add his mrc audit and settlement drawers"
+```
+
+### Task 5: 实现交付、进度和变更作业
+
+**Files:**
+- Modify: `04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/MRCWorkbench.jsx`
+- Modify: `04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/MRCDelivery.jsx`
+- Modify: `04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/mrcDemo.css`
+- Modify: `04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/prototypeFlow.test.js`
+
+**Step 1: 写失败测试**
+
+增加快递/自取表单、进度查看、改为自取、撤销、退回待复印和本地确认反馈的状态断言。
+
+**Step 2: 确认 RED**
+
+Run: `node src/pages/mrcDemo/prototypeFlow.test.js`
+
+Expected: FAIL，因为当前交付仅提供单一演示按钮。
+
+**Step 3: 最小实现**
+
+恢复原型的交付抽屉、进度抽屉、改为自取和确认弹层；表单数据仅更新当前 Adapter 快照，必须明确演示性质。
+
+**Step 4: 确认 GREEN**
+
+Run: `node src/pages/mrcDemo/prototypeFlow.test.js && node src/pages/mrcDemo/delivery.test.js`
+
+Expected: PASS。
+
+**Step 5: Commit**
+
+```bash
+git add 04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo
+git commit -m "feat(demo): add his mrc delivery and progress drawers"
+```
+
+### Task 6: 集成复核与宿主视觉验收准备
+
+**Files:**
+- Modify: `01-项目文档_docs/07-项目记录/02-审查与复盘记录/2026-09-17_HIS前端MRC-Demo原型一致性静态审查.md`
+
+**Step 1: 全量离线验证**
+
+Run: `for f in src/pages/mrcDemo/*.test.js; do node "$f"; done`
+
+Expected: 全部 PASS。
+
+**Step 2: 静态安全检查**
+
+Run: `rg -n "fetch\\(|axios|XMLHttpRequest|localStorage|sessionStorage" src/pages/mrcDemo && git diff --check`
+
+Expected: 无真实服务、持久化或跨端状态调用；差异检查通过。
+
+**Step 3: 原型复核**
+
+逐项对照工作台、详情、审核、核算、快递、自取、进度和变更面板，记录剩余问题；没有 P0/P1 才可请项目负责人进行 HIS 宿主视觉走查。
+
+**Step 4: Commit**
+
+```bash
+git add 01-项目文档_docs
+git commit -m "docs: record his demo remediation verification"
+```