Skip to content

docs: align design, ADRs and governance with 2026-10-23 scope decisions - #6

Merged
marchtian merged 3 commits into
mainfrom
claude/project-thread-t37d5p
Oct 23, 2026
Merged

marchtian merged 3 commits into
mainfrom
claude/project-thread-t37d5p

Conversation

@marchtian

Copy link
Copy Markdown
Collaborator

背景

2026-10-23 设计审核与开发计划讨论的结论落到仓库文档。只改文档、模板和参数定义,不改代码。

改了什么

  • 新增 ADR-0008(订单到付款留在 ERP:核心 35 → 27 个对象,srm_delivery_record 替代收货/检验,ERP 集成点预留、门户镜像在集成后建)和 ADR-0009(先做核心包;扩展包准入标准与接入规则;客户个性化放客户层;核心 API 名冻结)。ADR-0001/0002/0003/0006/0007 补「验证结果」与「补充说明」。
  • 新增 docs/engineering/README.md:建模规范(谓词不穿引用、不含 role、stageField 内联、空值安全唯一、跨记录规则走 screen flow)、分支与 PR、CI 门禁、测试策略、版本与升级。
  • 设计文档 01–07 按新范围重写相关章节:27 个对象清单与版本列、移出核心的对象去向、ER 图、准入流程(内部登记、重新申请、建档推迟到资料审核、A 类/高风险会签质量经理)、交付记录导入与 SCAR、按周期考评、03 §12 审批矩阵作为唯一来源、06 改为「预留集成点」、07 改为 v0.1–v0.7 版本路线 + 两个门槛 + D1–D9 状态列 + P-D1–P-D5 + 平台依赖验证结果与 issue 清单。
  • docs/packs:三个包标「设计保留,未排期」,新增 §3.5 准入标准与依赖顺序,桥接模块暂不做;hazmat/bulk 记审核 F-23/F-24。
  • governance:ZC-02、QP-01 附录 C、GL-02 附录 A 按 03 §12 改写;org.example.yaml 增加 position.* 岗位称谓;GL-01/GL-04 的硬编码时限参数化(新增 admission_approval_days、change_review_days);GL-02 7.2 专家库加 pack:soe 条件;README 状态行与编写计划按版本重排。
  • AGENTS.md、README、docs/README 同步范围与红线(红线 4 收窄、新增红线 7 核心 API 名冻结)。

需要确认的两处默认

计划决策 P-D1、P-D2 按建议先行,若不同意请在评审中指出:

  • P-D1 审批矩阵以 03 §12 为准,体系文件模板跟着改(制度原按 A/B/C 类分审批层级,现统一为两级 + A 类/高风险会签质量经理)。
  • P-D2 物资 A/B/C 分类放在 srm_category.material_class,决定质量经理会签、现场审核频次、绩效周期。

根 README 的「当前状态」与 PR #5 可能有冲突,以本 PR 的版本表为准合并即可。

校验

  • python3 governance/scripts/build.py --check 与 --check --packs bulk,hazmat,soe 均通过(12 个文件,待确认 0 项)。
  • 全仓库 Markdown 相对链接与锚点检查 0 问题。

审核意见处理状态(F-01–F-29)

