PR_Min_APP_BA/openspec/changes/MRC-SVC-LOG-001-statuslog-readonly-release-v1/proposal.md

Change: MRC-SVC-LOG-001 流转日志与时间轴 L1+L2 后续 first-change (V2 模式)

Why

[基于项目总控入口.md §2026-10-10 后端正式开发准入令 v1 + 已签发授权 + first-change MRC-SVC-CFG-002 / next-first-change MRC-SVC-CFG-001 / 后续 first-change MRC-CORE-BASE-001 V2 模式验证]

L1 联调 first-change(MRC-SVC-CFG-002 业务字典与文案中心)+ next-first-change(MRC-SVC-CFG-001 系统参数中心)+ 后续 first-change(MRC-CORE-BASE-001 领域地基与编号规则)已验证 V2 模式业务代码生成模式可复用。本变更选定 MRC-SVC-LOG-001 流转日志与时间轴 作为后续 first-change,理由:

1. L1 只读 + 部分 L2 写入(只追加 / 禁更新 / 禁物理删除) — 边界清晰,只追加语义保证审计可追溯
2. 已在 first-change / next-first-change / 后续 first-change V2 模式中验证业务代码生成模式可复用 — jsonObj 接口 + Global 索引 + operatetable 公共类模式可直接迁移
3. 下游消费方:FSM-001 transition() 同事务内部调用 + REJECT-001 / PAY-001 / MSG-001 异步消费方 + PC 端工作台右栏 + 小程序详情/进度页
4. 接口对齐:接口映射.md §流转日志 + MRC-SVC-LOG-001 04-接口与数据清单.md §1(writeStatusLog 10070003 / getStatusLog 10070010+11 / findLogRowByNaturalKey 10070012 / getActorName 10070013;healthCheck 10070999)
5. 模板 BSOrderStatusLog / BSLogActorCache 不存在 — 按典型业务模型 + V2 Global 索引模式补全(VisibleToPatient / ActorDr / ActorName / ActionCode 18+5 枚举 / 自然键复合唯一索引)
6. 授权范围:项目负责人书面授权_正式接口接入_v1.md §3 19 个模块清单第 15 项("MRC-SVC-LOG-001 流转日志与时间轴")+ §4 签字(高井刚 / 2026-10-9)+ OPENSPEC_STRICT_整改清单.md strict 模板已结(2026-10-09)

V2 模式改造说明(2026-10-10):

• 原 V1 模式: MRC.Service.* + User.BS* IRIS 持久化 + SqlProc + 多参数签名 + %Status 返回
• 新 V2 模式: src.<SubModule>.* 命名空间 + (%RegisteredObject, %XML.Adaptor) [ Not ProcedureBlock ] + jsonObj 接口(params.%Get(0) / session.%Get(0)) + %Library.DynamicObject 返回(包含 errorCode / errorMessage / result)+ Global 索引(^BSOrderStatusLogI / ^BSLogActorCacheI)+ 公共类 ##class(src.util.operatetable).Insert/.Update/.Delete
• 错误码通过 ##class(src.Interface.Message).GetErrorMessage(<code>) 获取
• 追加语义约束:写日志接口 writeStatusLog 仅追加,禁更新 / 禁物理删除(由 Service 层 Guard 兜底)

What Changes

• 新增 V2 模式业务类:src.SvcLog.BSOrderStatusLog(3 个方法:WriteStatusLog — 仅追加 / GetStatusLog — PC 全量+小程序过滤 / FindLogRowByNaturalKey — 自然键回查)
• 新增 V2 模式业务类:src.SvcLog.BSLogActorCache(1 个方法:GetActorName — Actor 名称缓存,避免重复查询 User.HBUser)
• 新增 V2 模式服务类:src.SvcLog.MRCSvcLogService(4 个委托方法:WriteStatusLog / GetStatusLog / FindLogRowByNaturalKey / GetActorName)
• 新增 V2 模式 REST 类:src.SvcLog.MRCSvcLogREST(4 个 WebMethod + XData UrlMap:POST /api/v2/mrc/svc-log/status-log/write + POST /api/v2/mrc/svc-log/status-log/list + GET /api/v2/mrc/svc-log/status-log/find-by-natural-key + GET /api/v2/mrc/svc-log/actor/:dr/name)
• 新增 单元测试:Tests.MRCSvcLogServiceTest(4 个方法:TestWriteStatusLog / TestGetStatusLog / TestFindLogRowByNaturalKey / TestGetActorName)
• 不实现 healthCheck 探针 + onStatusLogWritten 缓存失效内部钩子 — 后续 OpenSpec change 处理
• 不修改 V1 已生成的 47 个 .cls 文件 / Demo 源码 / 模版 / LICENSE / README / project.config

Impact

• Affected specs: 业务规则裁定/P-01-1 ~ P-01-6(已结 6/6)+ 接口映射.md §流转日志 + MRC-SVC-LOG-001 04-接口与数据清单.md §1/§2/§3/§5/§6
• Affected code: openspec/changes/MRC-SVC-LOG-001-statuslog-readonly-release-v1/specs/spec.md
• Affected modules: MRC-SVC-LOG-001(本模块);下游消费方:FSM-001(transition 同事务)+ REJECT-001(异步回查)+ PAY-001(异步回查)+ MSG-001(异步回查)+ PC 工作台右栏 + 小程序详情页 + PC-ORDER-001/002/003 详情抽屉
• Dependencies and risks:
  • 依赖 MRC-PC-AUTH-001 登录会话(已 Demo 验收,L1 只读无需强制鉴权)
  • 依赖 User.HBUser(§14-C2 复用,查询 actorDr → actorName);通过 BSLogActorCache 缓存
  • 18+5 类 ActionCode 枚举待 v2 评审时由 FSM 模块 owner 同步锁定(预填版本接受 24 类)
  • GOV-006 凭据审查待运维期处置(不影响 L1 只读 / L2 写入)
  • 写日志接口仅追加语义需 Service 层 Guard 兜底(%OnValidateObject() 校验 + 复合唯一索引 NaturalKeyUnique)
• Authorization:
  • 项目总控入口.md §2026-10-09 后端正式开发准入令 v1
  • 项目总控入口.md §2026-10-10 V2 模式改造
  • 项目负责人书面授权_正式接口接入_v1.md §3(19 个模块清单第 15 项)+ §4 签字(高井刚 / 2026-10-9)(待 V2 模式重新签字)
  • 关联 OpenSpec change:MRC-SVC-CFG-002-listbizdict-readonly-release-v1(first-change V2 模式参照)
  • 关联 OpenSpec change:MRC-SVC-CFG-001-listconfiggroups-readonly-release-v1(next-first-change V2 模式参照)
  • 关联 OpenSpec change:MRC-CORE-BASE-001-corelock-idempotency-readonly-release-v1(后续 first-change V2 模式参照)