Browse Source

docs(mrc): define workbench prototype remediation

anubis 1 month ago
parent
commit
943b6d955d

+ 17 - 0
docs/plans/2026-09-17-mrc-workbench-prototype-alignment-design.md

@@ -0,0 +1,17 @@
+# HIS 病案复印订单工作台原型整改设计
+
+## 结论与依据
+
+订单管理页面当前的 Mock 数据和详情作业逻辑可用,但主工作台沿用了独立 Demo 门户式布局,与已评审的 `01-订单管理页.html` 和项目负责人提供的页面截图不一致。主要差异是:自定义顶部栏和四张财务卡挤占了业务区;状态卡只有六项;筛选字段与表格列不足;内容卡距离 HIS 宿主内容区顶部过远。
+
+## 整改范围
+
+只调整 `MRCWorkbench.jsx` 和模块私有 CSS:订单管理以 HIS 内容区内白色卡片呈现,标题栏显示收费/物流模式与本地 Demo 提示;筛选栏提供申请单号、人员检索、服务类型和日期区间;状态卡覆盖设计稿中的十个状态;表格列恢复申请人类型、手机号、人员标识、来源、内容摘要、金额、申请时间、物流与状态。保留已有本地 Mock、查询、重置、状态筛选、批量、详情、审核、核算和交付动作。
+
+## 非目标
+
+不接入真实订单、配置、身份、物流、支付或报表;不实现系统配置/报表菜单;不修改公共 HIS 组件;不替换或扩展本地 Demo 状态机的真实业务语义。设计稿中超出现有 Mock 的状态显示为零数量的可筛选空态,避免伪造真实数据。
+
+## 验收
+
+结构契约覆盖十状态、四项筛选、设计稿业务列、宿主内容区布局和本地 Mock 边界;原有 9 组 MRC 离线测试与相关 OpenSpec strict 校验通过。当前 HIS 环境缺少被忽略的 `httpConfig.js`,因此宿主浏览器视觉验收仍须在具备本地环境配置的设备完成。

+ 59 - 0
docs/plans/2026-09-17-mrc-workbench-prototype-alignment.md

@@ -0,0 +1,59 @@
+# HIS 病案复印订单工作台原型整改 Implementation Plan
+
+> **For Codex:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** 让 HIS 病案复印订单工作台按已评审订单管理设计稿恢复紧凑布局、筛选、十状态磁贴和完整表格信息密度,同时保留本地 Mock 作业交互。
+
+**Architecture:** `MRCWorkbench.jsx` 仍是唯一工作台页面和交互协调器;`model/workbench.js` 仅扩展为支持申请单号与人员检索两个独立筛选字段。CSS 只在 `mrcDemo/style/` 中覆盖模块私有工作台布局,不修改 HIS 公共组件。
+
+**Tech Stack:** React、Ant Design、react-router-dom、Node.js assert、CSS。
+
+---
+
+### Task 1: 写出设计稿工作台契约
+
+**Files:**
+- Modify: `04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/__tests__/prototypeVisualContract.test.js`
+- Modify: `04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/__tests__/workbench.test.js`
+
+**Step 1: Write the failing test**
+
+断言工作台有十个设计稿状态键、申请单号和人员检索输入、设计稿业务表头、宿主内容区 class,并验证独立申请单号/人员检索会过滤 Mock 订单。
+
+**Step 2: Run test to verify it fails**
+
+Run: `node 04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/__tests__/prototypeVisualContract.test.js && node 04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/__tests__/workbench.test.js`
+
+Expected: FAIL,因为当前页面为六状态卡和合并关键词输入。
+
+### Task 2: 恢复设计稿工作台布局与交互
+
+**Files:**
+- Modify: `04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/page/MRCWorkbench.jsx`
+- Modify: `04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/model/workbench.js`
+- Modify: `04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/style/mrcDemo.css`
+
+**Step 1: Implement the smallest layout change**
+
+替换工作台顶部区域、筛选栏、状态卡定义和列定义;扩展本地筛选函数;删除仅本工作台使用的门户式顶部栏与财务卡渲染,但不删除详情/作业逻辑。
+
+**Step 2: Run focused tests**
+
+Run: `node 04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/__tests__/prototypeVisualContract.test.js && node 04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/__tests__/workbench.test.js`
+
+Expected: PASS。
+
+### Task 3: 回归验证与证据更新
+
+**Files:**
+- Modify: `01-项目文档_docs/03-功能模块/整改中(Demo)_MRC-PC-ORDER-001_订单管理工作台/13-Demo正式复审记录.md`
+
+**Step 1: Record the current visual remediation boundary**
+
+记录本轮对齐设计稿的页面区域、保持的 Mock 边界和因本机缺少忽略配置而未执行的宿主视觉验证。
+
+**Step 2: Run all checks**
+
+Run: `for f in 04-新项目源码_source/项目源码/cloudhis-pr/src/pages/mrcDemo/__tests__/*.test.js; do node "$f"; done && openspec validate mrc-demo-pc-order-001 --strict && git diff --check`
+
+Expected: 全部通过。