Browse Source

docs: 明确Demo放行与HIS前端边界

anubis 2 months ago
parent
commit
14ddf0f0ed

+ 4 - 3
01-项目文档_docs/00-项目管理/01-入口与上下文/Demo MVP开发规划.md

@@ -5,9 +5,10 @@
 ## 1. 项目负责人授权与边界
 
 - 目标:先验收“申请—审核/核算—交付—进度”的前端核心闭环 Demo。
-- 技术基线:在 `04-新项目源码_source/项目源码/` 复制既有医院小程序、HIS 前端和 IRIS/HIS 后端源码;只修改前两个前端副本,后端副本只读。
+- 技术基线:在 `04-新项目源码_source/项目源码/` 复制既有医院小程序、HIS 前端和 IRIS/HIS 后端源码;只在前两个前端副本新增病案复印页面,后端副本只读。不得修改既有功能;列表/表格优先直接复用既有公共组件,不得为 Demo 重写公共组件。
 - 数据:小程序与 HIS 前端通过共享、可切换的本地 Demo 状态服务访问脱敏场景数据;禁止连接真实 HIS、支付、物流、账号或生产环境。
-- 生命周期:Demo 前端模块按正式评审、开发、自检、验收、归档流程执行;当前交付类型为 `Demo`。真实接口接入另建变更并重新验收。
+- 生命周期:Demo 前端模块按正式评审、开发、自检、验收、归档流程执行;当前交付类型为 `Demo`。功能、文档及审查证据完整且足以支持开发时,项目管理 Agent 可直接更新为 `待开发(Demo)`;真实接口接入另建变更并重新验收。
+- HIS 前端运行验证:本期不以完整构建作为 Demo 模块放行条件。依赖来源、Node 版本和完整构建验证作为正式集成前的后置风险登记;任何开发仍须执行可用的静态检查、变更范围检查和模块级验证。
 
 ## 2. 新源码基线目录
 
@@ -39,7 +40,7 @@
 
 ## 5. 开发顺序与并行控制
 
-1. 建立三端源码安全基线并验证可运行性。
+1. 建立三端源码安全基线;小程序执行现有离线验证,HIS 前端完整构建作为正式集成前后置验证,不阻断本期页面开发。
 2. 冻结 Demo 场景、状态枚举、字段和 Mock Adapter 契约。
 3. 小程序:宿主接入 → 申请主链 → 详情/进度。
 4. HIS 前端:Demo 身份上下文 → 工作台 → 审核核算 → 交付。

+ 6 - 6
01-项目文档_docs/00-项目管理/项目总控入口.md

@@ -9,12 +9,12 @@ as_of: "2026-09-15"
 project_name: "病案复印(Medical Record Copy, MRC)"
 repository_root: "04-新项目源码_source/"
 main_development_branch: "develop"
-current_phase: "Demo MVP 基线建立与前端核心模块正式复审"
-development_authorization: "已授权建立 Demo 源码基线;仅经 Demo 正式复审通过的前端核心模块可进入 Demo 开发。后端、真实接口和生产联调未授权。"
+current_phase: "Demo MVP 共享 Mock 契约冻结与前端核心模块正式复审"
+development_authorization: "已授权建立 Demo 源码基线;Demo 模块在功能、文档与审查证据完整且足以支持开发时,可由项目管理 Agent 直接更新为待开发(Demo)。后端、真实接口和生产联调未授权。"
 current_baseline: "Demo MVP 源码基线 374271143a1e7a47fd769a2ee7a05715cb5741f8"
-current_baseline_evidence: "codex/demo-mvp-baseline@374271143a1e7a47fd769a2ee7a05715cb5741f8;三套输入源码快照摘要一致;小程序离线验证通过;HIS 前端依赖待验证"
+current_baseline_evidence: "codex/demo-mvp-baseline@374271143a1e7a47fd769a2ee7a05715cb5741f8;三套输入源码快照摘要一致;小程序离线验证通过;HIS 前端构建不属于本期 Demo 放行条件"
 scope: "26 个生产模块保持不变;本期 Demo MVP 交付‘申请—审核/核算—交付—进度’前端核心闭环"
