feat: add system operations dashboard

2026-08-19 13:51:48 +08:00
parent 8e615b895e
commit 12d78b4c86
45 changed files with 2921 additions and 48 deletions
@@ -980,6 +980,16 @@ components:
        requestId:
          type: string
      type: object
+    ApiResponseDashboardOverviewView:
+      properties:
+        data:
+          "$ref": "#/components/schemas/DashboardOverviewView"
+        meta:
+          additionalProperties: {}
+          type: object
+        requestId:
+          type: string
+      type: object
    ApiResponseWorkflowTaskDetailView:
      properties:
        data:
@@ -6482,6 +6492,163 @@ components:
        title:
          type: string
      type: object
+    DashboardOverviewView:
+      properties:
+        activities:
+          items:
+            "$ref": "#/components/schemas/WorkbenchActivityView"
+          type: array
+        currency:
+          type: string
+        geography:
+          "$ref": "#/components/schemas/DashboardGeographyView"
+        lifecycle:
+          items:
+            "$ref": "#/components/schemas/DashboardDistributionView"
+          type: array
+        metrics:
+          items:
+            "$ref": "#/components/schemas/DashboardMetricView"
+          type: array
+        refreshedAt:
+          format: date-time
+          type: string
+        risks:
+          items:
+            "$ref": "#/components/schemas/DashboardRiskView"
+          type: array
+        system:
+          "$ref": "#/components/schemas/DashboardSystemView"
+        title:
+          type: string
+        trend:
+          "$ref": "#/components/schemas/DashboardTrendView"
+      type: object
+    DashboardSystemView:
+      properties:
+        currentVersion:
+          type: string
+        overallStatus:
+          type: string
+        services:
+          items:
+            "$ref": "#/components/schemas/DashboardServiceStatusView"
+          type: array
+        uptimeSeconds:
+          format: int64
+          type: integer
+      type: object
+    DashboardServiceStatusView:
+      properties:
+        code:
+          type: string
+        detail:
+          type: string
+        label:
+          type: string
+        status:
+          type: string
+      type: object
+    DashboardMetricView:
+      properties:
+        available:
+          type: boolean
+        code:
+          type: string
+        kind:
+          type: string
+        label:
+          type: string
+        targetRoute:
+          type: string
+        unit:
+          type: string
+        value:
+          type: string
+      type: object
+    DashboardTrendView:
+      properties:
+        currency:
+          type: string
+        invoicesAvailable:
+          type: boolean
+        paymentsAvailable:
+          type: boolean
+        points:
+          items:
+            "$ref": "#/components/schemas/DashboardTrendPointView"
+          type: array
+        receiptsAvailable:
+          type: boolean
+      type: object
+    DashboardTrendPointView:
+      properties:
+        invoicedAmount:
+          type: string
+        paidAmount:
+          type: string
+        period:
+          type: string
+        receivedAmount:
+          type: string
+      type: object
+    DashboardDistributionView:
+      properties:
+        available:
+          type: boolean
+        code:
+          type: string
+        label:
+          type: string
+        targetRoute:
+          type: string
+        value:
+          format: int64
+          type: integer
+      type: object
+    DashboardRiskView:
+      properties:
+        available:
+          type: boolean
+        code:
+          type: string
+        count:
+          format: int64
+          type: integer
+        detail:
+          type: string
+        label:
+          type: string
+        severity:
+          type: string
+        targetRoute:
+          type: string
+      type: object
+    DashboardGeographyView:
+      properties:
+        available:
+          type: boolean
+        message:
+          type: string
+        regions:
+          items:
+            "$ref": "#/components/schemas/DashboardRegionView"
+          type: array
+      type: object
+    DashboardRegionView:
+      properties:
+        amount:
+          type: string
+        currency:
+          type: string
+        projectCount:
+          format: int64
+          type: integer
+        regionCode:
+          type: string
+        regionName:
+          type: string
+      type: object
    WorkbenchArchiveItemView:
      properties:
        completeness:
@@ -14157,6 +14324,33 @@ paths:
          description: OK
      tags:
      - workbench-controller
+  "/api/v1/dashboard/overview":
+    get:
+      operationId: getDashboardOverview
+      parameters:
+      - in: query
+        name: currency
+        required: false
+        schema:
+          default: CNY
+          enum:
+          - CNY
+          - USD
+          - EUR
+          - HKD
+          - JPY
+          - GBP
+          type: string
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/ApiResponseDashboardOverviewView"
+          description: OK
+      summary: 查询当前身份可见的系统仪表盘
+      tags:
+      - dashboard-controller
  "/api/v1/workbenches/finance":
    get:
      operationId: finance