Skip to content

E
easy-affair-show
Commit cd66bd4b authored by 廖旭伟's avatar 廖旭伟
Browse files
Options

更新接口文档

parent 888f2386
Hide whitespace changes
Inline Side-by-side
Showing with 1891 additions and 566 deletions
eas-manager/doc/api.md
View file @ cd66bd4b
...@@ -14,17 +14,16 @@ BigDecimal|小数类型|545.256 ...@@ -14,17 +14,16 @@ BigDecimal|小数类型|545.256
object|对象类型|{"name":"zhang3"} object|对象类型|{"name":"zhang3"}
arrays|数组类型|[{"name":"zhang3"},{"name":"zhang2"}] arrays|数组类型|[{"name":"zhang3"},{"name":"zhang2"}]
## 区域信息业务 ## 角色用户业务
### 查询角色用户业务列表
### 查询区域信息业务列表
**请求URL:** area/list **请求URL:** role/user/list
**请求方式:** POST **请求方式:** POST
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 查询区域信息业务 **简要描述:** 查询角色用户业务
**请求参数:** **请求参数:**
...@@ -53,21 +52,9 @@ data|object|数据对象 ...@@ -53,21 +52,9 @@ data|object|数据对象
 last_page|Integer|总页数  last_page|Integer|总页数
 current_page|Integer|当前页  current_page|Integer|当前页
 data|array|结果集列表|数组  data|array|结果集列表|数组
  id|Long|主键,自增长   id|Long|序号，主键，自增长
  parentId|Long|上级区域ID   roleId|Long|角色ID
  name|String|区域名称   userId|Long|用户ID
  level|Integer|区域级别，按所处树的节点层次
  code|String|区域编码，按全国省市编码
  contactsPeople|String|区域负责人
  contactsMobile|String|区域负责人电话
  childSize|Long|子区域数量，默认0
  maxChildId|Long|子区域的最大ID，默认0
  status|Integer|状态，0停用，1启用
  remark|String|描述
  createTime|Date|创建时间
  updateTime|Date|更新时间
  createUserId|Long|创建用户ID
  createUserName|String|创建用户名称
dict|object|字典对象 dict|object|字典对象
**响应消息样例:** **响应消息样例:**
...@@ -79,15 +66,15 @@ dict|object|字典对象 ...@@ -79,15 +66,15 @@ dict|object|字典对象
} }
``` ```
### 查看区域信息业务 ### 查看角色用户业务
**请求URL:** area/info **请求URL:** role/user/info
**请求方式:** GET **请求方式:** GET
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 查看区域信息业务，返回实例详细信息 **简要描述:** 查看角色用户业务，返回实例详细信息
**请求参数:** **请求参数:**
...@@ -97,7 +84,7 @@ id|Long|是|ID ...@@ -97,7 +84,7 @@ id|Long|是|ID
**请求样例:** **请求样例:**
``` ```
http://localhost/area/info?id=549 http://localhost/role/user/info?id=549
``` ```
**响应参数:** **响应参数:**
...@@ -106,21 +93,9 @@ id|Long|是|ID ...@@ -106,21 +93,9 @@ id|Long|是|ID
code|Integer|结果码（-1.失败，1.成功） code|Integer|结果码（-1.失败，1.成功）
msg|String|消息 msg|String|消息
data|object|数据对象 data|object|数据对象
 id|Long|主键,自增长  id|Long|序号，主键，自增长
 parentId|Long|上级区域ID  roleId|Long|角色ID
 name|String|区域名称  userId|Long|用户ID
 level|Integer|区域级别，按所处树的节点层次
 code|String|区域编码，按全国省市编码
 contactsPeople|String|区域负责人
 contactsMobile|String|区域负责人电话
 childSize|Long|子区域数量，默认0
 maxChildId|Long|子区域的最大ID，默认0
 status|Integer|状态，0停用，1启用
 remark|String|描述
 createTime|Date|创建时间
 updateTime|Date|更新时间
 createUserId|Long|创建用户ID
 createUserName|String|创建用户名称
dict|object|字典对象 dict|object|字典对象
**响应消息样例:** **响应消息样例:**
...@@ -128,65 +103,35 @@ dict|object|字典对象 ...@@ -128,65 +103,35 @@ dict|object|字典对象
{ {
"code": 1, "code": 1,
"data": { "data": {
"id":154, "id":726,
"parentId":8731, "roleId":5161,
"name":"hcuerp", "userId":464
"level":3642,
"code":"wy32vp",
"contactsPeople":"gi8t5w",
"contactsMobile":"n3w7kh",
"childSize":7594,
"maxChildId":4218,
"status":2142,
"remark":"4jhiga",
"createTime":"2022-06-07",
"updateTime":"2022-06-07",
"createUserId":6463,
"createUserName":"njxrtk"
} }
} }
``` ```
### 保存更新区域信息业务 ### 保存更新角色用户业务
**请求URL:** area/save **请求URL:** role/user/save
**请求方式:** POST **请求方式:** POST
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 保存或更新区域信息业务：id为空时为新增保存，否则为更新提交 **简要描述:** 保存或更新角色用户业务：id为空时为新增保存，否则为更新提交
**请求参数:** **请求参数:**
参数名称|类型|必填|描述 参数名称|类型|必填|描述
:---|:---|:---|:------- :---|:---|:---|:-------
parentId|Long|是|上级区域ID roleId|Long|是|角色ID
name|String|是|区域名称 userId|Long|是|用户ID
level|Integer|是|区域级别，按所处树的节点层次
code|String|是|区域编码，按全国省市编码
contactsPeople|String|是|区域负责人
contactsMobile|String|是|区域负责人电话
childSize|Long|是|子区域数量，默认0
maxChildId|Long|是|子区域的最大ID，默认0
status|Integer|是|状态，0停用，1启用
remark|String|是|描述
createUserName|String|是|创建用户名称
**请求样例:** **请求样例:**
``` ```
{ {
"parentId":1752, "roleId":2256,
"name":"8bmbcl", "userId":1935
"level":8839,
"code":"xjod7d",
"contactsPeople":"1otoqd",
"contactsMobile":"i0mahz",
"childSize":4384,
"maxChildId":7435,
"status":613,
"remark":"51ig15",
"createUserName":"nqoyw2"
} }
``` ```
...@@ -199,21 +144,9 @@ msg|String|消息 ...@@ -199,21 +144,9 @@ msg|String|消息
data|object|数据对象 data|object|数据对象
 id|Long|保存后主键id  id|Long|保存后主键id
 entity|object|保存更新实体  entity|object|保存更新实体
  id|Long|主键,自增长   id|Long|序号，主键，自增长
  parentId|Long|上级区域ID   roleId|Long|角色ID
  name|String|区域名称   userId|Long|用户ID
  level|Integer|区域级别，按所处树的节点层次
  code|String|区域编码，按全国省市编码
  contactsPeople|String|区域负责人
  contactsMobile|String|区域负责人电话
  childSize|Long|子区域数量，默认0
  maxChildId|Long|子区域的最大ID，默认0
  status|Integer|状态，0停用，1启用
  remark|String|描述
  createTime|Date|创建时间
  updateTime|Date|更新时间
  createUserId|Long|创建用户ID
  createUserName|String|创建用户名称
**响应消息样例:** **响应消息样例:**
``` ```
...@@ -226,15 +159,15 @@ data|object|数据对象 ...@@ -226,15 +159,15 @@ data|object|数据对象
``` ```
### 删除区域信息业务 ### 删除角色用户业务
**请求URL:** area/delete **请求URL:** role/user/delete
**请求方式:** GET **请求方式:** GET
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 删除区域信息业务 **简要描述:** 删除角色用户业务
**请求参数:** **请求参数:**
...@@ -244,7 +177,7 @@ id|String|是|数组 ...@@ -244,7 +177,7 @@ id|String|是|数组
**请求样例:** **请求样例:**
``` ```
http://localhost:8080/area/delete?id=1&id=2' http://localhost:8080/role/user/delete?id=1,2'
``` ```
**响应参数:** **响应参数:**
...@@ -261,17 +194,17 @@ msg|String|消息|- ...@@ -261,17 +194,17 @@ msg|String|消息|-
} }
``` ```
## 客户管理 ## 角色信息业务
### 查询客户管理列表 ### 查询角色信息业务列表
**请求URL:** customer/list **请求URL:** role/list
**请求方式:** POST **请求方式:** POST
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 查询客户管理 **简要描述:** 查询角色信息业务
**请求参数:** **请求参数:**
...@@ -300,23 +233,15 @@ data|object|数据对象 ...@@ -300,23 +233,15 @@ data|object|数据对象
 last_page|Integer|总页数  last_page|Integer|总页数
 current_page|Integer|当前页  current_page|Integer|当前页
 data|array|结果集列表|数组  data|array|结果集列表|数组
  id|Long|主键ID，主键，自增长   id|Long|序号，主键，自增长
  loginName|String|用户登录账号   name|String|角色名称
  password|String|密码   remark|String|备注
  memberLevel|Integer|会员等级，，0：未开启，1：试用客户，2：VIP，3：设计师，默认0   roleType|Integer|角色类型，0：系统内置角色（不可删除），1：默认系统角色，2：普通角色，默认2
  custName|String|客户真实名称   customerId|Long|归属客户ID
  organization|String|单位名称   createTime|Date|创建时间
  contactTelphone|String|联系电话
  enterpriseConsultant|String|企业顾问
  siteId|Long|站点ID
  sex|Integer|性别
  mailbox|String|邮箱
  job|String|职位
  customerSrc|Long|客户来源
  status|Integer|使用状态，1:正常，0:禁用，默认：0
  createUserId|Long|创建用户   createUserId|Long|创建用户
  createTime|Date|注册时间   createUserName|String|创建用户名称
  updateTime|Date|更新时间   userType|Integer|用户类型，0：系统用户 1:代理商用户 2:品牌商用户
dict|object|字典对象 dict|object|字典对象
**响应消息样例:** **响应消息样例:**
...@@ -328,15 +253,15 @@ dict|object|字典对象 ...@@ -328,15 +253,15 @@ dict|object|字典对象
} }
``` ```
### 查看客户管理 ### 查看角色信息业务
**请求URL:** customer/info **请求URL:** role/info
**请求方式:** GET **请求方式:** GET
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 查看客户管理，返回实例详细信息 **简要描述:** 查看角色信息业务，返回实例详细信息
**请求参数:** **请求参数:**
...@@ -346,7 +271,7 @@ id|Long|是|ID ...@@ -346,7 +271,7 @@ id|Long|是|ID
**请求样例:** **请求样例:**
``` ```
http://localhost/customer/info?id=549 http://localhost/role/info?id=549
``` ```
**响应参数:** **响应参数:**
...@@ -355,23 +280,15 @@ id|Long|是|ID ...@@ -355,23 +280,15 @@ id|Long|是|ID
code|Integer|结果码（-1.失败，1.成功） code|Integer|结果码（-1.失败，1.成功）
msg|String|消息 msg|String|消息
data|object|数据对象 data|object|数据对象
 id|Long|主键ID，主键，自增长  id|Long|序号，主键，自增长
 loginName|String|用户登录账号  name|String|角色名称
 password|String|密码  remark|String|备注
 memberLevel|Integer|会员等级，，0：未开启，1：试用客户，2：VIP，3：设计师，默认0  roleType|Integer|角色类型，0：系统内置角色（不可删除），1：默认系统角色，2：普通角色，默认2
 custName|String|客户真实名称  customerId|Long|归属客户ID
 organization|String|单位名称  createTime|Date|创建时间
 contactTelphone|String|联系电话
 enterpriseConsultant|String|企业顾问
 siteId|Long|站点ID
 sex|Integer|性别
 mailbox|String|邮箱
 job|String|职位
 customerSrc|Long|客户来源
 status|Integer|使用状态，1:正常，0:禁用，默认：0
 createUserId|Long|创建用户  createUserId|Long|创建用户
 createTime|Date|注册时间  createUserName|String|创建用户名称
 updateTime|Date|更新时间  userType|Integer|用户类型，0：系统用户 1:代理商用户 2:品牌商用户
