1.6 KiB
1.6 KiB
Contributing
欢迎提交问题、补丁和设计建议。这个仓库现在是独立服务仓库，协作时默认按服务代码库的标准来处理，不再依赖 monorepo 语境。
提交前要求
在提交 PR 前，至少完成以下验证：
go test ./... -count=1
go test -race ./...
go vet ./...
如果改动涉及生产门禁、回滚、平台适配或配置契约，还要补跑对应脚本或最小验证：
bash -n scripts/verify_preprod_gate_b.sh
bash -n scripts/verify_gate_c_rollback.sh
变更原则
- 保持改动最小、局部、可验证。
- 不要把
Sub2API/NewAPI的边缘适配逻辑渗透到dialog、ticket、audit主链内部。 - 不要在没有证据的情况下把“测试通过”写成“可生产上线”。
- 修改配置契约时，同步更新文档和测试状态文件。
推荐提交流程
- 先补失败测试。
- 再实现最小改动。
- 再跑全量测试和相关脚本。
- 最后提交 Conventional Commit。
提交信息
建议格式：
feat(scope): summary
fix(scope): summary
docs(scope): summary
test(scope): summary
refactor(scope): summary
chore(scope): summary
代码评审关注点
- 配置项是否与
docs/CONFIG_CONTRACT_BASELINE.md一致 - 新接口是否有明确的错误码和测试
- 平台适配是否仍然只停留在边缘层
- callback / outbox / dead letter 是否可追踪、可重放