You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1.2 KiB
1.2 KiB
T8 聚焦修复 1：OpenAPI 示例与默认值
Prior Failure
W3-T8.md 发现：
PUT /onboarding/company/knowledge的 200 示例缺少运行时响应必备的version。CompanyChecklistItemCreateRequest缺少运行时默认值sortOrder=1000、required=false。docs/verify_openapi.py未断言示例字段和 schema 默认值，因此未捕获上述偏差。
Objective
修正 OpenAPI 契约，并增强验证脚本，使示例、默认值与运行时 DTO 一致。
Required Changes
- 在
docs/openapi-rc.json中修正PUT /onboarding/company/knowledge的 200 示例，包含version。 - 为
CompanyChecklistItemCreateRequest.sortOrder增加默认值1000。 - 为
CompanyChecklistItemCreateRequest.required增加默认值false。 - 在
docs/verify_openapi.py中增加精确断言：- 知识 Upsert 200 示例的
data.version存在。 - 创建请求 schema 的两个默认值正确。
- 知识 Upsert 200 示例的
- 不修改 runtime API 行为。
Evidence
cd D:\1\zhi\zhilai
python .\docs\verify_openapi.py
cd D:\1\zhi\zhilai\mydreamjob-server
mvn -Dtest=Onboarding*Test,CompanyKnowledge*Test test