index.ts
2.45 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
import request from '@/utils/request'
import { ADMIN_API_PREFIX } from '@/config'
/**
* 系统管理 - 组织
*
* 契约说明（新契约，与后端 parking-module-system 对齐）：
* - 前缀 /admin-api，回归 CommonResult{code=0}
* - 标准 CRUD URL 命名：/create /update /delete /delete-list /get /list /export-excel
* - 权限标识：system:org:create / update / delete / query / export
*
* 组织是**树形结构**（部门/组织层级），因此没有分页接口：/list 一次返回整棵树，
* 由前端用 el-table 的 row-key + children 字段递归渲染。
*
* ⚠️ 本项目用 `system_org`（不是 `system_dept`）：组织的 id 同时充当用户的
* 「部门」——登录信息里 orgId 与 deptId 是同一个值。
*/
const BASE = `${ADMIN_API_PREFIX}/system/org`
export interface OrgVO {
id: number
/** 父组织编号，顶层为 0 */
parentId?: number | null
name: string
sort?: number
leader?: string
mobile?: string
email?: string
/** 状态：0 启用，1 停用（字典 system_common_status） */
status?: number
/**
* 备注。
* 后端 OrgRespVO 必须下发它：编辑表单会整体提交该字段（updateById 覆盖整列），
* 不回显就会把库里的原备注静默清空。
*/
remark?: string
/** 创建时间（毫秒时间戳） */
createTime?: number
/** 下级组织，树形接口一次性下发 */
children?: OrgVO[]
}
export interface OrgListReqVO {
name?: string
}
export interface OrgSaveReqVO {
id?: number
parentId?: number | null
name: string
/** 必填（后端 @NotNull） */
sort: number
/** 必填（后端 @NotNull）：0 启用，1 停用 */
status: number
leader?: string
mobile?: string
email?: string
remark?: string
}
export const OrgApi = {
getOrgList: (params?: Partial<OrgListReqVO>) => request.get<OrgVO[]>(`${BASE}/list`, { params }),
getOrg: (id: number) => request.get<OrgVO>(`${BASE}/get`, { params: { id } }),
createOrg: (data: OrgSaveReqVO) => request.post<number>(`${BASE}/create`, data),
updateOrg: (data: OrgSaveReqVO) => request.put<boolean>(`${BASE}/update`, data),
deleteOrg: (id: number) => request.delete<boolean>(`${BASE}/delete`, { params: { id } }),
deleteOrgList: (ids: number[]) =>
request.delete<boolean>(`${BASE}/delete-list`, { params: { ids: ids.join(',') } }),
exportOrg: (params?: Partial<OrgListReqVO>) =>
request.download(`${BASE}/export-excel`, params, '组织列表.xlsx')
}