refactor: optimize API, harden client, fix docs/CI issues

.github/workflows/sync-docs.yml

@@ -15,14 +15,17 @@ on:
       - "apps/docs/scripts/**"
       - ".github/workflows/sync-docs.yml"
 
+# Least privilege by default; only the auto-commit job elevates to write.
 permissions:
-  contents: write
+  contents: read
 
 jobs:
   pr-check:
     name: Verify OpenAPI docs are up to date
     if: github.event_name == 'pull_request'
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
     steps:
       - uses: actions/checkout@v4
 
@@ -46,6 +49,12 @@ jobs:
     name: Auto-commit OpenAPI docs on main
     if: github.event_name == 'push' && github.ref == 'refs/heads/main'
     runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    # Serialize auto-commits so concurrent merges to main can't race on the push.
+    concurrency:
+      group: sync-docs-main
+      cancel-in-progress: false
     steps:
       - uses: actions/checkout@v4
         with:

.gitignore

@@ -8,3 +8,10 @@ __pycache__/
 .env
 .env.local
 .DS_Store
+
+# Editor state
+.idea/
+.vscode/
+
+# Local Comcigan debug dump (not a source artifact)
+timetable.json

apps/docs/app/docs/[[...slug]]/page.tsx

@@ -29,7 +29,7 @@ export default async function Page(props: PageProps<'/docs/[[...slug]]'>) {
         <MarkdownCopyButton markdownUrl={markdownUrl} />
         <ViewOptionsPopover
           markdownUrl={markdownUrl}
-          githubUrl={`https://github.com/${gitConfig.user}/${gitConfig.repo}/blob/${gitConfig.branch}/content/docs/${page.path}`}
+          githubUrl={`https://github.com/${gitConfig.user}/${gitConfig.repo}/blob/${gitConfig.branch}/apps/docs/content/docs/${page.path}`}
         />
       </div>
       <DocsBody>

apps/docs/openapi/openapi.json

@@ -701,6 +701,12 @@
                       },
                       {
                         "type": "boolean"
+                      },
+                      {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
                       }
                     ]
                   }
@@ -712,15 +718,14 @@
         "$id": "#/components/schemas/ApiError"
       },
       "SchoolInfoList": {
-        "minItems": 1,
         "examples": [
           [
             {
               "ATPT_OFCDC_SC_CODE": "B10",
               "ATPT_OFCDC_SC_NM": "서울특별시교육청",
               "SD_SCHUL_CODE": "7010208",
-              "SCHUL_NM": "목운중학교",
-              "ENG_SCHUL_NM": "Yangchung High School",
+              "SCHUL_NM": "양정고등학교",
+              "ENG_SCHUL_NM": "Yangjeong High School",
               "SCHUL_KND_SC_NM": "고등학교",
               "LCTN_SC_NM": "서울특별시",
               "JU_ORG_NM": "서울특별시교육청",
@@ -796,14 +801,14 @@
             "SCHUL_NM": {
               "description": "School name",
               "examples": [
-                "목운중학교"
+                "양정고등학교"
               ],
               "type": "string"
             },
             "ENG_SCHUL_NM": {
               "description": "English school name",
               "examples": [
-                "Yangchung High School"
+                "Yangjeong High School"
               ],
               "type": "string"
             },
@@ -972,7 +977,6 @@
         ],
         "properties": {
           "day_time": {
-            "minItems": 1,
             "examples": [
               [
                 "09:00",
@@ -989,7 +993,6 @@
             }
           },
           "timetable": {
-            "minItems": 1,
             "examples": [
               [
                 [
@@ -1123,7 +1126,6 @@
         "$id": "#/components/schemas/TimetableResponse"
       },
       "MealList": {
-        "minItems": 1,
         "examples": [
           [
             {
@@ -1276,7 +1278,6 @@
         "$id": "#/components/schemas/MealList"
       },
       "ScheduleList": {
-        "minItems": 1,
         "examples": [
           [
             {