@cpzxrobot/sdk 1.2.61 → 1.2.63

package/construction_gateway.ts

@@ -0,0 +1,51 @@
+import { Cpzxrobot } from "./types";
+
+export class ConstructionGateway extends Object {
+  context: Cpzxrobot;
+
+  constructor(context: Cpzxrobot) {
+    super();
+    this.context = context;
+  }
+
+  /**
+   * 创建工程
+   * @param args 创建参数
+   * @returns Promise
+   */
+  add(args: {
+    customerId: number;
+    name: string;
+    groupId: number;
+  }) {
+    return this.context.ready.then((axios) => {
+      return axios.post(`/api/v2/coremde-sale/construction/create`, args);
+    });
+  }
+
+  /**
+   * 分页获取工程列表
+   * @param args 查询参数
+   * @returns Promise
+   */
+  list(args: {
+    pageNo: number;
+    pageSize: number;
+    createTimeStart?: string;
+    createTimeEnd?: string;
+    companyId?: number;
+    customerId?: number;
+  }) {
+    return this.context.ready.then((axios) => {
+      return axios.post(`/api/v2/coremde-sale/construction/list`, args);
+    });
+  }
+
+  listAll(args: {
+    companyId?: number;
+  }) {
+    return this.context.ready.then((axios) => {
+      return axios.post(`/api/v2/coremde-sale/construction/list`, args);
+    });
+  }
+}

package/contract_gateway.readme.md

@@ -0,0 +1,193 @@
+# ContractGateway 类文档
+
+## 概述
+ContractGateway 是合同管理系统的核心网关类，提供了与合同相关的各种API接口封装。
+
+## 主要功能
+
+### 基础合同操作
+- `list()`: 获取合同列表
+- `get()`: 获取单个合同详情
+- `add()`: 创建新合同
+- `export()`: 导出合同
+- `approval()`: 合同审批
+- `restart()`: 重新提交合同
+- `types()`: 获取合同类型
+- `confirm()`: 确认合同细节
+
+### 子功能模块
+- `project`: 项目合同相关操作
+  - `addContract()`: 添加项目合同
+  - `addPayment()`: 添加项目回款
+  - `listPayments()`: 获取项目回款列表
+- `product`: 产品合同相关操作
+  - `addContract()`: 添加产品合同
+  - `addPayment()`: 添加产品回款
+  - `listPayments()`: 获取产品回款列表
+
+## 详细接口说明
+
+### 合同基础操作
+```javascript
+// 获取合同列表
+cpzxrobot().contract.list({
+  factoryId: number,
+  page?: number,
+  size?: number
+})
+
+// 获取合同详情
+cpzxrobot().contract.get(contractId)
+
+// 添加合同
+cpzxrobot().contract.add({
+  projectId: number,
+  contractType: number,
+  amount: number,
+  startDate: string, // YYYY-MM-DD
+  endDate: string,   // YYYY-MM-DD
+  content: string
+})
+
+// 导出合同
+cpzxrobot().contract.export({
+  contractId: number,
+  fileName?: string
+})
+```
+
+### 合同分组接口
+```javascript
+// 项目相关合同接口
+cpzxrobot().contract.project = {
+  // 添加项目合同 (替代原addForProject)
+  addContract: (args: any) => Promise<any>
+  
+  // 添加项目回款信息
+  addPayment: (args: {
+    createTime: string;
+    createUserId: number;
+    updateTime: string;
+    updateUserId: number;
+    companyId: number;
+    contractId: number;
+    receivedPayments: number;
+    receivedPerson: string;
+    receiveDate: string;
+    remark: string;
+  }) => Promise<any>
+  
+  // 查看项目回款记录  
+  listPayments: (id: number) => Promise<any>
+}
+
+// 产品相关合同接口  
+cpzxrobot().contract.product = {
+  // 添加产品合同 (替代原addForProduct)
+  addContract: (args: any) => Promise<any>
+  
+  // 添加产品回款信息
+  addPayment: (args: {
+    createTime: string;
+    createUserId: number;
+    updateTime: string;
+    updateUserId: number;
+    companyId: number;
+    contractId: number;
+    receivedPayments: number;
+    receivedPerson: string;
+    receiveDate: string;
+    remark: string;
+  }) => Promise<any>
+  
+  // 查看产品回款记录
+  listPayments: (id: number) => Promise<any>
+}
+```
+
+### 合同审批流程
+```javascript
+// 提交合同审批
+cpzxrobot().contract.approval({
+  contractId: number,
+  opinion: string
+})
+
+// 重新提交审批
+cpzxrobot().contract.restart({
+  contractId: number,
+  reason: string
+})
+
+// 获取合同类型列表
+cpzxrobot().contract.types(factoryId)
+```
+
+### 合同确认接口
+```javascript
+/**
+ * 商务部确认合同细节
+ * @param args 合同确认参数
+ * @returns Promise
+ */
+confirm(args: {
+  contractAmount: number;
+  contractCost: number;
+  contractGrossProfit: number;
+  engineeringId: number;
+  notes: string;
+  projectId: number;
+  projectStageRecordId: number;
+  projectStageId: number;
+  groupId: number;
+  projectQuotationDetailIds: number[];
+}) {
+  return this.context.ready.then((axios) => {
+    return axios.post(`/api/v2/coremde-sale/contract/confirm`, args);
+  });
+}
+```
+
+## 使用示例
+
+```typescript
+// 初始化
+const contractGateway = new ContractGateway(context);
+
+// 获取合同列表
+contractGateway.list({
+  pageNo: 1,
+  pageSize: 10,
+  name: '测试合同',
+  companyId: 123
+}).then(response => {
+  console.log(response.data);
+});
+
+// 确认合同细节
+contractGateway.confirm({
+  contractAmount: 100000,
+  contractCost: 80000,
+  contractGrossProfit: 20000,
+  engineeringId: 123,
+  notes: "合同细节确认",
+  projectId: 456,
+  projectStageRecordId: 789,
+  projectStageId: 101,
+  groupId: 1,
+  projectQuotationDetailIds: [1, 2, 3]
+});
+
+// 添加项目合同
+contractGateway.project.addContract({
+  projectId: 123,
+  contractType: 1,
+  amount: 50000
+});
+```
+
+## 注意事项
+- 所有方法返回Promise对象
+- 需要先初始化context对象
+- 金额参数单位为元
+- 日期参数格式为YYYY-MM-DD