dict|object|字典对象 dict|object|字典对象
**响应消息样例:** **响应消息样例:**
...@@ -379,71 +296,49 @@ dict|object|字典对象 ...@@ -379,71 +296,49 @@ dict|object|字典对象
{ {
"code": 1, "code": 1,
"data": { "data": {
"id":3493, "id":8602,
"loginName":"l484ik", "name":"qkzmie",
"password":"t6xrsp", "remark":"pgb6gv",
"memberLevel":1448, "roleType":6719,
"custName":"oelm1c", "customerId":6933,
"organization":"umkwml", "createTime":"2022-06-14",
"contactTelphone":"oljban", "createUserId":9349,
"enterpriseConsultant":"ee8lxj", "createUserName":"wlyqwt",
"siteId":334, "userType":3431
"sex":1053,
"mailbox":"0n1im0",
"job":"ou720h",
"customerSrc":9810,
"status":9420,
"createUserId":409,
"createTime":"2022-06-07",
"updateTime":"2022-06-07"
} }
} }
``` ```
### 保存更新客户管理 ### 保存更新角色信息业务
**请求URL:** customer/save **请求URL:** role/save
**请求方式:** POST **请求方式:** POST
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 保存或更新客户管理：id为空时为新增保存，否则为更新提交 **简要描述:** 保存或更新角色信息业务：id为空时为新增保存，否则为更新提交
**请求参数:** **请求参数:**
参数名称|类型|必填|描述 参数名称|类型|必填|描述
:---|:---|:---|:------- :---|:---|:---|:-------
loginName|String|是|用户登录账号 name|String|是|角色名称
password|String|是|密码 remark|String|是|备注
memberLevel|Integer|是|会员等级，，0：未开启，1：试用客户，2：VIP，3：设计师，默认0 roleType|Integer|是|角色类型，0：系统内置角色（不可删除），1：默认系统角色，2：普通角色，默认2
custName|String|是|客户真实名称 customerId|Long|是|归属客户ID
organization|String|是|单位名称 createUserName|String|是|创建用户名称
contactTelphone|String|是|联系电话 userType|Integer|是|用户类型，0：系统用户 1:代理商用户 2:品牌商用户
enterpriseConsultant|String|是|企业顾问
siteId|Long|是|站点ID
sex|Integer|是|性别
mailbox|String|是|邮箱
job|String|是|职位
customerSrc|Long|是|客户来源
status|Integer|是|使用状态，1:正常，0:禁用，默认：0
**请求样例:** **请求样例:**
``` ```
{ {
"loginName":"ce8yry", "name":"tttv7y",
"password":"bw9cql", "remark":"d2nvjv",
"memberLevel":885, "roleType":1097,
"custName":"rikz8m", "customerId":1137,
"organization":"l8p0vj", "createUserName":"jgfn20",
"contactTelphone":"7chdoj", "userType":5706
"enterpriseConsultant":"xxgdtv",
"siteId":2594,
"sex":8725,
"mailbox":"hqgg3q",
"job":"b7lr1o",
"customerSrc":2915,
"status":6467,
} }
``` ```
...@@ -456,23 +351,15 @@ msg|String|消息 ...@@ -456,23 +351,15 @@ msg|String|消息
data|object|数据对象 data|object|数据对象
 id|Long|保存后主键id  id|Long|保存后主键id
 entity|object|保存更新实体  entity|object|保存更新实体
  id|Long|主键ID，主键，自增长   id|Long|序号，主键，自增长
  loginName|String|用户登录账号   name|String|角色名称
  password|String|密码   remark|String|备注
  memberLevel|Integer|会员等级，，0：未开启，1：试用客户，2：VIP，3：设计师，默认0   roleType|Integer|角色类型，0：系统内置角色（不可删除），1：默认系统角色，2：普通角色，默认2
  custName|String|客户真实名称   customerId|Long|归属客户ID
  organization|String|单位名称   createTime|Date|创建时间
  contactTelphone|String|联系电话
  enterpriseConsultant|String|企业顾问
  siteId|Long|站点ID
  sex|Integer|性别
  mailbox|String|邮箱
  job|String|职位
  customerSrc|Long|客户来源
  status|Integer|使用状态，1:正常，0:禁用，默认：0
  createUserId|Long|创建用户   createUserId|Long|创建用户
  createTime|Date|注册时间   createUserName|String|创建用户名称
  updateTime|Date|更新时间   userType|Integer|用户类型，0：系统用户 1:代理商用户 2:品牌商用户
**响应消息样例:** **响应消息样例:**
``` ```
...@@ -485,15 +372,15 @@ data|object|数据对象 ...@@ -485,15 +372,15 @@ data|object|数据对象
``` ```
### 删除客户管理 ### 删除角色信息业务
**请求URL:** customer/delete **请求URL:** role/delete
**请求方式:** GET **请求方式:** GET
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 删除客户管理 **简要描述:** 删除角色信息业务
**请求参数:** **请求参数:**
...@@ -503,7 +390,7 @@ id|String|是|数组 ...@@ -503,7 +390,7 @@ id|String|是|数组
**请求样例:** **请求样例:**
``` ```
http://localhost:8080/customer/delete?id=1&id=2' http://localhost:8080/role/delete?id=1,2'
``` ```
**响应参数:** **响应参数:**
...@@ -520,17 +407,17 @@ msg|String|消息|- ...@@ -520,17 +407,17 @@ msg|String|消息|-
} }
``` ```
## 客户试用申请 ## 操作日志业务
### 查询客户试用申请列表 ### 查询操作日志业务列表
**请求URL:** customer/trial/list **请求URL:** oper/log/list
**请求方式:** POST **请求方式:** POST
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 查询客户试用申请 **简要描述:** 查询操作日志业务
**请求参数:** **请求参数:**
...@@ -559,13 +446,16 @@ data|object|数据对象 ...@@ -559,13 +446,16 @@ data|object|数据对象
 last_page|Integer|总页数  last_page|Integer|总页数
 current_page|Integer|当前页  current_page|Integer|当前页
 data|array|结果集列表|数组  data|array|结果集列表|数组
  id|Long|主键ID，主键，自增长   id|Long|序号，主键，自增长
  customerId|Long|客户ID   platformMark|String|平台标识
  memberLevel|Integer|申请会员等级，1：试用客户，2：VIP，3：设计师   userId|Long|用户id
  isAccept|Integer|受理状态，0:未受理，1:同意，2:不同意。默认：0   userName|String|用户名称
  createUserId|Long|受理用户   loginName|String|用户登录名
  createTime|Date|提交时间   requestUrl|String|请求地址
  updateTime|Date|受理时间   content|String|操作内容，记录操作具体信息，如修改前修改或的数据
  ip|String|操作IP地址
  logDate|Date|操作时间
  operType|Integer|操作类型，0：新增，1：修改，2：删除
dict|object|字典对象 dict|object|字典对象
**响应消息样例:** **响应消息样例:**
...@@ -577,15 +467,15 @@ dict|object|字典对象 ...@@ -577,15 +467,15 @@ dict|object|字典对象
} }
``` ```
### 查看客户试用申请 ### 查看操作日志业务
**请求URL:** customer/trial/info **请求URL:** oper/log/info
**请求方式:** GET **请求方式:** GET
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 查看客户试用申请，返回实例详细信息 **简要描述:** 查看操作日志业务，返回实例详细信息
**请求参数:** **请求参数:**
...@@ -595,7 +485,7 @@ id|Long|是|ID ...@@ -595,7 +485,7 @@ id|Long|是|ID
**请求样例:** **请求样例:**
``` ```
http://localhost/customer/trial/info?id=549 http://localhost/oper/log/info?id=549
``` ```
**响应参数:** **响应参数:**
...@@ -604,13 +494,16 @@ id|Long|是|ID ...@@ -604,13 +494,16 @@ id|Long|是|ID
code|Integer|结果码（-1.失败，1.成功） code|Integer|结果码（-1.失败，1.成功）
msg|String|消息 msg|String|消息
data|object|数据对象 data|object|数据对象
 id|Long|主键ID，主键，自增长  id|Long|序号，主键，自增长
 customerId|Long|客户ID  platformMark|String|平台标识
 memberLevel|Integer|申请会员等级，1：试用客户，2：VIP，3：设计师  userId|Long|用户id
 isAccept|Integer|受理状态，0:未受理，1:同意，2:不同意。默认：0  userName|String|用户名称
 createUserId|Long|受理用户  loginName|String|用户登录名
 createTime|Date|提交时间  requestUrl|String|请求地址
 updateTime|Date|受理时间  content|String|操作内容，记录操作具体信息，如修改前修改或的数据
 ip|String|操作IP地址
 logDate|Date|操作时间
 operType|Integer|操作类型，0：新增，1：修改，2：删除