# 意见 处理
F-01 公开表单落入部署默认组织 平台 issue objectstack#25447;FR-201 降为 P2 待平台,v0.6 用邀请注册
F-02 字段谓词不能穿引用 本 PR:02 §1、03 §2.1、AGENTS.md、engineering §1
F-03 审批矩阵设计与制度两套 本 PR:03 §12 为唯一来源,ZC-02/QP-01/GL-02 改写(P-D1 待确认)
F-04 A/B/C 分类系统里没有 本 PR:srm_category.material_class(P-D2 待确认)
F-05 准入申请缺「内部登记」来源 本 PR:02 §4.2 source = internal,03 §3 内部代录差异
F-06 v0.1 缺采购总监岗位 本 PR:04 §2 岗位清单;v0.1 实现在 PR #5 评审时核对
F-07 is_mandatory 无对应 flow 本 PR:并入 srm_supplier_qualification_recalc
F-08 淘汰供应商无法重新准入 本 PR:duplicate_check = reapply,旧档续用
F-09 contact_role 触犯保留词 本 PR:02 §4.1 改 contact_function,AGENTS.md 命名规则
F-10 匿名提交即建主数据 本 PR:建档推迟到资料审核阶段
F-11 flow 写岗位任命待验证 平台 issue objectstack#25443 / #25251;07 §6.2 V2 列为 v0.6 前首项
F-12 寻源单按品类共享无设计 本 PR:OWD public_read + FLS(v0.7)
F-13 ERP 来源对象的 portal_position 回填 本 PR:06 §1.3;随 ERP 集成实现
F-14 集成账号权限与 I4/I15 矛盾 随范围调整:发票不做;集成权限集标为预留(04 §2.2)
F-15 4 个「系统控制」参数无规则 本 PR:03 §4 发布校验加 min_bidders、tech_weight_max;另两项为制度要求
F-16 核心模板引用专家库 本 PR:GL-02 7.2 pack:soe 条件块
F-17 模板硬编码时限 本 PR:admission_approval_days、change_review_days 参数化;其余保留为制度文本
F-18 07 过时 本 PR:07 重写
F-19 ADR 待验证未跟踪 本 PR:ADR-0002/0003/0007 补结果;07 §6 验证结果列
F-20 sourcing_type 内联选项 本 PR:picklist srm_sourcing_type(v0.7)
F-21 封标与价格记录可读 本 PR:04 §4.1 说明
F-22 多轮议价计数 本 PR:BR-07 注明按当前轮次
F-23 危化品承运商单值 portal_position 本 PR:hazmat §5 记方案;包未排期
F-24 大宗月度订单方向相反 本 PR:bulk §7 记 I9b 前置;包未排期
F-25 未引用参数无提示 推迟:build.py 改动随 v0.2 工程 PR
F-26 缺 docs/engineering 本 PR:首版
F-27 governance README 状态行 本 PR
F-28 ADR-0001 前提未被平台承诺 本 PR:ADR-0001 补充说明(hooks 存在、沙箱与开关)
F-29 主联系人跨记录规则 本 PR:02 §4.1 screen flow;engineering §1

Generated by Claude Code

Record the decisions from the design review and planning discussion:
order-to-pay stays in ERP (ADR-0008), core-first with pack admission
criteria and a customer layer (ADR-0009), and the v0.1-v0.7 route.

- Add ADR-0008, ADR-0009 and docs/engineering (modelling rules, CI
  gates, test and versioning strategy); record verification results on
  ADR-0001/0002/0003/0006/0007.
- Rewrite design docs 01-07 for the 27-object core: delivery records
  replace receipt/inspection, ERP integration points become reserved,
  approval matrix in 03 s12 is the single source, material class A/B/C
  on srm_category, versioned route with two gates and platform
  dependency results.
- Mark packs as "design kept, not scheduled", add admission criteria and
  dependency order, drop bridges for now.
- Align ZC-02, QP-01 appendix C and GL-02 appendix A with the approval
  matrix; add position names to org.example.yaml; parameterise admission
  and change review deadlines; soe-conditional expert pool in GL-02 7.2.
- Update AGENTS.md, README and docs/README for the new scope.

Claude-Session: https://claude.ai/code/session_011FUtVGdJNj6NEXtstKJDNQ
Co-authored-by: Claude <noreply@anthropic.com>
…g phase wording

Self-review of PR #6 found the risk control matrix (ZC-03) still
scheduling controls by the old phases 一期–四期. Map each control to the
v0.1–v0.7 route, mark ERP-owned controls as not in SRM, and replace the
two remaining "第 0 期" / "二期" mentions in 01 and 04.

Claude-Session: https://claude.ai/code/session_011FUtVGdJNj6NEXtstKJDNQ
Co-authored-by: Claude <noreply@anthropic.com>
Resolve README, 02 and 07 against the 2026-10-23 route: keep the
v0.1–v0.7 table, drop the superseded 07 §1.1 split (portal at v0.2,
sourcing at v0.3), keep the v0.1 subset notes from #5 with versions
re-pointed.

Claude-Session: https://claude.ai/code/session_011FUtVGdJNj6NEXtstKJDNQ
Co-authored-by: Claude <noreply@anthropic.com>
@marchtian
marchtian merged commit 42fb7e6 into main Oct 23, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants