背景:
- A1 只实现了部门树读取与新建 / 改名接口,没有部门管理入口,
负责人、排序、停用状态都无法维护;
- 用户必须关联部门,部门无法维护会让 A2 的数据范围缺少组织基础。
改动:
- shared:DepartmentNode 增加 status / sortOrder / directMemberCount;
新增 createDepartmentInput / updateDepartmentInput / departmentTreeQuery 契约;
- api:GET /departments/tree?include_disabled;POST/PATCH /departments
(名称 / 负责人 / 排序);POST /departments/{id}/disable|enable;
只停用不删除,有在职成员 / 启用子部门 / 下级在职成员时禁止停用;
新建 / 编辑用户校验部门必须启用;@Audit 与 OpenAPI 同步;
- web:管理中心新增「部门管理」/system/departments,左两级组织树 +
右详情 / 内联编辑 + 新建部门/小组 + 停用启用二次确认;显示已停用、
?id= 选中可恢复、无 user:manage 只读;用户页部门选择仍只取启用部门;
- 测试:shared 契约、api 单测 + int、web 树/表单/接口单测同步。
影响面:
- 新增部门写接口与页面;GET tree 默认仍只返回启用部门,对用户页无破坏;
- 权限复用 user:view / user:manage,不新增权限点;
- 无数据库迁移(status / leader_user_id / sort_order 列已存在)。
回滚方式:
- 回滚本提交即移除部门管理页与写接口,保留原只读树;数据库无需回滚。
验证证据:
- pnpm format:check / lint / typecheck 全绿;
- pnpm test:shared 121 / api 90 / web 120;test:int 4 files / 33 tests;
- pnpm openapi:diff:无破坏性变更;
- 真实 API + 浏览器(jiang.lan):新建一级部门 / 小组、改名、停用空小组、
重名 40903、树/详情/停用确认均正常;
截图 design/a1-ui-v1/shots/impl/70-departments.png。
This commit is contained in:
1 parent
f4da1f3c02
commit
6661c42e84
33 files changed
+3237
-125
No files matched your search
@@ -82,7 +82,26 @@ export type RoleSummary = z.infer<typeof roleSummarySchema>;
|
||||
// 部门
|
||||
// ---------------------------------------------------------------------------
|
||||
|
||||
/** 部门 / 小组节点;parentId 为 null 表示一级部门(最多两级,见 MAX_DEPARTMENT_DEPTH) */
|
||||
/** 部门状态:停用后不出现在新建 / 编辑用户的部门选择中,历史数据保留 */
|
||||
export const DEPARTMENT_STATUSES = ['active', 'disabled'] as const;
|
||||
|
||||
export const departmentStatusSchema = z.enum(DEPARTMENT_STATUSES, {
|
||||
errorMap: () => ({ message: '部门状态只能是 active 或 disabled' }),
|
||||
});
|
||||
|
||||
export type DepartmentStatus = z.infer<typeof departmentStatusSchema>;
|
||||
|
||||
/** 部门名称:1–20 个字符(同级唯一由服务端校验) */
|
||||
export const departmentNameSchema = z
|
||||
.string()
|
||||
.trim()
|
||||
.min(1, '请输入部门名称')
|
||||
.max(20, '部门名称最多 20 个字符');
|
||||
|
||||
/**
|
||||
* 部门 / 小组节点;parentId 为 null 表示一级部门(最多两级,见 MAX_DEPARTMENT_DEPTH)。
|
||||
* memberCount 含下级成员,directMemberCount 仅本部门直属成员。
|
||||
*/
|
||||
export const departmentNodeSchema = z.object({
|
||||
id: ulidSchema,
|
||||
name: z.string().min(1, '部门名称不能为空'),
|
||||
@@ -93,12 +112,48 @@ export const departmentNodeSchema = z.object({
|
||||
name: z.string().min(1, '负责人姓名不能为空'),
|
||||
})
|
||||
.nullable(),
|
||||
status: departmentStatusSchema,
|
||||
sortOrder: z.number().int('排序必须是整数').min(0, '排序不能为负数'),
|
||||
memberCount: z.number().int('部门人数必须是整数').nonnegative('部门人数不能为负数'),
|
||||
directMemberCount: z.number().int('直属人数必须是整数').nonnegative('直属人数不能为负数'),
|
||||
createdAt: isoDateTimeSchema,
|
||||
});
|
||||
|
||||
export type DepartmentNode = z.infer<typeof departmentNodeSchema>;
|
||||
|
||||
/** 新建部门 / 小组:parentId 为 null 建一级部门,否则在该部门下建小组 */
|
||||
export const createDepartmentInputSchema = z
|
||||
.object({
|
||||
name: departmentNameSchema,
|
||||
parentId: ulidSchema.nullable().default(null),
|
||||
leaderUserId: ulidSchema.nullable().optional(),
|
||||
sortOrder: z.number().int().min(0).max(9999).optional(),
|
||||
})
|
||||
.strict();
|
||||
|
||||
export type CreateDepartmentInput = z.infer<typeof createDepartmentInputSchema>;
|
||||
|
||||
/** 更新部门:只允许改名称 / 负责人 / 排序;上级关系创建后不可移动 */
|
||||
export const updateDepartmentInputSchema = z
|
||||
.object({
|
||||
name: departmentNameSchema.optional(),
|
||||
leaderUserId: ulidSchema.nullable().optional(),
|
||||
sortOrder: z.number().int().min(0).max(9999).optional(),
|
||||
})
|
||||
.strict();
|
||||
|
||||
export type UpdateDepartmentInput = z.infer<typeof updateDepartmentInputSchema>;
|
||||
|
||||
/** 部门树查询:管理页需要包含已停用部门,普通选择器默认只看启用 */
|
||||
export const departmentTreeQuerySchema = z.object({
|
||||
include_disabled: z
|
||||
.enum(['true', 'false'])
|
||||
.default('false')
|
||||
.transform((value) => value === 'true'),
|
||||
});
|
||||
|
||||
export type DepartmentTreeQuery = z.infer<typeof departmentTreeQuerySchema>;
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 用户
|
||||
// ---------------------------------------------------------------------------
|
||||
|
||||
Reference in new issue
Block a user