背景:
- 上一批部门管理接口(disable / enable、update、树与字段说明)合入后没有重新导出 OpenAPI,
apps/web/src/api/generated/openapi.d.ts 仍停留在「部门改名」版本,前端类型与真实契约不一致;
- pnpm ci:local 第 9 步 openapi:export 会自动重生成该文件,导致每次跑完工作区变脏。
改动:
- 执行 pnpm openapi:export,重新生成 apps/web/src/api/generated/openapi.d.ts
(新增 /departments/{id}/disable、/departments/{id}/enable、update 操作与字段说明)。
影响面:
- 仅前端生成类型,无运行时行为变化;openapi/lingxi.openapi.json 无差异。
回滚方式:
- 回滚本提交即恢复旧生成文件。
验证证据:
- pnpm openapi:diff 通过;
- pnpm ci:local 全部门禁通过。
This commit is contained in:
1 parent
087f27936e
commit
cda4b1825b
1 file changed
+88
-6
+88
-6
@@ -204,7 +204,10 @@ export interface paths {
|
|||||||
path?: never;
|
path?: never;
|
||||||
cookie?: never;
|
cookie?: never;
|
||||||
};
|
};
|
||||||
/** 部门树(两级,含成员数与负责人) */
|
/**
|
||||||
|
* 部门树(两级)
|
||||||
|
* @description memberCount 含下级成员、directMemberCount 仅本部门直属成员;默认只返回启用部门,管理页传 include_disabled=true
|
||||||
|
*/
|
||||||
get: operations['DepartmentsController_tree'];
|
get: operations['DepartmentsController_tree'];
|
||||||
put?: never;
|
put?: never;
|
||||||
post?: never;
|
post?: never;
|
||||||
@@ -225,7 +228,7 @@ export interface paths {
|
|||||||
put?: never;
|
put?: never;
|
||||||
/**
|
/**
|
||||||
* 新建部门 / 小组
|
* 新建部门 / 小组
|
||||||
* @description 最多两级,在小组下新建返回 42201
|
* @description 最多两级;父级必须启用;负责人必须是启用用户;同级重名返回 40903
|
||||||
*/
|
*/
|
||||||
post: operations['DepartmentsController_create'];
|
post: operations['DepartmentsController_create'];
|
||||||
delete?: never;
|
delete?: never;
|
||||||
@@ -247,8 +250,51 @@ export interface paths {
|
|||||||
delete?: never;
|
delete?: never;
|
||||||
options?: never;
|
options?: never;
|
||||||
head?: never;
|
head?: never;
|
||||||
/** 部门改名 */
|
/**
|
||||||
patch: operations['DepartmentsController_rename'];
|
* 更新部门(名称 / 负责人 / 排序)
|
||||||
|
* @description 上级关系创建后不可移动;负责人必须是启用用户
|
||||||
|
*/
|
||||||
|
patch: operations['DepartmentsController_update'];
|
||||||
|
trace?: never;
|
||||||
|
};
|
||||||
|
'/api/v1/departments/{id}/disable': {
|
||||||
|
parameters: {
|
||||||
|
query?: never;
|
||||||
|
header?: never;
|
||||||
|
path?: never;
|
||||||
|
cookie?: never;
|
||||||
|
};
|
||||||
|
get?: never;
|
||||||
|
put?: never;
|
||||||
|
/**
|
||||||
|
* 停用部门
|
||||||
|
* @description 本部门仍有在职成员、或一级部门存在启用中的下级小组 / 下级在职成员时返回 42201;已停用返回 40903
|
||||||
|
*/
|
||||||
|
post: operations['DepartmentsController_disable'];
|
||||||
|
delete?: never;
|
||||||
|
options?: never;
|
||||||
|
head?: never;
|
||||||
|
patch?: never;
|
||||||
|
trace?: never;
|
||||||
|
};
|
||||||
|
'/api/v1/departments/{id}/enable': {
|
||||||
|
parameters: {
|
||||||
|
query?: never;
|
||||||
|
header?: never;
|
||||||
|
path?: never;
|
||||||
|
cookie?: never;
|
||||||
|
};
|
||||||
|
get?: never;
|
||||||
|
put?: never;
|
||||||
|
/**
|
||||||
|
* 启用部门
|
||||||
|
* @description 上级必须启用;已启用返回 40903
|
||||||
|
*/
|
||||||
|
post: operations['DepartmentsController_enable'];
|
||||||
|
delete?: never;
|
||||||
|
options?: never;
|
||||||
|
head?: never;
|
||||||
|
patch?: never;
|
||||||
trace?: never;
|
trace?: never;
|
||||||
};
|
};
|
||||||
'/api/v1/roles': {
|
'/api/v1/roles': {
|
||||||
@@ -657,7 +703,9 @@ export interface operations {
|
|||||||
};
|
};
|
||||||
DepartmentsController_tree: {
|
DepartmentsController_tree: {
|
||||||
parameters: {
|
parameters: {
|
||||||
query?: never;
|
query?: {
|
||||||
|
include_disabled?: 'true' | 'false';
|
||||||
|
};
|
||||||
header?: never;
|
header?: never;
|
||||||
path?: never;
|
path?: never;
|
||||||
cookie?: never;
|
cookie?: never;
|
||||||
@@ -689,7 +737,41 @@ export interface operations {
|
|||||||
};
|
};
|
||||||
};
|
};
|
||||||
};
|
};
|
||||||
DepartmentsController_rename: {
|
DepartmentsController_update: {
|
||||||
|
parameters: {
|
||||||
|
query?: never;
|
||||||
|
header?: never;
|
||||||
|
path?: never;
|
||||||
|
cookie?: never;
|
||||||
|
};
|
||||||
|
requestBody?: never;
|
||||||
|
responses: {
|
||||||
|
200: {
|
||||||
|
headers: {
|
||||||
|
[name: string]: unknown;
|
||||||
|
};
|
||||||
|
content?: never;
|
||||||
|
};
|
||||||
|
};
|
||||||
|
};
|
||||||
|
DepartmentsController_disable: {
|
||||||
|
parameters: {
|
||||||
|
query?: never;
|
||||||
|
header?: never;
|
||||||
|
path?: never;
|
||||||
|
cookie?: never;
|
||||||
|
};
|
||||||
|
requestBody?: never;
|
||||||
|
responses: {
|
||||||
|
200: {
|
||||||
|
headers: {
|
||||||
|
[name: string]: unknown;
|
||||||
|
};
|
||||||
|
content?: never;
|
||||||
|
};
|
||||||
|
};
|
||||||
|
};
|
||||||
|
DepartmentsController_enable: {
|
||||||
parameters: {
|
parameters: {
|
||||||
query?: never;
|
query?: never;
|
||||||
header?: never;
|
header?: never;
|
||||||
|
|||||||
Reference in new issue
Block a user