dict|object|字典对象 dict|object|字典对象
**响应消息样例:** **响应消息样例:**
...@@ -618,38 +511,788 @@ dict|object|字典对象 ...@@ -618,38 +511,788 @@ dict|object|字典对象
{ {
"code": 1, "code": 1,
"data": { "data": {
"id":8871, "id":143,
"customerId":2228, "platformMark":"w5knp2",
"memberLevel":2071, "userId":5679,
"isAccept":8450, "userName":"t06d2p",
"createUserId":6731, "loginName":"f1yu7x",
"createTime":"2022-06-07", "requestUrl":"2tg8nz",
"updateTime":"2022-06-07" "content":"xv1rmy",
"ip":"jomh5z",
"logDate":"2022-06-14",
"operType":8042
} }
} }
``` ```
### 保存更新客户试用申请 ## 区域信息业务
**请求URL:** customer/trial/save ### 查询区域信息业务列表
**请求URL:** area/list
**请求方式:** POST **请求方式:** POST
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 保存或更新客户试用申请：id为空时为新增保存，否则为更新提交 **简要描述:** 查询区域信息业务
**请求参数:** **请求参数:**
参数名称|类型|必填|描述 参数名称|类型|必填|描述
:---|:---|:---|:------- :---|:---|:---|:------
customerId|Long|是|客户ID page|Integer|否|当前页
memberLevel|Integer|是|申请会员等级，1：试用客户，2：VIP，3：设计师 size|Integer|否|每页条数，值为-1，查询所有记录
isAccept|Integer|是|受理状态，0:未受理，1:同意，2:不同意。默认：0
**请求样例:** **请求样例:**
``` ```
{ {
"page":1,
"size":10
}
```
**响应参数:**
参数名称|参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
 per_page|Integer|每页条数
 total|Integer|总条数
 last_page|Integer|总页数
 current_page|Integer|当前页
 data|array|结果集列表|数组
  id|Long|主键,自增长
  parentId|Long|上级区域ID
  name|String|区域名称
  level|Integer|区域级别，按所处树的节点层次
  code|String|区域编码，按全国省市编码
  contactsPeople|String|区域负责人
  contactsMobile|String|区域负责人电话
  childSize|Long|子区域数量，默认0
  maxChildId|Long|子区域的最大ID，默认0
  status|Integer|状态，0停用，1启用
  remark|String|描述
  createTime|Date|创建时间
  updateTime|Date|更新时间
  createUserId|Long|创建用户ID
  createUserName|String|创建用户名称
dict|object|字典对象
**响应消息样例:**
```
{
"code":1,
"data":{
}
}
```
### 查看区域信息业务
**请求URL:** area/info
**请求方式:** GET
**内容类型:** application/json;charset=utf-8
**简要描述:** 查看区域信息业务，返回实例详细信息
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:------
id|Long|是|ID
**请求样例:**
```
http://localhost/area/info?id=549
```
**响应参数:**
参数名称 |参数类型|描述
:---|:---|:-------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
 id|Long|主键,自增长
 parentId|Long|上级区域ID
 name|String|区域名称
 level|Integer|区域级别，按所处树的节点层次
 code|String|区域编码，按全国省市编码
 contactsPeople|String|区域负责人
 contactsMobile|String|区域负责人电话
 childSize|Long|子区域数量，默认0
 maxChildId|Long|子区域的最大ID，默认0
 status|Integer|状态，0停用，1启用
 remark|String|描述
 createTime|Date|创建时间
 updateTime|Date|更新时间
 createUserId|Long|创建用户ID
 createUserName|String|创建用户名称
dict|object|字典对象
**响应消息样例:**
```
{
"code": 1,
"data": {
"id":154,
"parentId":8731,
"name":"hcuerp",
"level":3642,
"code":"wy32vp",
"contactsPeople":"gi8t5w",
"contactsMobile":"n3w7kh",
"childSize":7594,
"maxChildId":4218,
"status":2142,
"remark":"4jhiga",
"createTime":"2022-06-07",
"updateTime":"2022-06-07",
"createUserId":6463,
"createUserName":"njxrtk"
}
}
```
### 保存更新区域信息业务
**请求URL:** area/save
**请求方式:** POST
**内容类型:** application/json;charset=utf-8
**简要描述:** 保存或更新区域信息业务：id为空时为新增保存，否则为更新提交
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:-------
parentId|Long|是|上级区域ID
name|String|是|区域名称
level|Integer|是|区域级别，按所处树的节点层次
code|String|是|区域编码，按全国省市编码
contactsPeople|String|是|区域负责人
contactsMobile|String|是|区域负责人电话
childSize|Long|是|子区域数量，默认0
maxChildId|Long|是|子区域的最大ID，默认0
status|Integer|是|状态，0停用，1启用
remark|String|是|描述
createUserName|String|是|创建用户名称
**请求样例:**
```
{
"parentId":1752,
"name":"8bmbcl",
"level":8839,
"code":"xjod7d",
"contactsPeople":"1otoqd",
"contactsMobile":"i0mahz",
"childSize":4384,
"maxChildId":7435,
"status":613,
"remark":"51ig15",
"createUserName":"nqoyw2"
}
```
**响应参数:**
参数名称 |参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
 id|Long|保存后主键id
 entity|object|保存更新实体
  id|Long|主键,自增长
  parentId|Long|上级区域ID
  name|String|区域名称
  level|Integer|区域级别，按所处树的节点层次
  code|String|区域编码，按全国省市编码
  contactsPeople|String|区域负责人
  contactsMobile|String|区域负责人电话
  childSize|Long|子区域数量，默认0
  maxChildId|Long|子区域的最大ID，默认0
  status|Integer|状态，0停用，1启用
  remark|String|描述
  createTime|Date|创建时间
  updateTime|Date|更新时间
  createUserId|Long|创建用户ID
  createUserName|String|创建用户名称
**响应消息样例:**
```
{
"msg":"新增模块成功",
"code":1,
"data":{}
}
}
```
### 删除区域信息业务
**请求URL:** area/delete
**请求方式:** GET
**内容类型:** application/json;charset=utf-8
**简要描述:** 删除区域信息业务
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:------
id|String|是|数组
**请求样例:**
```
http://localhost:8080/area/delete?id=1&id=2'
```
**响应参数:**
参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-
**响应消息样例:**
```
{
"code":1,
"msg":"成功"
}
```
## 客户管理
### 查询客户管理列表
**请求URL:** customer/list
**请求方式:** POST
**内容类型:** application/json;charset=utf-8
**简要描述:** 查询客户管理
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:------
query|String|否|姓名手机号查询条件
memberLevel|Long|否|会员等级查询条件
customerSrc|Long|否|客户来源查询条件
page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录
**请求样例:**
```
{
"query":"张三",
"customerSrc":1,
"page":1,
"size":10
}
```
**响应参数:**
参数名称|参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
 per_page|Integer|每页条数
 total|Integer|总条数
 last_page|Integer|总页数
 current_page|Integer|当前页
 data|array|结果集列表|数组
  id|Long|主键ID，主键，自增长
  loginName|String|用户登录账号
  password|String|密码
  memberLevel|Integer|会员等级，，0：未开启，1：试用客户，2：VIP，3：设计师，默认0
  custName|String|客户真实名称
  organization|String|单位名称
  contactTelphone|String|联系电话
  enterpriseConsultant|String|企业顾问
  siteId|Long|站点ID
  sex|Integer|性别
  mailbox|String|邮箱
  job|String|职位
  customerSrc|Long|客户来源
  status|Integer|使用状态，1:正常，0:禁用，默认：0
  createUserId|Long|创建用户
  createTime|Date|注册时间
  updateTime|Date|更新时间
  lastLoginTime|String|最后一次登录时间
  createTimeStr|String|创建时间
  customerDesignPictures|Integer|图片数量
  customerDesignVideos|Integer|视频数量
dict|object|字典对象
**响应消息样例:**
```
{
"code":1,
"data":{
}
}
```
### 查看客户管理
**请求URL:** customer/info
**请求方式:** GET
**内容类型:** application/json;charset=utf-8
**简要描述:** 查看客户管理，返回实例详细信息
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:------
id|Long|是|ID
**请求样例:**
```
http://localhost/customer/info?id=549
```
**响应参数:**
参数名称 |参数类型|描述
:---|:---|:-------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
 id|Long|主键ID，主键，自增长
 loginName|String|用户登录账号
 password|String|密码
 memberLevel|Integer|会员等级，，0：未开启，1：试用客户，2：VIP，3：设计师，默认0
 custName|String|客户真实名称
 organization|String|单位名称
 contactTelphone|String|联系电话
 enterpriseConsultant|String|企业顾问
 siteId|Long|站点ID
 sex|Integer|性别
 mailbox|String|邮箱
 job|String|职位
 customerSrc|Long|客户来源
 status|Integer|使用状态，1:正常，0:禁用，默认：0
 createUserId|Long|创建用户
 createTime|Date|注册时间
 updateTime|Date|更新时间
dict|object|字典对象
**响应消息样例:**
```
{
"code": 1,
"data": {
"id":3493,
"loginName":"l484ik",
"password":"t6xrsp",
"memberLevel":1448,
"custName":"oelm1c",
"organization":"umkwml",
"contactTelphone":"oljban",
"enterpriseConsultant":"ee8lxj",
"siteId":334,
"sex":1053,
"mailbox":"0n1im0",
"job":"ou720h",
"customerSrc":9810,
"status":9420,
"createUserId":409,
"createTime":"2022-06-07",
"updateTime":"2022-06-07"
}
}
```
### 保存更新客户管理
**请求URL:** customer/save
**请求方式:** POST
**内容类型:** application/json;charset=utf-8
**简要描述:** 保存或更新客户管理：id为空时为新增保存，否则为更新提交
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:-------
loginName|String|是|用户登录账号
password|String|是|密码
memberLevel|Integer|是|会员等级，，0：未开启，1：试用客户，2：VIP，3：设计师，默认0
custName|String|是|客户真实名称
organization|String|是|单位名称
contactTelphone|String|是|联系电话
enterpriseConsultant|String|是|企业顾问
siteId|Long|是|站点ID
sex|Integer|是|性别
mailbox|String|是|邮箱
job|String|是|职位
customerSrc|Long|是|客户来源
status|Integer|是|使用状态，1:正常，0:禁用，默认：0
**请求样例:**
```
{
"loginName":"ce8yry",
"password":"bw9cql",
"memberLevel":885,
"custName":"rikz8m",
"organization":"l8p0vj",
"contactTelphone":"7chdoj",
"enterpriseConsultant":"xxgdtv",
"siteId":2594,
"sex":8725,
"mailbox":"hqgg3q",
"job":"b7lr1o",
"customerSrc":2915,
"status":6467,
}
```
**响应参数:**
参数名称 |参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
 id|Long|保存后主键id
 entity|object|保存更新实体
  id|Long|主键ID，主键，自增长
  loginName|String|用户登录账号
  password|String|密码
  memberLevel|Integer|会员等级，，0：未开启，1：试用客户，2：VIP，3：设计师，默认0
  custName|String|客户真实名称
  organization|String|单位名称
  contactTelphone|String|联系电话
  enterpriseConsultant|String|企业顾问
  siteId|Long|站点ID
  sex|Integer|性别
  mailbox|String|邮箱
  job|String|职位
  customerSrc|Long|客户来源
  status|Integer|使用状态，1:正常，0:禁用，默认：0
  createUserId|Long|创建用户
  createTime|Date|注册时间
  updateTime|Date|更新时间
**响应消息样例:**
```
{
"msg":"新增模块成功",
"code":1,
"data":{}
}
}
```
### 删除客户管理
**请求URL:** customer/delete
**请求方式:** GET
**内容类型:** application/json;charset=utf-8
**简要描述:** 删除客户管理
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:------
id|String|是|数组
**请求样例:**
```
http://localhost:8080/customer/delete?id=1&id=2'
```
**响应参数:**
参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-
**响应消息样例:**
```
{
"code":1,
"msg":"成功"
}
```
### 启用客户
**请求URL:** customer/status/enable
**请求方式:** GET
**内容类型:** application/json;charset=utf-8
**简要描述:** 启用客户
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:------
id|String|是|数组
**请求样例:**
```
http://localhost:8080/customer/status/enable?id=1,2,3'
```
**响应参数:**
参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-
**响应消息样例:**
```
{
"msg": "客户管理启用成功!启用条数:1",
"code": 1,
"data": {}
}
```
### 启用客户
**请求URL:** customer/status/disable
**请求方式:** GET
**内容类型:** application/json;charset=utf-8
**简要描述:** 禁用客户
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:------
id|String|是|数组
**请求样例:**
```
http://localhost:8080/customer/status/disable?id=1,2,3'
```
**响应参数:**
参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-
**响应消息样例:**
```
{
"msg": "客户管理禁用成功!禁用条数:1",
"code": 1,
"data": {}
}
```
## 客户试用申请
### 查询客户试用申请列表
**请求URL:** customer/trial/list
**请求方式:** POST
**内容类型:** application/json;charset=utf-8
**简要描述:** 查询客户试用申请
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:------
query|String|否|姓名手机号查询条件
page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录
**请求样例:**
```
{
"page":1,
"size":10
}
```
**响应参数:**
参数名称|参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
 per_page|Integer|每页条数
 total|Integer|总条数
 last_page|Integer|总页数
 current_page|Integer|当前页
 data|array|结果集列表|数组
  id|Long|主键ID，主键，自增长
  customerId|Long|客户ID
  memberLevel|Integer|申请会员等级，1：试用客户，2：VIP，3：设计师
  isAccept|Integer|受理状态，0:未受理，1:同意，2:不同意。默认：0
  createUserId|Long|受理用户
  createTime|Date|提交时间
  updateTime|Date|受理时间
  memberLevel|Integer|会员等级，，0：未开启，1：试用客户，2：VIP，3：设计师，默认0
  custName|String|客户真实名称
  organization|String|单位名称
  contactTelphone|String|联系电话
  mailbox|String|邮箱地址
  applyDate|String|申请时间
dict|object|字典对象
**响应消息样例:**
```
{
"code": 1,
"data": {
"per_page": 6,
"total": 1,
"data": [
{
"applyDate": "2022-06-09 16:33:30",
"contactTelphone": "13888888888",
"createTime": 1654763610000,
"createUserId": 1,
"custName": "测试",
"customerId": 1,
"deleted": 0,
"id": 1,
"isAccept": 1,
"job": "总监",
"mailbox": "qqq@123.com",
"memberLevel": 2,
"organization": "测试公司"
}
],
"last_page": 1,
"pageInfo": {
"beginIndex": 0,
"countPage": true,
"currPage": 1,
"displayPageSize": 5,
"hasNextPage": false,
"hasPrePage": false,
"prePageResult": 6,
"totalPage": 1,
"totalResult": 1
},
"current_page": 1
},
"dict": {
"memberLevel": {
"1": "试用客户",
"2": "VIP客户",
"3": "设计师"
},
"isAccept": {
"0": "未受理",
"1": "同意",
"2": "不同意"
}
}
}
```
### 查看客户试用申请
**请求URL:** customer/trial/info
**请求方式:** GET
**内容类型:** application/json;charset=utf-8
**简要描述:** 查看客户试用申请，返回实例详细信息
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:------
id|Long|是|ID
**请求样例:**
```
http://localhost/customer/trial/info?id=549
```
**响应参数:**
参数名称 |参数类型|描述
:---|:---|:-------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
 id|Long|主键ID，主键，自增长
 customerId|Long|客户ID
 memberLevel|Integer|申请会员等级，1：试用客户，2：VIP，3：设计师
 isAccept|Integer|受理状态，0:未受理，1:同意，2:不同意。默认：0
 createUserId|Long|受理用户
 createTime|Date|提交时间
 updateTime|Date|受理时间
dict|object|字典对象
**响应消息样例:**
```
{
"code": 1,
"data": {
"id":8871,
"customerId":2228,
"memberLevel":2071,
"isAccept":8450,
"createUserId":6731,
"createTime":"2022-06-07",
"updateTime":"2022-06-07"
}
}
```
### 保存更新客户试用申请
**请求URL:** customer/trial/save
**请求方式:** POST
**内容类型:** application/json;charset=utf-8
**简要描述:** 保存或更新客户试用申请：id为空时为新增保存，否则为更新提交
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:-------
customerId|Long|是|客户ID
memberLevel|Integer|是|申请会员等级，1：试用客户，2：VIP，3：设计师
isAccept|Integer|是|受理状态，0:未受理，1:同意，2:不同意。默认：0
**请求样例:**
```
{
"customerId":6633, "customerId":6633,
"memberLevel":5866, "memberLevel":5866,
"isAccept":6478, "isAccept":6478,
...@@ -667,11 +1310,458 @@ data|object|数据对象 ...@@ -667,11 +1310,458 @@ data|object|数据对象
 entity|object|保存更新实体  entity|object|保存更新实体
  id|Long|主键ID，主键，自增长   id|Long|主键ID，主键，自增长
  customerId|Long|客户ID   customerId|Long|客户ID
  memberLevel|Integer|申请会员等级，1：试用客户，2：VIP，3：设计师   memberLevel|Integer|申请会员等级，1：试用客户，2：VIP，3：设计师
  isAccept|Integer|受理状态，0:未受理，1:同意，2:不同意。默认：0   isAccept|Integer|受理状态，0:未受理，1:同意，2:不同意。默认：0
  createUserId|Long|受理用户   createUserId|Long|受理用户
  createTime|Date|提交时间   createTime|Date|提交时间
  updateTime|Date|受理时间   updateTime|Date|受理时间
**响应消息样例:**
```
{
"msg":"新增模块成功",
"code":1,
"data":{}
}
}
```
### 删除客户试用申请
**请求URL:** customer/trial/delete
**请求方式:** GET
**内容类型:** application/json;charset=utf-8
**简要描述:** 删除客户试用申请
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:------
id|String|是|数组
**请求样例:**
```
http://localhost:8080/customer/trial/delete?id=1,2'
```
**响应参数:**
参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-
**响应消息样例:**
```
{
"code":1,
"msg":"成功"
}
```
### 客户试用申请处理
**请求URL:** customer/trial/accept
**请求方式:** POST
**内容类型:** application/json;charset=utf-8
**简要描述:** 保存或更新客户试用申请：id为空时为新增保存，否则为更新提交
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:-------
id|Long|是|客户试用申请主键
loginName|String|否|登陆账号
password|String|否|登陆密码
isAccept|Integer|是|受理状态，0:未受理，1:同意，2:不同意。默认：0
**请求样例:**
```
{
"id": 1,
"loginName": "zhangsan",
"password": "111111",
"isAccept": 2
}
```
**响应参数:**
参数名称 |参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
 id|Long|保存后主键id
 entity|object|保存更新实体
  id|Long|主键ID，主键，自增长
  customerId|Long|客户ID
  memberLevel|Integer|申请会员等级，1：试用客户，2：VIP，3：设计师
  isAccept|Integer|受理状态，0:未受理，1:同意，2:不同意。默认：0
  createUserId|Long|受理用户
  createTime|Date|提交时间
  updateTime|Date|受理时间
**响应消息样例:**
```
{
"code": 1,
"msg":"成功",
"data": {},
"dict": {
"memberLevel": {
"1": "试用客户",
"2": "VIP客户",
"3": "设计师"
},
"isAccept": {
"0": "未受理",
"1": "同意",
"2": "不同意"
}
}
}
```
## 客户作品统计
### 查询客户作品统计列表
**请求URL:** customer/work/design/stat/list
**请求方式:** POST
**内容类型:** application/json;charset=utf-8
**简要描述:** 查询客户作品统计
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:------
page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录
**请求样例:**
```
{
"page":1,
"size":10
}
```
**响应参数:**
参数名称|参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
 per_page|Integer|每页条数
 total|Integer|总条数
 last_page|Integer|总页数
 current_page|Integer|当前页
 data|array|结果集列表|数组
  id|Long|主键ID，主键，自增长
  customerId|Long|客户ID
  customerDesignPictures|Integer|客户设计图片数量
  customerDesignVideos|Integer|客户设计视频数量
  createTime|Date|注册时间
  updateTime|Date|更新时间
dict|object|字典对象
**响应消息样例:**
```
{
"code":1,
"data":{
}
}
```
### 查看客户作品统计
**请求URL:** customer/work/design/stat/info
**请求方式:** GET
**内容类型:** application/json;charset=utf-8
**简要描述:** 查看客户作品统计，返回实例详细信息
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:------
id|Long|是|ID
**请求样例:**
```
http://localhost/customer/work/design/stat/info?id=549
```
**响应参数:**
参数名称 |参数类型|描述
:---|:---|:-------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
 id|Long|主键ID，主键，自增长
 customerId|Long|客户ID
 customerDesignPictures|Integer|客户设计图片数量
 customerDesignVideos|Integer|客户设计视频数量
 createTime|Date|注册时间
 updateTime|Date|更新时间
dict|object|字典对象
**响应消息样例:**
```
{
"code": 1,
"data": {
"id":8363,
"customerId":2122,
"customerDesignPictures":3742,
"customerDesignVideos":3563,
"createTime":"2022-06-07",
"updateTime":"2022-06-07"
}
}
```
### 保存更新客户作品统计
**请求URL:** customer/work/design/stat/save
**请求方式:** POST
**内容类型:** application/json;charset=utf-8
**简要描述:** 保存或更新客户作品统计：id为空时为新增保存，否则为更新提交
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:-------
customerId|Long|是|客户ID
customerDesignPictures|Integer|是|客户设计图片数量
customerDesignVideos|Integer|是|客户设计视频数量
**请求样例:**
```
{
"customerId":1077,
"customerDesignPictures":9239,
"customerDesignVideos":8101,
}
```
**响应参数:**
参数名称 |参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
 id|Long|保存后主键id
 entity|object|保存更新实体
  id|Long|主键ID，主键，自增长
  customerId|Long|客户ID
  customerDesignPictures|Integer|客户设计图片数量
  customerDesignVideos|Integer|客户设计视频数量
  createTime|Date|注册时间
  updateTime|Date|更新时间
**响应消息样例:**
```
{
"msg":"新增模块成功",
"code":1,
"data":{}
}
}
```
### 删除客户作品统计
**请求URL:** customer/work/design/stat/delete
**请求方式:** GET
**内容类型:** application/json;charset=utf-8
**简要描述:** 删除客户作品统计
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:------
id|String|是|数组
**请求样例:**
```
http://localhost:8080/customer/work/design/stat/delete?id=1&id=2'
```
**响应参数:**
参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-
**响应消息样例:**
```
{
"code":1,
"msg":"成功"
}
```
## 客户作品信息
### 查询客户作品信息列表
**请求URL:** customer/work/design/list
**请求方式:** POST
**内容类型:** application/json;charset=utf-8
**简要描述:** 查询客户作品信息
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:------
page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录
**请求样例:**
```
{
"page":1,
"size":10
}
```
**响应参数:**
参数名称|参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
 per_page|Integer|每页条数
 total|Integer|总条数
 last_page|Integer|总页数
 current_page|Integer|当前页
 data|array|结果集列表|数组
  id|Long|主键ID，主键，自增长
  customerId|Long|客户ID
  createTime|Date|收藏时间
  masterplateId|Long|模版ID
dict|object|字典对象
**响应消息样例:**
```
{
"code":1,
"data":{
}
}
```
### 查看客户作品信息
**请求URL:** customer/work/design/info
**请求方式:** GET
**内容类型:** application/json;charset=utf-8
**简要描述:** 查看客户作品信息，返回实例详细信息
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:------
id|Long|是|ID
**请求样例:**
```
http://localhost/customer/work/design/info?id=549
```
**响应参数:**
参数名称 |参数类型|描述
:---|:---|:-------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
 id|Long|主键ID，主键，自增长
 customerId|Long|客户ID
 createTime|Date|收藏时间
 masterplateId|Long|模版ID
dict|object|字典对象
**响应消息样例:**
```
{
"code": 1,
"data": {
"id":2739,
"customerId":7423,
"createTime":"2022-06-07",
"masterplateId":4628
}
}
```
### 保存更新客户作品信息
**请求URL:** customer/work/design/save
**请求方式:** POST
**内容类型:** application/json;charset=utf-8
**简要描述:** 保存或更新客户作品信息：id为空时为新增保存，否则为更新提交
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:-------
customerId|Long|是|客户ID
masterplateId|Long|是|模版ID
**请求样例:**
```
{
"customerId":2890,
"masterplateId":6167
}
```
**响应参数:**
参数名称 |参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
 id|Long|保存后主键id
 entity|object|保存更新实体
  id|Long|主键ID，主键，自增长
  customerId|Long|客户ID
  createTime|Date|收藏时间
  masterplateId|Long|模版ID
**响应消息样例:** **响应消息样例:**
``` ```
...@@ -684,15 +1774,256 @@ data|object|数据对象 ...@@ -684,15 +1774,256 @@ data|object|数据对象
``` ```
### 删除客户试用申请 ### 删除客户作品信息
**请求URL:** customer/trial/delete **请求URL:** customer/work/design/delete
**请求方式:** GET
**内容类型:** application/json;charset=utf-8
**简要描述:** 删除客户作品信息
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:------
id|String|是|数组
**请求样例:**
```
http://localhost:8080/customer/work/design/delete?id=1&id=2'
```
**响应参数:**
参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-
**响应消息样例:**
```
{
"code":1,
"msg":"成功"
}
```
## 模版管理
### 查询模版管理列表
**请求URL:** design/masterplate/list
**请求方式:** POST
**内容类型:** application/json;charset=utf-8
**简要描述:** 查询模版管理
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:------
masterplateName|String|否|模板名称
page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录
**请求样例:**
```
{
"masterplateName":"test",
"page":1,
"size":10
}
```
**响应参数:**
参数名称|参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
 per_page|Integer|每页条数
 total|Integer|总条数
 last_page|Integer|总页数
 current_page|Integer|当前页
 data|array|结果集列表|数组
  id|Long|主键ID，主键，自增长
  masterplateName|Long|模版名称
  masterplateCode|Integer|模版编码
  customerId|Long|发布人
  customerName|String|发布人名称
  createTime|Date|发布时间
  masterplateDesc|String|模版描述
  masterplatePath|String|模版下载地址（相对地址）
  pictureId|Long|模版引用的图片
  pictureSrcId|Long|模版引用的素材
  pictureBackgroundId|Long|模版引用的背景
  fontId|Long|模版引用的字体
  masterplateUseNum|Integer|模版被引用的次数。默认：0
dict|object|字典对象
**响应消息样例:**
```
{
"code":1,
"data":{
}
}
```
### 查看模版管理
**请求URL:** design/masterplate/info
**请求方式:** GET
**内容类型:** application/json;charset=utf-8
**简要描述:** 查看模版管理，返回实例详细信息
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:------
id|Long|是|ID
**请求样例:**
```
http://localhost/design/masterplate/info?id=549
```
**响应参数:**
参数名称 |参数类型|描述
:---|:---|:-------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
 id|Long|主键ID，主键，自增长
 masterplateName|Long|模版名称
 masterplateCode|Integer|模版编码
 customerId|Long|发布人
 customerName|String|发布人名称
 createTime|Date|发布时间
 masterplateDesc|String|模版描述
 masterplatePath|String|模版下载地址（相对地址）
 pictureId|Long|模版引用的图片
 pictureSrcId|Long|模版引用的素材
 pictureBackgroundId|Long|模版引用的背景
 fontId|Long|模版引用的字体
 masterplateUseNum|Integer|模版被引用的次数。默认：0
dict|object|字典对象
**响应消息样例:**
```
{
"code": 1,
"data": {
"id":3739,
"masterplateName":5324,
"masterplateCode":991,
"customerId":3972,
"customerName":"h63heb",
"createTime":"2022-06-07",
"masterplateDesc":"vie8gy",
"masterplatePath":"728s32",
"pictureId":2124,
"pictureSrcId":1697,
"pictureBackgroundId":5464,
"fontId":6997,
"masterplateUseNum":1164
}
}
```
### 保存更新模版管理
**请求URL:** design/masterplate/save
**请求方式:** POST
**内容类型:** application/json;charset=utf-8
**简要描述:** 保存或更新模版管理：id为空时为新增保存，否则为更新提交
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:-------
masterplateName|Long|是|模版名称
masterplateCode|Integer|是|模版编码
customerId|Long|是|发布人
customerName|String|是|发布人名称
masterplateDesc|String|是|模版描述
masterplatePath|String|是|模版下载地址（相对地址）
pictureId|Long|是|模版引用的图片
pictureSrcId|Long|是|模版引用的素材
pictureBackgroundId|Long|是|模版引用的背景
fontId|Long|是|模版引用的字体
masterplateUseNum|Integer|是|模版被引用的次数。默认：0
**请求样例:**
```
{
"masterplateName":3572,
"masterplateCode":6224,
"customerId":4597,
"customerName":"p7t0cu",
"masterplateDesc":"fv1y8x",
"masterplatePath":"rvy160",
"pictureId":764,
"pictureSrcId":3006,
"pictureBackgroundId":1837,
"fontId":5208,
"masterplateUseNum":5382
}
```
**响应参数:**
参数名称 |参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
 id|Long|保存后主键id
 entity|object|保存更新实体
  id|Long|主键ID，主键，自增长
  masterplateName|Long|模版名称
  masterplateCode|Integer|模版编码
  customerId|Long|发布人
  customerName|String|发布人名称
  createTime|Date|发布时间
  masterplateDesc|String|模版描述
  masterplatePath|String|模版下载地址（相对地址）
  pictureId|Long|模版引用的图片
  pictureSrcId|Long|模版引用的素材
  pictureBackgroundId|Long|模版引用的背景
  fontId|Long|模版引用的字体
  masterplateUseNum|Integer|模版被引用的次数。默认：0
**响应消息样例:**
```
{
"msg":"新增模块成功",
"code":1,
"data":{}
}
}
```
### 删除模版管理
**请求URL:** design/masterplate/delete
**请求方式:** GET **请求方式:** GET
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 删除客户试用申请 **简要描述:** 删除模版管理
**请求参数:** **请求参数:**
...@@ -702,7 +2033,7 @@ id|String|是|数组 ...@@ -702,7 +2033,7 @@ id|String|是|数组
**请求样例:** **请求样例:**
``` ```
http://localhost:8080/customer/trial/delete?id=1&id=2' http://localhost:8080/design/masterplate/delete?id=1,2'
``` ```
**响应参数:** **响应参数:**
...@@ -719,17 +2050,17 @@ msg|String|消息|- ...@@ -719,17 +2050,17 @@ msg|String|消息|-
} }
``` ```
## 客户作品统计 ## 模版使用信息
### 查询客户作品统计列表 ### 查询模版使用信息列表
**请求URL:** customer/work/design/stat/list **请求URL:** masterplate/use/info/list
**请求方式:** POST **请求方式:** POST
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 查询客户作品统计 **简要描述:** 查询模版使用信息
**请求参数:** **请求参数:**
...@@ -759,11 +2090,12 @@ data|object|数据对象 ...@@ -759,11 +2090,12 @@ data|object|数据对象
 current_page|Integer|当前页  current_page|Integer|当前页
 data|array|结果集列表|数组  data|array|结果集列表|数组
  id|Long|主键ID，主键，自增长   id|Long|主键ID，主键，自增长
  customerId|Long|客户ID   masterplateId|Long|模版ID
  customerDesignPictures|Integer|客户设计图片数量   customerId|Long|使用人ID
  customerDesignVideos|Integer|客户设计视频数量   customerName|String|使用人
  createTime|Date|注册时间   customerTelphone|String|使用人电话
  updateTime|Date|更新时间   createTime|Date|使用时间
  customerOrganization|String|使用人单位
