/system/dept/addDept
在用管理后台
#
部门-新增 · DeptController
基本信息
| 控制器 | com.jxxx.dscp.api.controller.system.DeptController#addDept |
|---|---|
| 所属模块 | 系统管理 system |
| 暴露渠道 | 管理后台 （@Route 注解；决定 URL 前缀与可访问端） |
| 请求方法 | POST |
调用链路 & 涉及数据表
涉及数据表
system_deptController
DeptController#addDept转换BeanUtils.map →
Dept ⇒ 表 system_deptService
DeptService#add （DeptServiceImpl）Mapper
DeptMapper#insert ⇒ 表 system_dept其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1
DeptService.mustGet
链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。
环境 URL
| 环境 | 完整 URL（主机 + 渠道前缀 + 路径） | 备注 |
|---|---|---|
| dev | https://dscp-dev.hn12301.net/manage-api/system/dept/addDept | |
| uat | https://dscp-uat.hn12301.net/manage-api/system/dept/addDept | |
| pro | https://dscp-uat.hn12301.net/manage-api/system/dept/addDept | （仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意） |
请求参数 · Header / Query / Path
无（该接口无 Query/Path/Header 显式参数；入参见 Body）
请求参数 · Body
DeptAddRequest| 字段 | 类型 | 必填 | 取值/校验 | 表 / 列 | 说明 |
|---|---|---|---|---|---|
| merchantId | Long | system_dept.merchant_id | 商户id | ||
| shopId | Long | system_dept.shop_id | 商铺id | ||
| name | String | 是 | 必填 | system_dept.name | 部门名称 |
| parentId | Long | 是 | 必填 | system_dept.parent_id | 父部门id |
| sort | Integer | 是 | 必填 | system_dept.sort | 显示顺序 |
| leaderUserId | Long | system_dept.leader_user_id | 负责人 | ||
| phone | String | system_dept.phone | 联系电话 | ||
| String | system_dept.email | 邮箱 | |||
| tenantId | Long | system_dept.tenant_id | 租户编号 |
响应参数
外层包装（chaos 框架自动；前端同时兼容 code/msg）
| errcode | int | 业务码，0=成功 |
| errmsg | string | 提示信息 |
| data | T | 下方“data 结构” |
data 结构
DeptResponse （object）| 字段 | 类型 | 必填 | 取值/校验 | 表 / 列 | 说明 |
|---|---|---|---|---|---|
| id | Long | system_dept.id | 部门id | ||
| merchantId | Long | system_dept.merchant_id | 商户id | ||
| merchantName | String | — | 商户名称 | ||
| shopId | Long | system_dept.shop_id | 商铺id | ||
| shopName | String | — | 商铺名称 | ||
| name | String | system_dept.name | 部门名称 | ||
| parentId | Long | system_dept.parent_id | 父部门id | ||
| sort | Integer | system_dept.sort | 显示顺序 | ||
| leaderUserId | Long | system_dept.leader_user_id | 负责人 | ||
| phone | String | system_dept.phone | 联系电话 | ||
| String | system_dept.email | 邮箱 | |||
| isEnabled | Boolean | system_dept.is_enabled | 是否启用(1启用0停用) |
示例
请求示例 （自动生成，仅结构参考）
POST /system/dept/addDept{
"body": {
"merchantId": 1,
"shopId": 1,
"name": "",
"parentId": 1,
"sort": 0,
"leaderUserId": 1,
"phone": "13800000000",
"email": "",
"tenantId": 1
}
}响应示例
{
"errcode": 0,
"errmsg": "",
"data": {
"id": 1,
"merchantId": 1,
"merchantName": "",
"shopId": 1,
"shopName": "",
"name": "",
"parentId": 1,
"sort": 0,
"leaderUserId": 1,
"phone": "13800000000",
"email": "",
"isEnabled": false
}
}处理逻辑
操作日志system / 新增部门
逻辑摘要调用 mustGet（deptService.mustGet）；新增（deptService.add）；入参与返回值经 BeanUtils 做对象/分页映射
内联注释
- 查询父部门信息
- 赋值