design.md 2.1 KB
Context
本期分别验收小程序与 HIS 前端的本地 Mock 场景。mrc-demo-state/v1 已定义脱敏字段、五个场景、六个状态和五类操作；两端必须采用同一契约语义，但不得读取同一运行时快照或互相同步。
Goals / Non-Goals
Goals:
- 维护 V1 的场景、字段、状态映射、
revision、创建申请和允许流转语义。 - 令端侧 Adapter 各自以本地内存实现语义；页面不直接读取种子数据。
- 对未知场景、未知订单、非法流转和非 Demo 调用失败关闭。
Non-Goals:
- 不实现跨设备同步、共享运行时服务、数据库、HTTP 接口、身份认证、支付或物流能力。
- 不扩展 V1 状态、动作、字段或真实业务规则。
Decisions
各端独立内存状态
每一端各自以本地内存状态保存当前快照。场景激活、重置、申请创建和成功流转都只在当前端执行并递增 revision。端侧页面只能通过本端 Adapter 调用仓库语义；两个运行时不能通信或互读。
脱敏种子与失败关闭
种子只含 V1 明示的匿名字段；任何非 Demo 环境或不合法操作返回受控错误。实现不得配置真实主机、请求库或后端回退逻辑。
契约资料先行
场景契约与脱敏种子资料先串行维护到 develop；之后两条端侧流水线可各自实现本地 Adapter，但不得修改或扩展契约。
Risks / Trade-offs
- [小程序与 HIS 的模块系统不同]：只固定 Adapter 语义，不在场景资料中耦合端侧框架。
- [内存状态刷新后丢失]：这是本地 Demo 的明确边界；场景重置用于恢复演示。
- [被误用为生产接口]：持续使用 Demo 标识，且不提供网络入口或生产配置。
Migration Plan
- 在主线维护场景契约和脱敏种子的一致性资料。
- 小程序与 HIS 在独立工作区各自实现本地 Adapter 与页面。
- 真实接口阶段另建变更，保留本期 Demo 证据但不得复用为生产验收。
Open Questions
- 无阻断本地 Demo 实现的开放问题。