dict|object|字典对象 dict|object|字典对象
**响应消息样例:** **响应消息样例:**
...@@ -775,15 +2107,15 @@ dict|object|字典对象 ...@@ -775,15 +2107,15 @@ dict|object|字典对象
} }
``` ```
### 查看客户作品统计 ### 查看模版使用信息
**请求URL:** customer/work/design/stat/info **请求URL:** masterplate/use/info/info
**请求方式:** GET **请求方式:** GET
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 查看客户作品统计，返回实例详细信息 **简要描述:** 查看模版使用信息，返回实例详细信息
**请求参数:** **请求参数:**
...@@ -793,7 +2125,7 @@ id|Long|是|ID ...@@ -793,7 +2125,7 @@ id|Long|是|ID
**请求样例:** **请求样例:**
``` ```
http://localhost/customer/work/design/stat/info?id=549 http://localhost/masterplate/use/info/info?id=549
``` ```
**响应参数:** **响应参数:**
...@@ -803,11 +2135,12 @@ code|Integer|结果码（-1.失败，1.成功） ...@@ -803,11 +2135,12 @@ code|Integer|结果码（-1.失败，1.成功）
msg|String|消息 msg|String|消息
data|object|数据对象 data|object|数据对象
 id|Long|主键ID，主键，自增长  id|Long|主键ID，主键，自增长
 customerId|Long|客户ID  masterplateId|Long|模版ID
 customerDesignPictures|Integer|客户设计图片数量  customerId|Long|使用人ID
 customerDesignVideos|Integer|客户设计视频数量  customerName|String|使用人
 createTime|Date|注册时间  customerTelphone|String|使用人电话
 updateTime|Date|更新时间  createTime|Date|使用时间
 customerOrganization|String|使用人单位
