先阅读贡献指南、项目宪法和目标
Feature 的 spec.md、clarification.md、plan.md、tasks.md、traceability.md。
- 用 Requirement ID 明确行为、边界和非目标;未决问题进入
clarification.md。 - 先更新 OpenAPI/Schema 或公共 SDK 契约,再写会因缺少行为而失败的测试。
- 运行测试确认失败原因正确,写最小实现,转绿后重构。
- 更新 Quick Start 和追踪矩阵,运行与风险匹配的完整验证。
模块不能直接访问其他模块 Repository。跨模块使用公开应用服务、接口或领域事件;新基础设施、公共破坏性 变更或微服务拆分先写 ADR。
./mvnw --batch-mode --no-transfer-progress test
./mvnw --batch-mode --no-transfer-progress -Pstarter-acceptance verify
python -m unittest tools/contract-validation/test_validate_contracts.py
python tools/contract-validation/validate_contracts.py
python -m unittest tools/docs/test_documentation_delivery.py
cd frontend && pnpm install --frozen-lockfile && pnpm test && pnpm build只改一个 Java 模块时使用 ./mvnw -pl backend -Dtest=ClassName test 或
./mvnw -pl sdk/<module> test。涉及 MySQL 的 *IntegrationTest 需要 Docker。
提交使用祈使语气并聚焦一个评审目的。PR 必须填写 Feature/Requirement/Task、用户变化、兼容性、安全、 测试证据、回滚和文档;模板见 pull_request_template.md。