From 310d931207991ef8ddd8132caacef3419add5cf8 Mon Sep 17 00:00:00 2001
From: pwklppg <123456@.com>
Date: Thu, 17 Sep 2026 09:43:54 +0800
Subject: [PATCH] fix: align onboarding OpenAPI examples and defaults

---
 docs/openapi-rc.json   |  7 +++++--
 docs/verify_openapi.py | 12 ++++++++++++
 2 files changed, 17 insertions(+), 2 deletions(-)

diff --git a/docs/openapi-rc.json b/docs/openapi-rc.json
index ee39142..cbc0f5f 100644
--- a/docs/openapi-rc.json
+++ b/docs/openapi-rc.json
@@ -7435,7 +7435,8 @@
                     "culture": "以用户价值为中心，保持透明和长期主义。",
                     "workPolicies": "弹性上班；每周一、三线下办公。",
                     "onboardingGuide": "报到当天携带身份证件，联系行政同事完成入职登记。",
-                    "updatedAt": "2026-09-17T01:33:00Z"
+                    "updatedAt": "2026-09-17T01:33:00Z",
+                    "version": 2
                   },
                   "requestId": "req-company-knowledge",
                   "timestamp": "2026-09-17T01:33:00Z"
@@ -11714,11 +11715,13 @@
           "sortOrder": {
             "type": "integer",
             "format": "int32",
+            "default": 1000,
             "maximum": 9999,
             "minimum": 0
           },
           "required": {
-            "type": "boolean"
+            "type": "boolean",
+            "default": false
           },
           "idempotencyKey": {
             "type": "string",
diff --git a/docs/verify_openapi.py b/docs/verify_openapi.py
index 05b8472..753ea25 100644
--- a/docs/verify_openapi.py
+++ b/docs/verify_openapi.py
@@ -297,6 +297,18 @@ for schema_name, expected_fields in onboarding_schema_fields.items():
         f'Onboarding schema fields missing: {schema_name}'
     )
 
+create_request = schemas['CompanyChecklistItemCreateRequest']['properties']
+assert create_request['sortOrder'].get('default') == 1000, (
+    'CompanyChecklistItemCreateRequest.sortOrder default must be 1000'
+)
+assert create_request['required'].get('default') is False, (
+    'CompanyChecklistItemCreateRequest.required default must be false'
+)
+knowledge_success_example = paths['/onboarding/company/knowledge']['put']['responses']['200']['content']['*/*']['example']
+assert knowledge_success_example['data'].get('version') == 2, (
+    'PUT /onboarding/company/knowledge 200 example data.version must be 2'
+)
+
 onboarding_error_paths = {
     9701: ('/onboarding/company/checklist-items/{itemId}', 'put', '404'),
     9702: ('/onboarding/company/checklist-items/{itemId}', 'put', '409'),