dict|object|字典对象 dict|object|字典对象
**响应消息样例:** **响应消息样例:**
...@@ -815,40 +2148,45 @@ dict|object|字典对象 ...@@ -815,40 +2148,45 @@ dict|object|字典对象
{ {
"code": 1, "code": 1,
"data": { "data": {
"id":8363, "id":3561,
"customerId":2122, "masterplateId":2656,
"customerDesignPictures":3742, "customerId":1717,
"customerDesignVideos":3563, "customerName":"yoxp50",
"customerTelphone":"620s1u",
"createTime":"2022-06-07", "createTime":"2022-06-07",
"updateTime":"2022-06-07" "customerOrganization":"tnjilm"
} }
} }
``` ```
### 保存更新客户作品统计 ### 保存更新模版使用信息
**请求URL:** customer/work/design/stat/save **请求URL:** masterplate/use/info/save
**请求方式:** POST **请求方式:** POST
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 保存或更新客户作品统计：id为空时为新增保存，否则为更新提交 **简要描述:** 保存或更新模版使用信息：id为空时为新增保存，否则为更新提交
**请求参数:** **请求参数:**
参数名称|类型|必填|描述 参数名称|类型|必填|描述
:---|:---|:---|:------- :---|:---|:---|:-------
customerId|Long|是|客户ID masterplateId|Long|是|模版ID
customerDesignPictures|Integer|是|客户设计图片数量 customerId|Long|是|使用人ID
customerDesignVideos|Integer|是|客户设计视频数量 customerName|String|是|使用人
customerTelphone|String|是|使用人电话
customerOrganization|String|是|使用人单位
**请求样例:** **请求样例:**
``` ```
{ {
"customerId":1077, "masterplateId":9714,
"customerDesignPictures":9239, "customerId":9898,
"customerDesignVideos":8101, "customerName":"qvydgg",
"customerTelphone":"45caxw",
"customerOrganization":"9poakn"
} }
``` ```
...@@ -862,11 +2200,12 @@ data|object|数据对象 ...@@ -862,11 +2200,12 @@ data|object|数据对象
 id|Long|保存后主键id  id|Long|保存后主键id
 entity|object|保存更新实体  entity|object|保存更新实体
  id|Long|主键ID，主键，自增长   id|Long|主键ID，主键，自增长
  customerId|Long|客户ID   masterplateId|Long|模版ID
  customerDesignPictures|Integer|客户设计图片数量   customerId|Long|使用人ID
  customerDesignVideos|Integer|客户设计视频数量   customerName|String|使用人
  createTime|Date|注册时间   customerTelphone|String|使用人电话
  updateTime|Date|更新时间   createTime|Date|使用时间
  customerOrganization|String|使用人单位