-technology_direction: "沿用既有医院小程序、HIS 前端与 IRIS/HIS 后端技术栈;本期仅修改小程序和 HIS 前端副本,以本地共享 Mock 状态服务支撑 Demo;后端副本只读"
+technology_direction: "沿用既有医院小程序、HIS 前端与 IRIS/HIS 后端技术栈;本期仅在小程序和 HIS 前端副本新增病案复印页面,以本地共享 Mock 状态服务支撑 Demo;不得改动既有功能,表格优先直接复用公共组件;后端副本只读"
 ```
 
 ## 2026-09-14 项目负责人裁定
@@ -42,7 +42,7 @@ technology_direction: "沿用既有医院小程序、HIS 前端与 IRIS/HIS 后
 | 模块范围 | 26 个生产模块上下文包均存在;Demo MVP 选取 11 个前端核心模块 | 生产范围不拆分;Demo 交付类型只在唯一进度表中标明 |
 | 模块状态 | 全部生产状态仍为待评审 | Demo MVP 前端模块先做正式 Demo 复审;后端/集成模块保持待评审 |
 | OpenSpec | 26 个 active change 存在;`openspec validate --all --strict` 为 0/26 通过 | 生产 change 继续整改;Demo 基线使用独立 change,不替代生产 strict 校验 |
-| 源码与 Git | 三套旧源码已安全快照为 Demo MVP 基线;小程序离线验证通过,HIS 前端构建待依赖补齐 | 已在隔离分支完成,待串行集成;不得据此宣称真实联调可用 |
+| 源码与 Git | 三套旧源码已安全快照为 Demo MVP 基线;小程序离线验证通过;HIS 前端构建不属于本期 Demo 放行条件 | 新增页面仅可在既有前端副本中实现;不得改动既有功能,不得据此宣称真实联调可用 |
 | 输入与联调 | 接口文档、业务资料、测试账号、环境配置尚无实际输入 | 阻断真实接口与生产验收;Demo 仅使用脱敏本地 Mock 场景 |
 | 验收、问题、归档 | 无实际报告、问题单或归档产物 | 开发后按既定流程产生,不得预填完成结论 |
 
@@ -61,7 +61,7 @@ technology_direction: "沿用既有医院小程序、HIS 前端与 IRIS/HIS 后
 | --- | --- | --- | --- | --- |
 | GOV-001 | 当前状态、基线与历史计划口径冲突 | 全项目 | 项目管理 Agent | 校正中 |
 | GOV-002 | 26 个 OpenSpec change 缺少有效 delta/Requirement/Scenario | 全项目 | 规格/变更管理员 | 待整改 |
-| GOV-003 | HIS 前端构建依赖来源、Node 兼容版本与安装授权缺失 | HIS 前端 Demo 验证 | 项目工程 lead | 待补齐;不影响已建立的源码快照 |
+| GOV-003 | HIS 前端构建依赖来源、Node 兼容版本与安装授权缺失 | 正式集成前运行验证 | 项目工程 lead | 后置风险;本期新增页面审查与 Demo 开发不阻断 |
 | GOV-004 | 接口、业务、测试账号、环境四类输入缺失 | 正式开发及真实联调 | 对应输入 owner | 待补齐;不阻断本地 Demo |
 | GOV-005 | 快递费补缴/支付回调口径与离线到付草稿冲突 | PAY、FEE、FSM、物流、报表相关模块 | 项目负责人 | 复审裁定前阻塞实现 |
 | GOV-006 | 旧源码存在潜在敏感配置候选,需在后端开发或真实接口接入前完成内容级凭据审查 | 后端、真实接口与发布 | 授权安全责任方 | 待补齐;不阻断本地 Demo |

+ 20 - 0
01-项目文档_docs/07-项目记录/01-启动与规划记录/2026-09-15_Demo审查放行与HIS前端改动边界裁定.md

@@ -0,0 +1,20 @@
+# 2026-09-15 Demo 审查放行与 HIS 前端改动边界裁定
+
+## 裁定结论
+
+1. 对交付类型为 `Demo MVP` 的前端模块,若功能范围、模块文档、审查证据和开发前置条件完整,且足以支持开发,项目管理 Agent 可直接将模块状态更新为 `待开发(Demo)`,无需逐模块再次请示。
+2. 本期 HIS 前端不要求执行完整构建;缺少依赖来源、Node 兼容版本和安装授权属于正式集成前的后置风险,不阻断本期 Demo 模块审查和新增页面开发。
+3. 本期小程序和 HIS 前端仅可新增病案复印功能页面及其必要的 Demo 适配层;不得修改既有业务功能、公共组件实现或既有页面行为。
+4. 新增页面中的列表和表格优先直接复用既有公共组件;如既有公共组件不能满足,应先在模块审查中登记缺口和替代方案,不得擅自改写公共组件。
+
+## 不改变的边界
+
+- 后端与集成模块继续保持 `待评审`、`仅契约输入`,本期不开发。
+- Demo 继续使用脱敏、共享且可切换的本地 Mock 状态;不得连接真实接口、真实账号、生产环境或真实数据。
+- 真实接口接入、完整构建验证、联调、验收和发布仍须独立建立变更并执行对应门禁。
+
+## 适用证据
+
+- 当前阶段、基线与阻塞:`00-项目管理/项目总控入口.md`
+- Demo 范围与流程:`00-项目管理/01-入口与上下文/Demo MVP开发规划.md`
+- 模块状态与交付类型:`00-项目管理/03-交付验收/功能模块总进度表.md`

+ 25 - 1
openspec/changes/mrc-demo-mvp-baseline/specs/demo-mvp-governance/spec.md

@@ -6,7 +6,31 @@
 
 #### Scenario: 前端模块进入 Demo 复审
 - **WHEN** 项目负责人将某个小程序或 HIS 前端核心模块纳入 Demo MVP
-- **THEN** 唯一进度表记录其正式状态为“待评审”、交付类型为“Demo”,并列明 Demo 范围、Mock 边界和关联设计依据
+- **THEN** 唯一进度表记录其正式状态为“待评审”、交付类型为“Demo MVP”,并列明 Demo 范围、Mock 边界和关联设计依据
+
+### Requirement: Demo 正式复审的直接放行
+
+系统 MUST 要求 Demo 模块在进入开发前具备完整的功能范围、模块文档、审查证据、Mock 边界、验收标准和开发前置条件。上述材料足以支持开发时,项目管理 Agent MAY 直接将其状态更新为“待开发(Demo)”;缺少任一项时 MUST 保持“待评审”并登记阻塞。
+
+#### Scenario: 审查证据完整且可直接放行
+- **WHEN** Demo 模块的审查记录证明功能、文档、设计依据、依赖契约、Mock 边界和验收标准均完整,并且不存在未登记的开发前置阻塞
+- **THEN** 项目管理 Agent 将唯一进度表、模块 README 和规格元数据同步更新为“待开发(Demo)”,并记录放行依据
+
+#### Scenario: 审查证据不足
+- **WHEN** Demo 模块缺少可定位的设计依据、Mock 契约、验收条件、允许修改范围或必要前置条件
+- **THEN** 模块保持“待评审”,审查记录列出缺口、风险和下一动作,不得创建开发分支或开始编码
+
+### Requirement: HIS 前端 Demo 的页面改动与验证边界
+
+系统 MUST 仅在既有 HIS 前端副本中新增病案复印页面和必要的 Demo 适配层,不得修改既有业务功能、既有页面行为或公共组件实现。新增列表与表格 MUST 优先直接复用既有公共组件。本期完整构建不是 Demo 模块放行条件,但模块仍 MUST 执行可用的静态检查、变更范围检查和模块级验证。
+
+#### Scenario: HIS 前端新增 Demo 页面
+- **WHEN** 开发 HIS 前端 Demo 模块
+- **THEN** 变更范围仅包含新增病案复印页面、路由声明和必要的 Demo 适配层;若既有公共组件不满足需求,审查记录先登记缺口和替代方案,不得擅自改写公共组件
+
+#### Scenario: HIS 前端完整构建环境缺失
+- **WHEN** 缺少可信的依赖来源、Node 版本或安装授权而无法执行完整构建
+- **THEN** 项目将其登记为正式集成前的后置风险,不阻断本期新增页面的审查和 Demo 开发,也不得将其表述为 HIS 前端完整构建已通过
 
 #### Scenario: 后端模块仅提供契约输入
 - **WHEN** Demo 场景需要订单、状态、费用、支付、物流或 HIS 数据字段

+ 3 - 3
openspec/changes/mrc-demo-mvp-baseline/tasks.md

@@ -2,13 +2,13 @@
 
 - [x] 1.1 记录项目负责人关于 Demo MVP、三端源码快照和后端只读边界的裁定。
 - [x] 1.2 在项目总控、唯一进度表和模块规格中登记 Demo 交付类型,不改变 26 个模块的生产状态。
-- [ ] 1.3 对 11 个前端核心模块完成 Demo 正式复审,并记录设计依据、Mock 边界与验收标准。
+- [ ] 1.3 对 11 个前端核心模块完成 Demo 正式复审,并记录设计依据、Mock 边界、验收标准、允许修改范围和直接放行结论。
 
 ## 2. 源码基线
 
 - [x] 2.1 对三套输入源码执行结构、文件类型和路径级凭据候选预检。
 - [x] 2.2 在新源码根复制小程序、HIS 前端和后端只读快照,记录来源、文件摘要和排除项。
-- [ ] 2.3 完成各前端工程的可运行性验证;缺依赖、构建失败或安全审查未完成时登记阻塞。
+- [ ] 2.3 完成小程序可运行性验证;HIS 前端完整构建环境缺失时登记为正式集成前后置风险,不阻断本期新增页面审查与 Demo 开发。
 
 ## 3. 共享 Demo 状态平台
 
@@ -19,5 +19,5 @@
 ## 4. Demo MVP 端侧交付
 
 - [ ] 4.1 按依赖顺序完成小程序核心模块的 Demo 实现与自检。
-- [ ] 4.2 按依赖顺序完成 HIS 前端核心模块的 Demo 实现与自检。
+- [ ] 4.2 按依赖顺序完成 HIS 前端核心模块的 Demo 实现与自检,仅新增病案复印页面和必要适配层,列表/表格优先复用公共组件。
 - [ ] 4.3 完成“申请—审核/核算—交付—进度”双端核心闭环演示验收,并登记 Mock 和真实接口未验证边界。