9.18/3

doc/openapi.yaml

@@ -84,12 +84,26 @@ paths:
                           $ref: '#/components/schemas/Account'
   /api/suppliers:
     get:
-      summary: 供应商搜索（❌ Partially Implemented）
+      summary: 供应商搜索（✅ Fully Implemented）
       parameters:
         - in: query
           name: kw
           schema:
             type: string
+        - in: query
+          name: debtOnly
+          schema:
+            type: boolean
+        - in: query
+          name: page
+          schema:
+            type: integer
+            default: 1
+        - in: query
+          name: size
+          schema:
+            type: integer
+            default: 50
       responses:
         '200':
           description: 成功
@@ -106,6 +120,32 @@ paths:
                         type: array
                         items:
                           $ref: '#/components/schemas/Supplier'
+    post:
+      summary: 新建供应商（✅ Fully Implemented）
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/CreateSupplierRequest'
+      responses:
+        '200': { description: 成功 }
+  /api/suppliers/{id}:
+    put:
+      summary: 更新供应商（✅ Fully Implemented）
+      parameters:
+        - in: path
+          name: id
+          required: true
+          schema: { type: integer, format: int64 }
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/CreateSupplierRequest'
+      responses:
+        '200': { description: 成功 }
   /api/other-transactions:
     post:
       summary: 新建其他收入/支出（❌ Partially Implemented）
@@ -735,13 +775,26 @@ components:
     Supplier:
       type: object
       properties:
-        id:
-          type: integer
-          format: int64
-        name:
-          type: string
-        mobile:
-          type: string
+        id: { type: integer, format: int64 }
+        name: { type: string }
+        contactName: { type: string, nullable: true }
+        mobile: { type: string, nullable: true }
+        phone: { type: string, nullable: true }
+        address: { type: string, nullable: true }
+        apOpening: { type: number }
+        apPayable: { type: number }
+        remark: { type: string, nullable: true }
+    CreateSupplierRequest:
+      type: object
+      properties:
+        name: { type: string }
+        contactName: { type: string, nullable: true }
+        mobile: { type: string, nullable: true }
+        phone: { type: string, nullable: true }
+        address: { type: string, nullable: true }
+        apOpening: { type: number, nullable: true }
+        apPayable: { type: number, nullable: true }
+        remark: { type: string, nullable: true }
     CreateOtherTransactionRequest:
       type: object
       properties:
@@ -860,7 +913,7 @@ components:
         mobile: { type: string }
         phone: { type: string }
         level: { type: string }
-        priceLevel: { type: string, enum: [retail, distribution, wholesale, big_client] }
+        priceLevel: { type: string, enum: [零售价, 批发价, 大单报价] }
         remark: { type: string }
         receivable: { type: number }
     CreateCustomerRequest:
@@ -868,7 +921,7 @@ components:
       properties:
         name: { type: string }
         level: { type: string, nullable: true }
-        priceLevel: { type: string, enum: [retail, distribution, wholesale, big_client] }
+        priceLevel: { type: string, enum: [零售价, 批发价, 大单报价] }
         contactName: { type: string, nullable: true }
         mobile: { type: string, nullable: true }
         phone: { type: string, nullable: true }