**响应消息样例:** **响应消息样例:**
``` ```
...@@ -879,15 +2218,15 @@ data|object|数据对象 ...@@ -879,15 +2218,15 @@ data|object|数据对象
``` ```
### 删除客户作品统计 ### 删除模版使用信息
**请求URL:** customer/work/design/stat/delete **请求URL:** masterplate/use/info/delete
**请求方式:** GET **请求方式:** GET
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 删除客户作品统计 **简要描述:** 删除模版使用信息
**请求参数:** **请求参数:**
...@@ -897,7 +2236,7 @@ id|String|是|数组 ...@@ -897,7 +2236,7 @@ id|String|是|数组
**请求样例:** **请求样例:**
``` ```
http://localhost:8080/customer/work/design/stat/delete?id=1&id=2' http://localhost:8080/masterplate/use/info/delete?id=1&id=2'
``` ```
**响应参数:** **响应参数:**
...@@ -914,17 +2253,17 @@ msg|String|消息|- ...@@ -914,17 +2253,17 @@ msg|String|消息|-
} }
``` ```
## 客户作品信息 ## 字体素材
### 查询客户作品信息列表 ### 查询字体素材列表
**请求URL:** customer/work/design/list **请求URL:** font/material/list
**请求方式:** POST **请求方式:** POST
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 查询客户作品信息 **简要描述:** 查询字体素材
**请求参数:** **请求参数:**
...@@ -954,9 +2293,11 @@ data|object|数据对象 ...@@ -954,9 +2293,11 @@ data|object|数据对象
 current_page|Integer|当前页  current_page|Integer|当前页
 data|array|结果集列表|数组  data|array|结果集列表|数组
  id|Long|主键ID，主键，自增长   id|Long|主键ID，主键，自增长
  customerId|Long|客户ID   fontName|String|字体名称
  createTime|Date|收藏时间   createUserId|Long|上传人
  masterplateId|Long|模版ID   createTime|Date|上传时间
  fontDesc|String|字体描述
  fontPath|String|字体下载地址（相对地址）
dict|object|字典对象 dict|object|字典对象
**响应消息样例:** **响应消息样例:**
...@@ -968,15 +2309,15 @@ dict|object|字典对象 ...@@ -968,15 +2309,15 @@ dict|object|字典对象
} }
``` ```
### 查看客户作品信息 ### 查看字体素材
**请求URL:** customer/work/design/info **请求URL:** font/material/info
**请求方式:** GET **请求方式:** GET
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 查看客户作品信息，返回实例详细信息 **简要描述:** 查看字体素材，返回实例详细信息
**请求参数:** **请求参数:**
...@@ -986,7 +2327,7 @@ id|Long|是|ID ...@@ -986,7 +2327,7 @@ id|Long|是|ID
**请求样例:** **请求样例:**
``` ```
http://localhost/customer/work/design/info?id=549 http://localhost/font/material/info?id=549
``` ```
**响应参数:** **响应参数:**
...@@ -996,9 +2337,11 @@ code|Integer|结果码（-1.失败，1.成功） ...@@ -996,9 +2337,11 @@ code|Integer|结果码（-1.失败，1.成功）
msg|String|消息 msg|String|消息
data|object|数据对象 data|object|数据对象
 id|Long|主键ID，主键，自增长  id|Long|主键ID，主键，自增长
 customerId|Long|客户ID  fontName|String|字体名称
 createTime|Date|收藏时间  createUserId|Long|上传人
 masterplateId|Long|模版ID  createTime|Date|上传时间
 fontDesc|String|字体描述
 fontPath|String|字体下载地址（相对地址）
dict|object|字典对象 dict|object|字典对象
**响应消息样例:** **响应消息样例:**
...@@ -1006,36 +2349,40 @@ dict|object|字典对象 ...@@ -1006,36 +2349,40 @@ dict|object|字典对象
{ {
"code": 1, "code": 1,
"data": { "data": {
"id":2739, "id":7597,
"customerId":7423, "fontName":"pvtj4a",
"createUserId":9651,
"createTime":"2022-06-07", "createTime":"2022-06-07",
"masterplateId":4628 "fontDesc":"tuhypa",
"fontPath":"dug8lu"
} }
} }
``` ```
### 保存更新客户作品信息 ### 保存更新字体素材
**请求URL:** customer/work/design/save **请求URL:** font/material/save
**请求方式:** POST **请求方式:** POST
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 保存或更新客户作品信息：id为空时为新增保存，否则为更新提交 **简要描述:** 保存或更新字体素材：id为空时为新增保存，否则为更新提交
**请求参数:** **请求参数:**
参数名称|类型|必填|描述 参数名称|类型|必填|描述
:---|:---|:---|:------- :---|:---|:---|:-------
customerId|Long|是|客户ID fontName|String|是|字体名称
masterplateId|Long|是|模版ID fontDesc|String|是|字体描述
fontPath|String|是|字体下载地址（相对地址）
**请求样例:** **请求样例:**
``` ```
{ {
"customerId":2890, "fontName":"jl0ole",
"masterplateId":6167 "fontDesc":"t2crnw",
"fontPath":"c3rwk2"
} }
``` ```
...@@ -1049,9 +2396,11 @@ data|object|数据对象 ...@@ -1049,9 +2396,11 @@ data|object|数据对象
 id|Long|保存后主键id  id|Long|保存后主键id
 entity|object|保存更新实体  entity|object|保存更新实体
  id|Long|主键ID，主键，自增长   id|Long|主键ID，主键，自增长
  customerId|Long|客户ID   fontName|String|字体名称
  createTime|Date|收藏时间   createUserId|Long|上传人
  masterplateId|Long|模版ID   createTime|Date|上传时间
  fontDesc|String|字体描述
  fontPath|String|字体下载地址（相对地址）
**响应消息样例:** **响应消息样例:**
``` ```
...@@ -1064,15 +2413,15 @@ data|object|数据对象 ...@@ -1064,15 +2413,15 @@ data|object|数据对象
``` ```
### 删除客户作品信息 ### 删除字体素材
**请求URL:** customer/work/design/delete **请求URL:** font/material/delete
**请求方式:** GET **请求方式:** GET
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 删除客户作品信息 **简要描述:** 删除字体素材
**请求参数:** **请求参数:**
...@@ -1082,7 +2431,7 @@ id|String|是|数组 ...@@ -1082,7 +2431,7 @@ id|String|是|数组
**请求样例:** **请求样例:**
``` ```
http://localhost:8080/customer/work/design/delete?id=1&id=2' http://localhost:8080/font/material/delete?id=1&id=2'
``` ```
**响应参数:** **响应参数:**
...@@ -1099,22 +2448,23 @@ msg|String|消息|- ...@@ -1099,22 +2448,23 @@ msg|String|消息|-
} }
``` ```
## 模版管理 ## 图片管理
### 查询模版管理列表 ### 查询图片列表
**请求URL:** design/masterplate/list **请求URL:** picture/material/list
**请求方式:** POST **请求方式:** POST
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 查询模版管理 **简要描述:** 查询图片素材
**请求参数:** **请求参数:**
参数名称|类型|必填|描述 参数名称|类型|必填|描述
:---|:---|:---|:------ :---|:---|:---|:------
pictureClassifyId|Integer|否|分类id
page|Integer|否|当前页 page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录 size|Integer|否|每页条数，值为-1，查询所有记录
...@@ -1139,18 +2489,14 @@ data|object|数据对象 ...@@ -1139,18 +2489,14 @@ data|object|数据对象
 current_page|Integer|当前页  current_page|Integer|当前页
 data|array|结果集列表|数组  data|array|结果集列表|数组
  id|Long|主键ID，主键，自增长   id|Long|主键ID，主键，自增长
  masterplateName|Long|模版名称   pictureName|String|图片名称
  masterplateCode|Integer|模版编码   pictureGroupId|Long|图片分组（系统参数中获取，字典数据）
  customerId|Long|发布人   pictureClassifyId|Long|图片分类（系统参数中获取，字典数据）
  customerName|String|发布人名称   createUserId|Long|上传人
  createTime|Date|发布时间   createTime|Date|上传时间
  masterplateDesc|String|模版描述   pictureDesc|String|图片描述
  masterplatePath|String|模版下载地址（相对地址）   picturePath|String|图片下载地址（相对地址）
  pictureId|Long|模版引用的图片   pictureType|Integer|图片类型，0:普通图片，1：素材，2:背景图片。默认：0
  pictureSrcId|Long|模版引用的素材
  pictureBackgroundId|Long|模版引用的背景
  fontId|Long|模版引用的字体
  masterplateUseNum|Integer|模版被引用的次数。默认：0
dict|object|字典对象 dict|object|字典对象
**响应消息样例:** **响应消息样例:**
...@@ -1162,15 +2508,15 @@ dict|object|字典对象 ...@@ -1162,15 +2508,15 @@ dict|object|字典对象
} }
``` ```
### 查看模版管理 ### 查看图片
**请求URL:** design/masterplate/info **请求URL:** picture/material/info
**请求方式:** GET **请求方式:** GET
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 查看模版管理，返回实例详细信息 **简要描述:** 查看图片素材，返回实例详细信息
**请求参数:** **请求参数:**
...@@ -1180,7 +2526,7 @@ id|Long|是|ID ...@@ -1180,7 +2526,7 @@ id|Long|是|ID
**请求样例:** **请求样例:**
``` ```
http://localhost/design/masterplate/info?id=549 http://localhost/picture/material/info?id=549
``` ```
**响应参数:** **响应参数:**
...@@ -1190,18 +2536,14 @@ code|Integer|结果码（-1.失败，1.成功） ...@@ -1190,18 +2536,14 @@ code|Integer|结果码（-1.失败，1.成功）
msg|String|消息 msg|String|消息
data|object|数据对象 data|object|数据对象
 id|Long|主键ID，主键，自增长  id|Long|主键ID，主键，自增长
 masterplateName|Long|模版名称  pictureName|String|图片名称
 masterplateCode|Integer|模版编码  pictureGroupId|Long|图片分组（系统参数中获取，字典数据）
 customerId|Long|发布人  pictureClassifyId|Long|图片分类（系统参数中获取，字典数据）
 customerName|String|发布人名称  createUserId|Long|上传人
 createTime|Date|发布时间  createTime|Date|上传时间
 masterplateDesc|String|模版描述  pictureDesc|String|图片描述
 masterplatePath|String|模版下载地址（相对地址）  picturePath|String|图片下载地址（相对地址）
 pictureId|Long|模版引用的图片  pictureType|Integer|图片类型，0:普通图片，1：素材，2:背景图片。默认：0
 pictureSrcId|Long|模版引用的素材
 pictureBackgroundId|Long|模版引用的背景
 fontId|Long|模版引用的字体
 masterplateUseNum|Integer|模版被引用的次数。默认：0