package/contract_gateway.ts

@@ -60,6 +60,28 @@ export class ContractGateway extends Object {
     });
   }
 
+  /**
+   * 商务部确认合同细节
+   * @param args 合同确认参数
+   * @returns Promise
+   */
+  confirm(args: {
+    contractAmount: number;
+    contractCost: number;
+    contractGrossProfit: number;
+    engineeringId: number;
+    notes: string;
+    projectId: number;
+    projectStageRecordId: number;
+    projectStageId: number;
+    groupId: number;
+    projectQuotationDetailIds: number[];
+  }) {
+    return this.context.ready.then((axios) => {
+      return axios.post(`/api/v2/coremde-sale/contract/confirm`, args);
+    });
+  }
+
   get project() {
     return {
       addContract: (args: any) => {

package/dist/construction_gateway.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConstructionGateway = void 0;
+class ConstructionGateway extends Object {
+    constructor(context) {
+        super();
+        this.context = context;
+    }
+    /**
+     * 创建工程
+     * @param args 创建参数
+     * @returns Promise
+     */
+    add(args) {
+        return this.context.ready.then((axios) => {
+            return axios.post(`/api/v2/coremde-sale/construction/create`, args);
+        });
+    }
+    /**
+     * 分页获取工程列表
+     * @param args 查询参数
+     * @returns Promise
+     */
+    list(args) {
+        return this.context.ready.then((axios) => {
+            return axios.post(`/api/v2/coremde-sale/construction/list`, args);
+        });
+    }
+    listAll(args) {
+        return this.context.ready.then((axios) => {
+            return axios.post(`/api/v2/coremde-sale/construction/list`, args);
+        });
+    }
+}
+exports.ConstructionGateway = ConstructionGateway;

package/dist/contract_gateway.js

@@ -45,6 +45,16 @@ class ContractGateway extends Object {
             return axios.get(`/api/v2/coremde-sale/contract/types`);
         });
     }
+    /**
+     * 商务部确认合同细节
+     * @param args 合同确认参数
+     * @returns Promise
+     */
+    confirm(args) {
+        return this.context.ready.then((axios) => {
+            return axios.post(`/api/v2/coremde-sale/contract/confirm`, args);
+        });
+    }
     get project() {
         return {
             addContract: (args) => {

package/dist/energy_gateway.js

@@ -20,7 +20,7 @@ class EnergyGateway extends Object {
      * @param type 统计类型
      * @param factoryId 工厂ID
      */
-    async stat(type, factoryId = null) {
+    async stat(type, factoryId = undefined) {
         if (!factoryId) {
             var factory = await this.context.user.getSelectedFarm();
             factoryId = factory.id;

package/dist/index.js

@@ -46,6 +46,7 @@ const logs_gateway_1 = require("./logs_gateway");
 const robot_gateway_1 = require("./robot_gateway");
 const quotation_gateway_1 = require("./quotation_gateway");
 const ai_gateway_1 = require("./ai_gateway");
+const construction_gateway_1 = require("./construction_gateway");
 class Cpzxrobot {
     constructor(appCode) {
         this.pigfarm = new pigfarm_gateway_1.PigfarmGateway(this);
@@ -65,6 +66,7 @@ class Cpzxrobot {
         this.robot = new robot_gateway_1.RobotGateway(this);
         this.quotation = new quotation_gateway_1.QuotationGateway(this);
         this.ai = new ai_gateway_1.AiGateway(this);
+        this.construction = new construction_gateway_1.ConstructionGateway(this);
         //获取当前浏览器的域名
         this.ready = new Promise((resolve, reject) => {
             this.resolveReady = resolve;
@@ -106,7 +108,7 @@ class Cpzxrobot {
             };
             const instance = {
                 get: async (url, config) => {
-                    if (config.params) {
+                    if (config && config.params) {
                         url += "?" + new URLSearchParams(config.params).toString();
                         delete config.params;
                     }

package/dist/project_gateway.js

@@ -161,9 +161,10 @@ class ProjectGateway extends Object {
                     return axios.get(`/api/v2/coremde-sale/project/inquiry/get?id=${id}`);
                 });
             },
+            //申请报价单
             add: (args) => {
                 return this.context.ready.then((axios) => {
-                    return axios.post(`/api/v2/coremde-sale/project/inquiry/add`, args);
+                    return axios.post(`/api/v2/coremde-sale/project/inquiry/apply`, args);
                 });
             },
             //重新提交询价审核流程
@@ -193,6 +194,16 @@ class ProjectGateway extends Object {
                         params: args
                     });
                 });
+            },
+            /**
+             * 商务部响应报价申请，制作报价单
+             * @param args 报价单参数
+             * @returns Promise
+             */
+            answer: (args) => {
+                return this.context.ready.then((axios) => {
+                    return axios.post(`/api/v2/coremde-sale/project/inquiry/answer`, args);
+                });
             }
         };
     }
@@ -239,6 +250,25 @@ class ProjectGateway extends Object {
                         params: { groupId }
                     });
                 });
+            },
+            details: (projectId) => {
+                return this.context.ready.then((axios) => {
+                    return axios.get(`/api/v2/coremde-sale/project/stage/details?projectId=${projectId}`);
+                });
+            }
+        };
+    }
+    get bom() {
+        return {
+            /**
+             * 技术部制作BOM单
+             * @param args BOM配置参数
+             * @returns Promise
+             */
+            add: (args) => {
+                return this.context.ready.then((axios) => {
+                    return axios.post(`/api/v2/coremde-sale/project/bom-config/create`, args);
+                });
             }
         };
     }

package/energy_gateway.ts

@@ -22,7 +22,7 @@ export class EnergyGateway extends Object {
    * @param type 统计类型
    * @param factoryId 工厂ID
    */
-  async stat(type: string, factoryId: number | null = null): Promise<any> {
+  async stat(type: string, factoryId: number | undefined = undefined): Promise<any> {
     if (!factoryId) {
       var factory = await this.context.user.getSelectedFarm();
       factoryId = factory.id;

package/index.ts

@@ -21,6 +21,7 @@ import { LogsGateway } from "./logs_gateway";
 import { RobotGateway } from "./robot_gateway";
 import { QuotationGateway } from "./quotation_gateway";
 import { AiGateway } from "./ai_gateway";
+import { ConstructionGateway } from "./construction_gateway"; 
 
 export class Cpzxrobot {
   private static factorySelectorLoaded = false;
@@ -74,6 +75,7 @@ export class Cpzxrobot {
   robot: RobotGateway = new RobotGateway(this);
   quotation: QuotationGateway = new QuotationGateway(this);
   ai: AiGateway = new AiGateway(this);
+  construction: ConstructionGateway = new ConstructionGateway(this);
 
 
   constructor(appCode: string) {
@@ -125,7 +127,7 @@ export class Cpzxrobot {
 
       const instance = {
         get: async (url: string, config?: any) => {
-          if (config.params) {
+          if (config && config.params) {
             url += "?" + new URLSearchParams(config.params).toString();
             delete config.params;
           }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cpzxrobot/sdk",
-  "version": "1.2.61",
+  "version": "1.2.63",
   "description": "提供给上海正芯数智APP第三方H5应用使用的SDK",
   "main": "dist/index.js",
   "scripts": {

package/project_gateway.readme.md

@@ -0,0 +1,86 @@
+# ProjectGateway 类文档
+
+## 概述
+ProjectGateway 是项目管理系统的核心网关类，提供了与项目相关的各种API接口封装。
+
+## 主要功能模块
+
+### 基础项目管理
+- `list()`: 获取项目列表
+- `get()`: 获取单个项目详情
+- `add()`: 创建新项目
+- `update()`: 更新项目信息
+- `delete()`: 删除项目
+
+### 子功能模块
+- `feedback`: 项目反馈管理
+- `inquiry`: 项目询盘管理
+  - `answer()`: 商务部响应报价申请
+- `document`: 项目文档管理
+- `material`: 项目物料管理
+- `constructionTeam`: 施工队管理
+- `codePrefix`: 项目编码前缀管理
+- `stage`: 项目阶段管理
+- `bom`: BOM单管理
+- `plan`: 项目计划管理
+
+## 详细接口说明
+
+### inquiry.answer() 方法
+```typescript
+/**
+ * 商务部响应报价申请，制作报价单
+ * @param args 报价单参数
+ * @returns Promise
+ * 
+ * 参数说明:
+ * - projectId: 项目ID
+ * - projectStageRecordId: 项目阶段记录ID  
+ * - quotationContent: 报价内容
+ * - amount: 金额
+ * - quotationCost: 报价成本
+ * - quotationGrossProfit: 报价毛利
+ * - tax: 税额
+ * - taxRatio: 税率
+ * - validDay: 有效期天数
+ * - projectStageId: 项目阶段ID
+ * - groupId: 组ID
+ * - materialInfo: 材料信息
+ * 
+ * 使用示例:
+ * await projectGateway.inquiry.answer({
+ *   projectId: 123,
+ *   projectStageRecordId: 456,
+ *   quotationContent: "详细报价内容",
+ *   amount: 10000,
+ *   quotationCost: 8000,
+ *   quotationGrossProfit: 2000,
+ *   tax: 200,
+ *   taxRatio: 0.02,
+ *   validDay: 30,
+ *   projectStageId: 789, 
+ *   groupId: 1,
+ *   materialInfo: "钢材10吨"
+ * });
+ */
+answer: (args: {
+  projectId: number;
+  projectStageRecordId: number;
+  quotationContent: string;
+  amount: number;
+  quotationCost: number;
+  quotationGrossProfit: number;
+  tax: number;
+  taxRatio: number;
+  validDay: number;
+  projectStageId: number;
+  groupId: number;
+  materialInfo: string;
+}) => Promise<any>;
+```
+
+## 注意事项
+- 所有方法返回Promise对象
+- 需要先初始化context对象
+- 金额参数单位为元
+- 日期参数格式为YYYY-MM-DD

package/project_gateway.ts

@@ -15,6 +15,9 @@ export class ProjectGateway extends Object {
     companyId: number;
     projectProgress?: string;
     customerId?: number;
+    groupId?: string;
+    userId?: number;
+    status?: string;
   }) {
     return this.context.ready.then((axios) => {
       return axios.post(`/api/v2/coremde-sale/project/list`, args);
@@ -205,9 +208,10 @@ export class ProjectGateway extends Object {
           return axios.get(`/api/v2/coremde-sale/project/inquiry/get?id=${id}`);
         });
       },
+      //申请报价单
       add: (args: any) => {
         return this.context.ready.then((axios) => {
-          return axios.post(`/api/v2/coremde-sale/project/inquiry/add`, args);
+          return axios.post(`/api/v2/coremde-sale/project/inquiry/apply`, args);
         });
       },
       //重新提交询价审核流程
@@ -237,6 +241,29 @@ export class ProjectGateway extends Object {
             params: args
           });
         });
+      },
+      /**
+       * 商务部响应报价申请，制作报价单
+       * @param args 报价单参数
+       * @returns Promise
+       */
+      answer: (args: {
+        projectId: number;
+        projectStageRecordId: number;
+        quotationContent: string;
+        amount: number;
+        quotationCost: number;
+        quotationGrossProfit: number;
+        tax: number;
+        taxRatio: number;
+        validDay: number;
+        projectStageId: number;
+        groupId: number;
+        materialInfo: string;
+      }) => {
+        return this.context.ready.then((axios) => {
+          return axios.post(`/api/v2/coremde-sale/project/inquiry/answer`, args);
+        });
       }
     };
   }
@@ -291,6 +318,32 @@ export class ProjectGateway extends Object {
             params: { groupId }
           });
         });
+      },
+      details: (projectId: number) => {
+        return this.context.ready.then((axios) => {
+          return axios.get(`/api/v2/coremde-sale/project/stage/details?projectId=${projectId}`);
+        });
+      }
+    }
+  }
+
+  get bom() {
+    return {
+      /**
+       * 技术部制作BOM单
+       * @param args BOM配置参数
+       * @returns Promise
+       */
+      add: (args: {
+        projectId: number;
+        projectStageRecordId: number;
+        projectStageId: number;
+        materialInfo: string;
+        groupId: number;
+      }) => {
+        return this.context.ready.then((axios) => {
+          return axios.post(`/api/v2/coremde-sale/project/bom-config/create`, args);
+        });
       }
     };
   }

package/readme.md

@@ -474,6 +474,7 @@ cpzxrobot().user.position.team()   // 获取下属团队
 ```
 
 ### 项目管理
+- [ProjectGateway 类详细文档](./project_gateway.readme.md)
 #### 项目基础信息
 ```javascript
 // 获取项目列表
@@ -741,144 +742,7 @@ cpzxrobot().quotation.transform(id: number)
 ```
 
 ### 合同管理
-#### 合同基础操作
-```javascript
-// 获取合同列表
-cpzxrobot().contract.list({
-  factoryId: number,
-  page?: number,
-  size?: number
-})
-
-// 获取合同详情
-cpzxrobot().contract.get(contractId)
-
-// 添加合同
-cpzxrobot().contract.add({
-  projectId: number,
-  contractType: number,
-  amount: number,
-  startDate: string, // YYYY-MM-DD
-  endDate: string,   // YYYY-MM-DD
-  content: string
-})
-
-// 导出合同
-cpzxrobot().contract.export({
-  contractId: number,
-  fileName?: string
-})
-```
-
-#### 合同分组接口
-```javascript
-// 项目相关合同接口
-cpzxrobot().contract.project = {
-  // 添加项目合同 (替代原addForProject)
-  addContract: (args: any) => Promise<any>
-  
-  // 添加项目回款信息
-  addPayment: (args: {
-    createTime: string;
-    createUserId: number;
-    updateTime: string;
-    updateUserId: number;
-    companyId: number;
-    contractId: number;
-    receivedPayments: number;
-    receivedPerson: string;
-    receiveDate: string;
-    remark: string;
-  }) => Promise<any>
-  
-  // 查看项目回款记录  
-  listPayments: (id: number) => Promise<any>
-}
-
-// 产品相关合同接口  
-cpzxrobot().contract.product = {
-  // 添加产品合同 (替代原addForProduct)
-  addContract: (args: any) => Promise<any>
-  
-  // 添加产品回款信息
-  addPayment: (args: {
-    createTime: string;
-    createUserId: number;
-    updateTime: string;
-    updateUserId: number;
-    companyId: number;
-    contractId: number;
-    receivedPayments: number;
-    receivedPerson: string;
-    receiveDate: string;
-    remark: string;
-  }) => Promise<any>
-  
-  // 查看产品回款记录
-  listPayments: (id: number) => Promise<any>
-}
-```
-
-#### 合同审批流程
-```javascript
-// 提交合同审批
-cpzxrobot().contract.approval({
-  contractId: number,
-  opinion: string
-})
-
-// 重新提交审批
-cpzxrobot().contract.restart({
-  contractId: number,
-  reason: string
-})
-
-// 获取合同类型列表
-cpzxrobot().contract.types(factoryId)
-```
-
-#### Deprecated 接口
-```javascript
-// 已废弃 - 请使用contract.project.addContract
-cpzxrobot().contract.addForProject(args: any)
-
-// 已废弃 - 请使用contract.product.addContract  
-cpzxrobot().contract.addForProduct(args: any)
-```
-
-#### 合同关联信息
-```javascript
-// 获取客户列表
-cpzxrobot().customer.list({
-  factoryId: number,
-  page?: number,
-  size?: number
-})
-
-// 获取客户详情
-cpzxrobot().customer.get(customerId)
-
-// 添加客户
-cpzxrobot().customer.add({
-  name: string,
-  type: number,
-  contact: string,
-  mobile: string,
-  factoryId: number
-})
-
-// 客户拜访记录
-cpzxrobot().customer.visit.add({
-  customerId: number,
-  content: string
-})
-
-// 获取客户拜访列表
-cpzxrobot().customer.visit.list({
-  customerId: number,
-  page?: number
-})
-```
+- [ContractGateway 类详细文档](./contract_gateway.readme.md) - 包含所有合同管理接口和使用方法
 
 #### 公司管理
 ```javascript

package/types.d.ts

@@ -19,6 +19,7 @@ import { QuotationGateway } from "./quotation_gateway";
 import { AiGateway } from "./ai_gateway";
 import { EnergyGateway } from "./energy_gateway";
 import { type ElectricMeterRate } from "./energy_types/electric_meter_gateway";
+import { ConstructionGateway } from "./construction_gateway";
 
 type Device = {
   id: number;
@@ -347,6 +348,7 @@ class Cpzxrobot {
   quotation: QuotationGateway;
   ai: AiGateway;
   energy: EnergyGateway;
+  construction: ConstructionGateway;
   dict: (key: string) => any;
   _getSelectedFarmFromMiniApp: () => Promise<Factory>;
   _getSelectedUnitFromMiniApp: () => Promise<Unit>;