fix(api): 补齐 bat-api 控制与后端 RPC

internal/api/openapi.go

@@ -9,7 +9,7 @@ const openAPISpecYAML = `openapi: 3.0.3
 info:
   title: BlueArchive Toolkit bat-api
   version: 0.1.0
-  description: Resource bootstrap and read-only distribution API.
+  description: Resource bootstrap, read-only distribution, and authenticated Rust bat control proxy.
 servers:
   - url: http://127.0.0.1:18080
 security:
@@ -111,10 +111,43 @@ paths:
           description: OpenAPI YAML.
   /admin/:
     get:
-      summary: Reserved admin panel entry
+      summary: Admin control entry
       responses:
         "200":
-          description: Admin panel placeholder and links.
+          description: Admin links and allowlisted control actions.
+  /admin/control/{action}:
+    post:
+      summary: Forward an allowlisted control action to Rust bat
+      parameters:
+        - name: action
+          in: path
+          required: true
+          schema:
+            type: string
+            enum: [reload, refresh, restart, sync, verify, repair, catalog-refresh]
+      requestBody:
+        required: false
+        content:
+          application/json:
+            schema:
+              type: object
+              additionalProperties: false
+              properties:
+                force:
+                  type: boolean
+      responses:
+        "202":
+          description: Rust bat accepted the control request.
+        "400":
+          description: Invalid action parameters.
+        "401":
+          description: Missing or invalid admin token.
+        "403":
+          description: Control is not exposed or no admin token is configured.
+        "501":
+          description: Rust bat does not implement the requested control action.
+        "502":
+          description: Rust bat rejected the control request.
   /prod-clientpatch.bluearchiveyostar.com/{path}:
     get:
       summary: CDN-shaped resource bytes