dict|object|字典对象 dict|object|字典对象
**响应消息样例:** **响应消息样例:**
...@@ -1209,63 +2551,49 @@ dict|object|字典对象 ...@@ -1209,63 +2551,49 @@ dict|object|字典对象
{ {
"code": 1, "code": 1,
"data": { "data": {
"id":3739, "id":9341,
"masterplateName":5324, "pictureName":"6qmm5s",
"masterplateCode":991, "pictureGroupId":7443,
"customerId":3972, "pictureClassifyId":8240,
"customerName":"h63heb", "createUserId":9070,
"createTime":"2022-06-07", "createTime":"2022-06-07",
"masterplateDesc":"vie8gy", "pictureDesc":"yjnw7d",
"masterplatePath":"728s32", "picturePath":"x9ujzr",
"pictureId":2124, "pictureType":1898
"pictureSrcId":1697,
"pictureBackgroundId":5464,
"fontId":6997,
"masterplateUseNum":1164
} }
} }
``` ```
### 保存更新模版管理 ### 保存更新图片
**请求URL:** design/masterplate/save **请求URL:** picture/material/save
**请求方式:** POST **请求方式:** POST
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 保存或更新模版管理：id为空时为新增保存，否则为更新提交 **简要描述:** 保存或更新图片素材：id为空时为新增保存，否则为更新提交
**请求参数:** **请求参数:**
参数名称|类型|必填|描述 参数名称|类型|必填|描述
:---|:---|:---|:------- :---|:---|:---|:-------
masterplateName|Long|是|模版名称 pictureName|String|是|图片名称
masterplateCode|Integer|是|模版编码 pictureGroupId|Long|是|图片分组（系统参数中获取，字典数据）
customerId|Long|是|发布人 pictureClassifyId|Long|是|图片分类（系统参数中获取，字典数据）
customerName|String|是|发布人名称 pictureDesc|String|是|图片描述
masterplateDesc|String|是|模版描述 picturePath|String|是|图片下载地址（相对地址）
masterplatePath|String|是|模版下载地址（相对地址） pictureType|Integer|是|图片类型，0:普通图片，1：素材，2:背景图片。默认：0
pictureId|Long|是|模版引用的图片
pictureSrcId|Long|是|模版引用的素材
pictureBackgroundId|Long|是|模版引用的背景
fontId|Long|是|模版引用的字体
masterplateUseNum|Integer|是|模版被引用的次数。默认：0
**请求样例:** **请求样例:**
``` ```
{ {
"masterplateName":3572, "pictureName":"j02qry",
"masterplateCode":6224, "pictureGroupId":2308,
"customerId":4597, "pictureClassifyId":4554,
"customerName":"p7t0cu", "pictureDesc":"ludurj",
"masterplateDesc":"fv1y8x", "picturePath":"vaj5fe",
"masterplatePath":"rvy160", "pictureType":9733
"pictureId":764,
"pictureSrcId":3006,
"pictureBackgroundId":1837,
"fontId":5208,
"masterplateUseNum":5382
} }
``` ```
...@@ -1279,18 +2607,14 @@ data|object|数据对象 ...@@ -1279,18 +2607,14 @@ data|object|数据对象
 id|Long|保存后主键id  id|Long|保存后主键id
 entity|object|保存更新实体  entity|object|保存更新实体
  id|Long|主键ID，主键，自增长   id|Long|主键ID，主键，自增长
  masterplateName|Long|模版名称   pictureName|String|图片名称
  masterplateCode|Integer|模版编码   pictureGroupId|Long|图片分组（系统参数中获取，字典数据）
  customerId|Long|发布人   pictureClassifyId|Long|图片分类（系统参数中获取，字典数据）
  customerName|String|发布人名称   createUserId|Long|上传人
  createTime|Date|发布时间   createTime|Date|上传时间
  masterplateDesc|String|模版描述   pictureDesc|String|图片描述
  masterplatePath|String|模版下载地址（相对地址）   picturePath|String|图片下载地址（相对地址）
  pictureId|Long|模版引用的图片   pictureType|Integer|图片类型，0:普通图片，1：素材，2:背景图片。默认：0
  pictureSrcId|Long|模版引用的素材
  pictureBackgroundId|Long|模版引用的背景
  fontId|Long|模版引用的字体
  masterplateUseNum|Integer|模版被引用的次数。默认：0
**响应消息样例:** **响应消息样例:**
``` ```
...@@ -1303,15 +2627,15 @@ data|object|数据对象 ...@@ -1303,15 +2627,15 @@ data|object|数据对象
``` ```
### 删除模版管理 ### 删除图片
**请求URL:** design/masterplate/delete **请求URL:** picture/material/delete
**请求方式:** GET **请求方式:** GET
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 删除模版管理 **简要描述:** 删除图片素材
**请求参数:** **请求参数:**
...@@ -1321,7 +2645,7 @@ id|String|是|数组 ...@@ -1321,7 +2645,7 @@ id|String|是|数组
**请求样例:** **请求样例:**
``` ```
http://localhost:8080/design/masterplate/delete?id=1&id=2' http://localhost:8080/picture/material/delete?id=1,2'
``` ```
**响应参数:** **响应参数:**
...@@ -1338,22 +2662,23 @@ msg|String|消息|- ...@@ -1338,22 +2662,23 @@ msg|String|消息|-
} }
``` ```
## 模版使用信息 ## 素材管理
### 查询模版使用信息列表 ### 查询素材列表
**请求URL:** masterplate/use/info/list **请求URL:** element/material/list
**请求方式:** POST **请求方式:** POST
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 查询模版使用信息 **简要描述:** 查询素材
**请求参数:** **请求参数:**
参数名称|类型|必填|描述 参数名称|类型|必填|描述
:---|:---|:---|:------ :---|:---|:---|:------
pictureClassifyId|Integer|否|分类id
page|Integer|否|当前页 page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录 size|Integer|否|每页条数，值为-1，查询所有记录
...@@ -1378,12 +2703,14 @@ data|object|数据对象 ...@@ -1378,12 +2703,14 @@ data|object|数据对象
 current_page|Integer|当前页  current_page|Integer|当前页
 data|array|结果集列表|数组  data|array|结果集列表|数组
  id|Long|主键ID，主键，自增长   id|Long|主键ID，主键，自增长
  masterplateId|Long|模版ID   pictureName|String|图片名称
  customerId|Long|使用人ID   pictureGroupId|Long|图片分组（系统参数中获取，字典数据）
  customerName|String|使用人   pictureClassifyId|Long|图片分类（系统参数中获取，字典数据）
  customerTelphone|String|使用人电话   createUserId|Long|上传人
  createTime|Date|使用时间   createTime|Date|上传时间
  customerOrganization|String|使用人单位   pictureDesc|String|图片描述
  picturePath|String|图片下载地址（相对地址）
  pictureType|Integer|图片类型，0:普通图片，1：素材，2:背景图片。默认：0
dict|object|字典对象 dict|object|字典对象
**响应消息样例:** **响应消息样例:**
...@@ -1395,15 +2722,15 @@ dict|object|字典对象 ...@@ -1395,15 +2722,15 @@ dict|object|字典对象
} }
``` ```
### 查看模版使用信息 ### 查看素材
**请求URL:** masterplate/use/info/info **请求URL:** element/material/info
**请求方式:** GET **请求方式:** GET
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 查看模版使用信息，返回实例详细信息 **简要描述:** 查看图片素材，返回实例详细信息
**请求参数:** **请求参数:**
...@@ -1413,7 +2740,7 @@ id|Long|是|ID ...@@ -1413,7 +2740,7 @@ id|Long|是|ID
**请求样例:** **请求样例:**
``` ```
http://localhost/masterplate/use/info/info?id=549 http://localhost/element/material/info?id=549
``` ```
**响应参数:** **响应参数:**
...@@ -1423,12 +2750,14 @@ code|Integer|结果码（-1.失败，1.成功） ...@@ -1423,12 +2750,14 @@ code|Integer|结果码（-1.失败，1.成功）
msg|String|消息 msg|String|消息
data|object|数据对象 data|object|数据对象
 id|Long|主键ID，主键，自增长  id|Long|主键ID，主键，自增长
 masterplateId|Long|模版ID  pictureName|String|图片名称
 customerId|Long|使用人ID  pictureGroupId|Long|图片分组（系统参数中获取，字典数据）
 customerName|String|使用人  pictureClassifyId|Long|图片分类（系统参数中获取，字典数据）
 customerTelphone|String|使用人电话  createUserId|Long|上传人
 createTime|Date|使用时间  createTime|Date|上传时间
 customerOrganization|String|使用人单位  pictureDesc|String|图片描述
 picturePath|String|图片下载地址（相对地址）
 pictureType|Integer|图片类型，0:普通图片，1：素材，2:背景图片。默认：0
dict|object|字典对象 dict|object|字典对象
**响应消息样例:** **响应消息样例:**
...@@ -1436,45 +2765,49 @@ dict|object|字典对象 ...@@ -1436,45 +2765,49 @@ dict|object|字典对象
{ {
"code": 1, "code": 1,
"data": { "data": {
"id":3561, "id":9341,
"masterplateId":2656, "pictureName":"6qmm5s",
"customerId":1717, "pictureGroupId":7443,
"customerName":"yoxp50", "pictureClassifyId":8240,
"customerTelphone":"620s1u", "createUserId":9070,
"createTime":"2022-06-07", "createTime":"2022-06-07",
"customerOrganization":"tnjilm" "pictureDesc":"yjnw7d",
"picturePath":"x9ujzr",
"pictureType":1898
} }
} }
``` ```
### 保存更新模版使用信息 ### 保存更新素材
**请求URL:** masterplate/use/info/save **请求URL:** element/material/save
**请求方式:** POST **请求方式:** POST
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 保存或更新模版使用信息：id为空时为新增保存，否则为更新提交 **简要描述:** 保存或更新图片素材：id为空时为新增保存，否则为更新提交
**请求参数:** **请求参数:**
参数名称|类型|必填|描述 参数名称|类型|必填|描述
:---|:---|:---|:------- :---|:---|:---|:-------
masterplateId|Long|是|模版ID pictureName|String|是|图片名称
customerId|Long|是|使用人ID pictureGroupId|Long|是|图片分组（系统参数中获取，字典数据）
customerName|String|是|使用人 pictureClassifyId|Long|是|图片分类（系统参数中获取，字典数据）
customerTelphone|String|是|使用人电话 pictureDesc|String|是|图片描述
customerOrganization|String|是|使用人单位 picturePath|String|是|图片下载地址（相对地址）
pictureType|Integer|是|图片类型，0:普通图片，1：素材，2:背景图片。默认：0
**请求样例:** **请求样例:**
``` ```
{ {
"masterplateId":9714, "pictureName":"j02qry",
"customerId":9898, "pictureGroupId":2308,
"customerName":"qvydgg", "pictureClassifyId":4554,
"customerTelphone":"45caxw", "pictureDesc":"ludurj",
"customerOrganization":"9poakn" "picturePath":"vaj5fe",
"pictureType":9733
} }
``` ```
...@@ -1488,12 +2821,14 @@ data|object|数据对象 ...@@ -1488,12 +2821,14 @@ data|object|数据对象
 id|Long|保存后主键id  id|Long|保存后主键id
 entity|object|保存更新实体  entity|object|保存更新实体
  id|Long|主键ID，主键，自增长   id|Long|主键ID，主键，自增长
  masterplateId|Long|模版ID   pictureName|String|图片名称
  customerId|Long|使用人ID   pictureGroupId|Long|图片分组（系统参数中获取，字典数据）
  customerName|String|使用人   pictureClassifyId|Long|图片分类（系统参数中获取，字典数据）
  customerTelphone|String|使用人电话   createUserId|Long|上传人
  createTime|Date|使用时间   createTime|Date|上传时间
  customerOrganization|String|使用人单位   pictureDesc|String|图片描述
  picturePath|String|图片下载地址（相对地址）
  pictureType|Integer|图片类型，0:普通图片，1：素材，2:背景图片。默认：0
