# 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 的两个默认值正确。
- 不修改 runtime API 行为。

## Evidence

```powershell
cd D:\1\zhi\zhilai
python .\docs\verify_openapi.py
```

```powershell
cd D:\1\zhi\zhilai\mydreamjob-server
mvn -Dtest=Onboarding*Test,CompanyKnowledge*Test test
```