优化

src/custom/restcontroller/crm/agent/customer/Customer.java

@@ -5,6 +5,7 @@ import com.alibaba.fastjson2.JSONObject;
 import common.Controller;
 import common.YosException;
 import common.annotation.API;
+import common.annotation.Param;
 import common.data.*;
 import restcontroller.R;
 
@@ -31,7 +32,8 @@ public class Customer extends Controller {
         return getSucReturnObject().setData(rows).toString();
     }
 
-    @API(title = "美大CRM_经销商_客户档案详情查询", apiversion = R.ID2026030916272601.v1.class)
+    @API(title = "美大CRM_经销商_客户档案详情查询", apiversion = R.ID2026030916272601.v1.class,
+            params = {@Param(paramname = "sa_customersid", fieldtype = FieldType.BigInt, remarks = "客户ID", isrequired = true)})
     public String sa_customers_querymain() throws YosException {
         long sa_customersid = content.getLong("sa_customersid");
         QuerySQL querySQL = SQLFactory.createQuerySQL(this, "sa_customers", "*").setTableAlias("t1");
@@ -49,7 +51,24 @@ public class Customer extends Controller {
         return getSucReturnObject().setData(rows).toString();
     }
 
-    @API(title = "美大CRM_经销商_客户档案新增修改", apiversion = R.ID2026030916370001.v1.class)
+    @API(title = "美大CRM_经销商_客户档案新增修改", apiversion = R.ID2026030916370001.v1.class,
+            params = {
+                    @Param(paramname = "sa_customersid", fieldtype = FieldType.BigInt, remarks = "客户ID"),
+                    @Param(paramname = "name", fieldtype = FieldType.Varchar, remarks = "客户名称"),
+                    @Param(paramname = "phonenumber", fieldtype = FieldType.Varchar, remarks = "联系电话"),
+                    @Param(paramname = "sex", fieldtype = FieldType.Varchar, remarks = "性别"),
+                    @Param(paramname = "community", fieldtype = FieldType.Varchar, remarks = "小区及门牌号"),
+                    @Param(paramname = "address", fieldtype = FieldType.Varchar, remarks = "详细地址"),
+                    @Param(paramname = "province", fieldtype = FieldType.Varchar, remarks = "省份"),
+                    @Param(paramname = "city", fieldtype = FieldType.Varchar, remarks = "城市"),
+                    @Param(paramname = "county", fieldtype = FieldType.Varchar, remarks = "区县"),
+                    @Param(paramname = "ext_no", fieldtype = FieldType.Varchar, remarks = "外部订单号"),
+                    @Param(paramname = "birthday", fieldtype = FieldType.Date, remarks = "生日"),
+                    @Param(paramname = "source", fieldtype = FieldType.Varchar, remarks = "客户来源"),
+                    @Param(paramname = "remarks", fieldtype = FieldType.Varchar, remarks = "备注"),
+                    @Param(paramname = "sat_orderclueid", fieldtype = FieldType.BigInt, remarks = "关联数据id")
+            }
+    )
     public String sa_customers_save() throws YosException {
         long sa_customersid = content.getLongValue("sa_customersid");
         String name = content.getStringValue("name");// 客户名称
@@ -131,7 +150,8 @@ public class Customer extends Controller {
         return getSucReturnObject().toString();
     }
 
-    @API(title = "美大CRM_经销商_客户档案订单列表查询", apiversion = R.ID2026030916334801.v1.class)
+    @API(title = "美大CRM_经销商_客户档案订单列表查询", apiversion = R.ID2026030916334801.v1.class,
+            params = {@Param(paramname = "sa_customersid", fieldtype = FieldType.BigInt, remarks = "客户ID", isrequired = true)})
     public String sa_custorder_querylist() throws YosException {
         long sa_customersid = content.getLong("sa_customersid");
         QuerySQL querySQL = SQLFactory.createQuerySQL(this, "sa_custorder");
@@ -141,7 +161,8 @@ public class Customer extends Controller {
         return getSucReturnObject().setData(rows).toString();
     }
 
-    @API(title = "美大CRM_经销商_客户档案订单列表商品明细查询", apiversion = R.ID2026030916340501.v1.class)
+    @API(title = "美大CRM_经销商_客户档案订单列表商品明细查询", apiversion = R.ID2026030916340501.v1.class,
+            params = {@Param(paramname = "sa_custorderid", fieldtype = FieldType.BigInt, remarks = "订单ID", isrequired = true)})
     public String sa_custorderitems_querylist() throws YosException {
         long sa_custorderid = content.getLong("sa_custorderid");
         QuerySQL querySQL = SQLFactory.createQuerySQL(this, "sa_custorderitems");
@@ -151,7 +172,8 @@ public class Customer extends Controller {
         return getSucReturnObject().setData(rows).toString();
     }
 
-    @API(title = "美大CRM_经销商_客户档案服务申请单查询", apiversion = R.ID2026030916342701.v1.class)
+    @API(title = "美大CRM_经销商_客户档案服务申请单查询", apiversion = R.ID2026030916342701.v1.class,
+            params = {@Param(paramname = "sa_customersid", fieldtype = FieldType.BigInt, remarks = "客户ID", isrequired = true)})
     public String sa_serviceorder_querylist() throws YosException {
         long sa_customersid = content.getLong("sa_customersid");
         QuerySQL querySQL = SQLFactory.createQuerySQL(this, "sa_serviceorder");
@@ -160,7 +182,8 @@ public class Customer extends Controller {
         return getSucReturnObject().setData(rows).toString();
     }
 
-    @API(title = "美大CRM_经销商_客户档案服务工单查询", apiversion = R.ID2026030916343601.v1.class)
+    @API(title = "美大CRM_经销商_客户档案服务工单查询", apiversion = R.ID2026030916343601.v1.class,
+            params = {@Param(paramname = "sa_serviceorderid", fieldtype = FieldType.BigInt, remarks = "服务申请单ID", isrequired = true)})
     public String sa_workorder_querylist() throws YosException {
         long sa_serviceorderid = content.getLong("sa_serviceorderid");
         QuerySQL querySQL = SQLFactory.createQuerySQL(this, "sa_workorder");
@@ -169,7 +192,8 @@ public class Customer extends Controller {
         return getSucReturnObject().setData(rows).toString();
     }
 
-    @API(title = "美大CRM_经销商_客户档案保修卡列表查询", apiversion = R.ID2026030916344401.v1.class)
+    @API(title = "美大CRM_经销商_客户档案保修卡列表查询", apiversion = R.ID2026030916344401.v1.class,
+            params = {@Param(paramname = "sa_customersid", fieldtype = FieldType.BigInt, remarks = "客户ID", isrequired = true)})
     public String sa_warrantycard_querylist() throws YosException {
         long sa_customersid = content.getLong("sa_customersid");
         QuerySQL querySQL = SQLFactory.createQuerySQL(this, "sa_warrantycard").setTableAlias("t1");
@@ -180,7 +204,8 @@ public class Customer extends Controller {
         return getSucReturnObject().setData(rows).toString();
     }
 
-    @API(title = "美大CRM_经销商_客户档案删除", apiversion = R.ID2026031009560201.v1.class)
+    @API(title = "美大CRM_经销商_客户档案删除", apiversion = R.ID2026031009560201.v1.class,
+            params = {@Param(paramname = "sa_customersids", fieldtype = FieldType.JSON, remarks = "客户ID,格式[1,2]", isrequired = true)})
     public String sa_customers_delete() throws YosException {
         JSONArray sa_customersids = content.getJSONArray("sa_customersids");
         for (int i = 0; i < sa_customersids.size(); i++) {
@@ -195,7 +220,9 @@ public class Customer extends Controller {
         return getSucReturnObject().toString();
     }
 
-    @API(title = "美大CRM_经销商_客户档案无效设置", apiversion = R.ID2026031116475801.v1.class)
+    @API(title = "美大CRM_经销商_客户档案无效设置", apiversion = R.ID2026031116475801.v1.class,
+            params = {@Param(paramname = "sa_customersids", fieldtype = FieldType.JSON, remarks = "客户ID", isrequired = true),
+                    @Param(paramname = "voidreason", fieldtype = FieldType.Varchar, remarks = "无效原因")})
     public String sa_customers_void() throws YosException {
         long sa_customersid = content.getLong("sa_customersid");
         String voidreason = content.getStringValue("voidreason");