**响应消息样例:** **响应消息样例:**
``` ```
...@@ -1506,15 +2841,15 @@ data|object|数据对象 ...@@ -1506,15 +2841,15 @@ data|object|数据对象
``` ```
### 删除模版使用信息 ### 删除素材
**请求URL:** masterplate/use/info/delete **请求URL:** element/material/delete
**请求方式:** GET **请求方式:** GET
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 删除模版使用信息 **简要描述:** 删除图片素材
**请求参数:** **请求参数:**
...@@ -1524,7 +2859,7 @@ id|String|是|数组 ...@@ -1524,7 +2859,7 @@ id|String|是|数组
**请求样例:** **请求样例:**
``` ```
http://localhost:8080/masterplate/use/info/delete?id=1&id=2' http://localhost:8080/element/material/delete?id=1,2'
``` ```
**响应参数:** **响应参数:**
...@@ -1541,22 +2876,23 @@ msg|String|消息|- ...@@ -1541,22 +2876,23 @@ msg|String|消息|-
} }
``` ```
## 图片素材 ## 背景管理
### 查询图片素材列表 ### 查询图片列表
**请求URL:** picture/material/list **请求URL:** background/material/list
**请求方式:** POST **请求方式:** POST
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 查询图片素材 **简要描述:** 查询背景图片素材
**请求参数:** **请求参数:**
参数名称|类型|必填|描述 参数名称|类型|必填|描述
:---|:---|:---|:------ :---|:---|:---|:------
pictureClassifyId|Integer|否|分类id
page|Integer|否|当前页 page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录 size|Integer|否|每页条数，值为-1，查询所有记录
...@@ -1600,15 +2936,15 @@ dict|object|字典对象 ...@@ -1600,15 +2936,15 @@ dict|object|字典对象
} }
``` ```
### 查看图片素材 ### 查看背景图片
**请求URL:** picture/material/info **请求URL:** background/material/info
**请求方式:** GET **请求方式:** GET
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 查看图片素材，返回实例详细信息 **简要描述:** 查看背景图片素材，返回实例详细信息
**请求参数:** **请求参数:**
...@@ -1618,7 +2954,7 @@ id|Long|是|ID ...@@ -1618,7 +2954,7 @@ id|Long|是|ID
**请求样例:** **请求样例:**
``` ```
http://localhost/picture/material/info?id=549 http://localhost/background/material/info?id=549
``` ```
**响应参数:** **响应参数:**
...@@ -1656,9 +2992,9 @@ dict|object|字典对象 ...@@ -1656,9 +2992,9 @@ dict|object|字典对象
} }
``` ```
### 保存更新图片素材 ### 保存更新背景图片
**请求URL:** picture/material/save **请求URL:** background/material/save
**请求方式:** POST **请求方式:** POST
...@@ -1719,9 +3055,9 @@ data|object|数据对象 ...@@ -1719,9 +3055,9 @@ data|object|数据对象
``` ```
### 删除图片素材 ### 删除背景图片
**请求URL:** picture/material/delete **请求URL:** background/material/delete
**请求方式:** GET **请求方式:** GET
...@@ -1737,7 +3073,7 @@ id|String|是|数组 ...@@ -1737,7 +3073,7 @@ id|String|是|数组
**请求样例:** **请求样例:**
``` ```
http://localhost:8080/picture/material/delete?id=1&id=2' http://localhost:8080/background/material/delete?id=1,2'
``` ```
**响应参数:** **响应参数:**
...@@ -1754,30 +3090,25 @@ msg|String|消息|- ...@@ -1754,30 +3090,25 @@ msg|String|消息|-
} }
``` ```
## 字体素材 ## 素材分组管理
### 查询字体素材列表 ### 查询分组列表
**请求URL:** font/material/list **请求URL:** material/group/list
**请求方式:** POST **请求方式:** POST
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 查询字体素材 **简要描述:** 查询图片素材
**请求参数:** **请求参数:**
参数名称|类型|必填|描述 无
:---|:---|:---|:------
page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录
**请求样例:** **请求样例:**
``` ```
{ {
"page":1,
"size":10
} }
``` ```
...@@ -1788,61 +3119,11 @@ size|Integer|否|每页条数，值为-1，查询所有记录 ...@@ -1788,61 +3119,11 @@ size|Integer|否|每页条数，值为-1，查询所有记录
code|Integer|结果码（-1.失败，1.成功） code|Integer|结果码（-1.失败，1.成功）
msg|String|消息 msg|String|消息
data|object|数据对象 data|object|数据对象
 per_page|Integer|每页条数
 total|Integer|总条数
 last_page|Integer|总页数
 current_page|Integer|当前页
 data|array|结果集列表|数组  data|array|结果集列表|数组
  id|Long|主键ID，主键，自增长   id|Long|主键id
  fontName|String|字体名称   groupCount|Integer|图片数量
  createUserId|Long|上传人   pictureGroupId|Long|图片分组（系统参数中获取，字典数据）
  createTime|Date|上传时间   pictureGroupName|String|图片分组描述
  fontDesc|String|字体描述
  fontPath|String|字体下载地址（相对地址）
dict|object|字典对象
**响应消息样例:**
```
{
"code":1,
"data":{
}
}
```
### 查看字体素材
**请求URL:** font/material/info
**请求方式:** GET
**内容类型:** application/json;charset=utf-8
**简要描述:** 查看字体素材，返回实例详细信息
**请求参数:**
参数名称|类型|必填|描述
:---|:---|:---|:------
id|Long|是|ID
**请求样例:**
```
http://localhost/font/material/info?id=549
```
**响应参数:**
参数名称 |参数类型|描述
:---|:---|:-------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
 id|Long|主键ID，主键，自增长
 fontName|String|字体名称
 createUserId|Long|上传人
 createTime|Date|上传时间
 fontDesc|String|字体描述
 fontPath|String|字体下载地址（相对地址）
dict|object|字典对象 dict|object|字典对象
**响应消息样例:** **响应消息样例:**
...@@ -1850,40 +3131,58 @@ dict|object|字典对象 ...@@ -1850,40 +3131,58 @@ dict|object|字典对象
{ {
"code": 1, "code": 1,
"data": { "data": {
"id":7597, "data": [
"fontName":"pvtj4a", {
"createUserId":9651, "groupCount": 0,
"createTime":"2022-06-07", "id": 1,
"fontDesc":"tuhypa", "pictureGroupId": "1",
"fontPath":"dug8lu" "pictureGroupName": "党政"
} },
{
"groupCount": 0,
"id": 2,
"pictureGroupId": "2",
"pictureGroupName": "餐饮"
},
{
"groupCount": 0,
"id": 3,
"pictureGroupId": "3",
"pictureGroupName": "aaa"
},
{
"groupCount": 0,
"id": 4,
"pictureGroupId": "4",
"pictureGroupName": "测试数据"
}
]
}
} }
``` ```
### 保存更新字体素材 ### 添加图片分组
**请求URL:** font/material/save **请求URL:** material/group/save
**请求方式:** POST **请求方式:** POST
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 保存或更新字体素材：id为空时为新增保存，否则为更新提交 **简要描述:** 保存图片分组
**请求参数:** **请求参数:**
参数名称|类型|必填|描述 参数名称|类型|必填|描述
:---|:---|:---|:------- :---|:---|:---|:-------
fontName|String|是|字体名称 paramKey|String|是|图片分组（系统参数中获取，字典数据）
fontDesc|String|是|字体描述 paramValue|String|是|图片分组描述
fontPath|String|是|字体下载地址（相对地址）
**请求样例:** **请求样例:**
``` ```
{ {
"fontName":"jl0ole", "paramKey":"4",
"fontDesc":"t2crnw", "paramValue":"测试数据"
"fontPath":"c3rwk2"
} }
``` ```
...@@ -1896,43 +3195,68 @@ msg|String|消息 ...@@ -1896,43 +3195,68 @@ msg|String|消息
data|object|数据对象 data|object|数据对象
 id|Long|保存后主键id  id|Long|保存后主键id
 entity|object|保存更新实体  entity|object|保存更新实体
  id|Long|主键ID，主键，自增长   id|Long|序号，主键，自增长
  fontName|String|字体名称   name|String|参数名称
  createUserId|Long|上传人   firstOrganize|String|一级组织，如：平台配置
  createTime|Date|上传时间   secondOrganize|String|二级组织，如：基础配置
  fontDesc|String|字体描述   paramKey|String|参数键，全局唯一
  fontPath|String|字体下载地址（相对地址）   paramValue|String|参数值
  validStatus|Integer|参数有效状态，0：禁用，1：启用，默认1
  modStatus|Integer|参数修改状态，0：隐藏，1：页面仅查看，2：页面可修改，3：页面可删除，4：页面可修改删除，默认4
  displayType|Integer|展现类型，0：普通文本框，1：多行文本框，2：开关，3：块输入框，默认：0
  remark|String|备注
  createTime|Date|创建时间
  createUserId|Long|创建用户
  createUserName|String|创建用户名称
**响应消息样例:** **响应消息样例:**
``` ```
{ {
"msg":"新增模块成功", "msg": "新增素材分组成功",
"code":1, "code": 1,
"data":{} "data": {
"id": 5,
"entity": {
"createTime": 1655176782431,
"createUser": "admin",
"createUserId": 1,
"createUserName": "系统管理员a",
"deleted": 0,
"firstOrganize": "PictureMaterial",
"id": 5,
"name": "素材分组",
"paramKey": "5",
"paramValue": "测试数据啊",
"secondOrganize": "pictureGroupId",
"updateTime": 1655176782431,
"updateUser": "admin",
"updateUserId": 1,
"updateUserName": "系统管理员a"
}
} }
} }
``` ```
### 删除字体素材 ### 删除图片分组
**请求URL:** font/material/delete **请求URL:** material/group/delete
**请求方式:** GET **请求方式:** GET
**内容类型:** application/json;charset=utf-8 **内容类型:** application/json;charset=utf-8
**简要描述:** 删除字体素材 **简要描述:** 删除图片分组
**请求参数:** **请求参数:**
参数名称|类型|必填|描述 参数名称|类型|必填|描述
:---|:---|:---|:------ :---|:---|:---|:------
id|String|是|数组 id|String|是|主键id而非paramKey数组
**请求样例:** **请求样例:**
``` ```
http://localhost:8080/font/material/delete?id=1&id=2' http://localhost:8080/eas/material/group/delete/delete?id=1,2'
``` ```
**响应参数:** **响应参数:**
...@@ -1949,4 +3273,3 @@ msg|String|消息|- ...@@ -1949,4 +3273,3 @@ msg|String|消息|-
} }
``` ```
## 字典附录
eas-manager/src/main/java/com/mortals/xhx/module/customer/model/vo/CustomerVo.java
View file @ cd66bd4b
...@@ -16,4 +16,6 @@ public class CustomerVo extends BaseEntityLong { ...@@ -16,4 +16,6 @@ public class CustomerVo extends BaseEntityLong {
/** 查询条件 */ /** 查询条件 */
private String query; private String query;
/** 站点编码 */
private String siteCode="";
} }
\ No newline at end of file
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment