面 B:补齐岗位/角色/菜单三族(+19 端点)

- 新表 base_position(官方 DDL 逐字),tables 13→14
- Position 一族 12 条:CRUD + Selector/SelectorTree/Condition/SelectedList/Duty*
- Role 一族 6 条:CRUD + Selector + RoleCondition(base_role 已有)
- Menu 一族 13 条:CRUD + 四种 Selector + Export/权限组(base_module 已有)
- 官方端点覆盖 49/72 → 87/98
- 坑:加新表必须重置运行库(schema 只在 base_user 不存在时整体执行);
      委托调用 handler 会让契约扫描器推不出守卫(CC6)⇒ 必须内联
This commit is contained in:
admin committed 2026-10-31 03:42:39 +08:00
1 parent afc4fc1f5f
commit 5f6ca8d963
7 files changed
+1349 -23

No files matched your search

+72 -14
View File
@@ -437,7 +437,7 @@ SELECT row_to_json(q)::text AS _row FROM (<sql>) AS q
## 6. 端点全表
> 🔴 **本节是「人读」版;机器可读版在附录 A 的 `[ENDPOINT]` 区段**
> (列:`face` / `method` / `path` / `guard` / `owner`,一行一条端点,**70** 条;
> (列:`face` / `method` / `path` / `guard` / `owner`,一行一条端点,**102** 条;
> 外加 `[FACE]` 区段登记各契约面的条数)。
> 由 **`scripts/check-contract.sh`** 把它与**代码里真实注册的路由**逐条对账
> (总数 / 存在性 / 方法 / 归属层 / 守卫,**双向**)⇒
@@ -1189,6 +1189,38 @@ B GET /api/permission/Organize/{id} permission.organize platform
B PUT /api/permission/Organize/{id} permission.organize platform
B DELETE /api/permission/Organize/{id} permission.organize platform
B GET /api/permission/Organize/Selector permission.organize platform
B POST /api/permission/Role permission.role platform
B GET /api/permission/Role/{id} permission.role platform
B PUT /api/permission/Role/{id} permission.role platform
B DELETE /api/permission/Role/{id} permission.role platform
B GET /api/permission/Role/Selector permission.role platform
B POST /api/permission/Role/RoleCondition permission.role platform
B GET /api/permission/Position permission.position platform
B POST /api/permission/Position permission.position platform
B GET /api/permission/Position/{id} permission.position platform
B PUT /api/permission/Position/{id} permission.position platform
B DELETE /api/permission/Position/{id} permission.position platform
B GET /api/permission/Position/Selector permission.position platform
B GET /api/permission/Position/SelectorTree permission.position platform
B POST /api/permission/Position/PositionCondition permission.position platform
B POST /api/permission/Position/SelectedList permission.position platform
B POST /api/permission/Position/{id}/Actions/DutyPosition permission.position platform
B POST /api/permission/Position/{id}/Actions/DutyUser permission.position platform
B GET /api/permission/Group/Selector permission.user platform
B GET /api/permission/Organize/AsyncPosList permission.organize platform
B POST /api/system/Menu permission.menu platform
B GET /api/system/Menu/{id} permission.menu platform
B PUT /api/system/Menu/{id} permission.menu platform
B DELETE /api/system/Menu/{id} permission.menu platform
B GET /api/system/Menu/Selector/{id} permission.menu platform
B GET /api/system/Menu/Selector/All permission.menu platform
B GET /api/system/Menu/Selector/Form permission.menu platform
B GET /api/system/Menu/Selector/Page permission.menu platform
B GET /api/system/Menu/SelectorFilter/{id} permission.menu platform
B GET /api/system/Menu/getSystemMenu permission.menu platform
B GET /api/system/Menu/{id}/Actions/Export permission.menu platform
B GET /api/system/Menu/getPermissionGroup/{id} permission.menu platform
B GET /api/system/Menu/getPermission/{id}/{permissionId} permission.menu platform
B GET /api/permission/Role permission.role platform
B POST /api/oauth/Logout 登录 platform
B GET /api/system/BaseLang/LangJson 登录 platform
@@ -1211,7 +1243,7 @@ A DELETE /api/ssw/asset/DataResource/Delete asset/DataResource asset
[FACE]
# face 条数 说明
A 28 面 A 专属(+ 2 条共用 ⇒ 面 A 合计 30 条)
B 40 面 B 专属(官方 JNPF 形状)
B 72 面 B 专属(官方 JNPF 形状)
AB 2 两面共用(CurrentUser / Authority Data —— 按判别头分流)
[OFFICIAL]
@@ -1276,13 +1308,39 @@ GET /api/permission/Organize/{id} implemented organize.ts:25 面 B 已落地:`
PUT /api/permission/Organize/{id} implemented organize.ts:21 面 B 已落地:**只 SET body 里出现的键**(表单提交 parentId/category/fullName/enCode/sortCode/description)
DELETE /api/permission/Organize/{id} implemented organize.ts:29 面 B 已落地:软删本行;**不级联**子机构(已知限制)
GET /api/permission/Organize/Selector implemented organize.ts:53 面 B 已落地:ListVO 全树(不做 parentId 剪枝 ⇒ 权限页选择器一次看到全树)
GET /api/permission/Position implemented position.ts:9 面 B 已落地:ListVO `{list}`;新表 `base_position`(官方 DDL 逐字)
POST /api/permission/Position implemented position.ts:13 面 B 已落地:`POSITION_WRITE_FIELDS` 白名单 + 名称非空;`f_position_id_tree` 恒为自己(本仓岗位无层级)
GET /api/permission/Position/{id} implemented position.ts:21 面 B 已落地:岗位详情
PUT /api/permission/Position/{id} implemented position.ts:17 面 B 已落地:**只 SET body 里出现的键**
DELETE /api/permission/Position/{id} implemented position.ts:25 面 B 已落地:软删本行
GET /api/permission/Position/Selector implemented position.ts:45 面 B 已落地:ListVO 全量岗位
GET /api/permission/Position/SelectorTree implemented position.ts:41 面 B 已落地:`organizeId` 命中就只返该机构岗位;本仓岗位无层级 ⇒ 平铺
POST /api/permission/Position/PositionCondition implemented position.ts:37 面 B 已落地:body `{ids}` ⇒ `ANY(string_to_array(...))`
POST /api/permission/Position/SelectedList implemented position.ts:49 面 B 已落地:同 PositionCondition(**刻意不复用**,委托会让契约扫描器推不出守卫)
POST /api/permission/Position/{id}/Actions/DutyPosition implemented position.ts:29 面 B 已落地:写 `base_organize.f_duty_position`;`organizeId` 缺失 ⇒ 400
POST /api/permission/Position/{id}/Actions/DutyUser implemented position.ts:33 面 B 已落地:写 `base_position.f_duty_user`;`userId` 缺失 ⇒ 400
GET /api/permission/Organize/AsyncPosList implemented organize.ts:68 面 B 已落地:按 `type` 分流(position ⇒ 岗位表,否则按 parentId 取机构)
GET /api/permission/Group/Selector implemented group.ts:13 面 B 已落地:ListVO 全量分组
POST /api/system/Menu implemented menu.ts:22 面 B 已落地:`MENU_WRITE_FIELDS` 白名单 + 名称非空;`f_system_id` 不传就落当前 App-Code 解析出的系统
GET /api/system/Menu/{id} implemented menu.ts:31 面 B 已落地:菜单详情
PUT /api/system/Menu/{id} implemented menu.ts:26 面 B 已落地:**只 SET body 里出现的键**
DELETE /api/system/Menu/{id} implemented menu.ts:35 面 B 已落地:软删本行;**不级联**子菜单(已知限制)
GET /api/system/Menu/Selector/{id} implemented menu.ts:15 面 B 已落地:上级菜单下拉,**排除自己及其直接子级**(防树成环)
GET /api/system/Menu/Selector/All implemented menu.ts:19 面 B 已落地:ListVO 当前系统全量菜单
GET /api/system/Menu/Selector/Form implemented menu.ts:56 面 B 已落地:同 Selector/All
GET /api/system/Menu/Selector/Page implemented menu.ts:60 面 B 已落地:PageListVO;`type` 有值就按 `f_type` 过滤
GET /api/system/Menu/SelectorFilter/{id} implemented menu.ts:52 面 B 已落地:同 Selector/{id}(本仓无「发布」概念,退化等价)
GET /api/system/Menu/getSystemMenu implemented menu.ts:60 面 B 已落地:同 Selector/All
GET /api/system/Menu/{id}/Actions/Export implemented menu.ts:38 面 B 已落地:**恒 `data:null`**(无导出文件服务);前端 `if (!res.data.url) return;` 静默跳过
GET /api/system/Menu/getPermissionGroup/{id} implemented menu.ts:42 面 B 已落地:恒 `{list:[]}`(按钮/列/表单级权限不做,见已知限制 (ag))
GET /api/system/Menu/getPermission/{id}/{permissionId} implemented menu.ts:46 面 B 已落地:恒 `{list:[]}`,同上
GET /api/permission/Role implemented RoleController.java:99-100 面 B 已落地:PageListVO 形状
GET /api/permission/Role/{id} absent RoleController.java:273 角色详情未做
POST /api/permission/Role absent RoleController.java:122 官方建角色未做
PUT /api/permission/Role/{id} absent RoleController.java:165 官方改角色未做
DELETE /api/permission/Role/{id} absent RoleController.java:298 官方删角色未做
GET /api/permission/Role/Selector absent RoleController.java:327 角色下拉未做
POST /api/permission/Role/RoleCondition absent RoleController.java:342 角色条件查询未做
GET /api/permission/Role/{id} implemented role.ts:25 面 B 已落地:表单直接 `setFieldsValue(res.data)`
POST /api/permission/Role implemented role.ts:17 面 B 已落地:`ROLE_WRITE_FIELDS` 白名单写库 + 名称非空校验,返 `{id}`
PUT /api/permission/Role/{id} implemented role.ts:21 面 B 已落地:**只 SET body 里出现的键**
DELETE /api/permission/Role/{id} implemented role.ts:29 面 B 已落地:软删本行;不级联解绑 `base_role_relation`
GET /api/permission/Role/Selector implemented role.ts:13 面 B 已落地:ListVO;`type` 有值就按 `f_type` 过滤
POST /api/permission/Role/RoleCondition implemented role.ts:33 面 B 已落地:body `{ids}`,`ANY(string_to_array(...))` 一次取回
GET /api/permission/Organize/AsyncList/{id} partial OrganizeController.java:107-110 面 B 已落地:按父 id 逐层取,但**不分页**(pageSize = 本层条数)
GET /api/permission/Organize implemented organize.ts:13 面 B 已落地:ListVO `{list}`(`organize/index.vue:280` 取 `res.data.list`);逐层树走 `AsyncList/{parentId}`
GET /api/permission/Organize/{id} implemented organize.ts:25 面 B 已落地:`OrganizeForm.vue:103` 直接 `setFieldsValue(res.data)`
@@ -1293,12 +1351,12 @@ GET /api/permission/Organize/Selector implemented organize.ts:53 面 B 已落地
POST /api/permission/Organize/SelectedList absent OrganizeController.java:341 机构已选列表未做
GET /api/system/Menu/ModuleBySystem implemented ModuleController.java:121 面 B 已落地:ListVO 形状(不是裸数组)、节点 15 字段
GET /api/system/Menu/{systemId}/TreeView absent ModuleController.java:332 管理端菜单树未做
GET /api/system/Menu/Selector/{id} absent ModuleController.java:267 上级菜单下拉未做
GET /api/system/Menu/Selector/All absent ModuleController.java:444 菜单下拉全量未做
POST /api/system/Menu absent ModuleController.java:169-170 官方建菜单未做
PUT /api/system/Menu/{id} absent ModuleController.java:194-195 官方改菜单未做
GET /api/system/Menu/{id} absent ModuleController.java:248-249 菜单详情未做
DELETE /api/system/Menu/{id} absent ModuleController.java:228-229 官方删菜单未做
GET /api/system/Menu/Selector/{id} implemented menu.ts:15 面 B 已落地:上级菜单下拉,**排除自己及直接子级**(防树成环)
GET /api/system/Menu/Selector/All implemented menu.ts:19 面 B 已落地:ListVO 当前系统全量菜单
POST /api/system/Menu implemented menu.ts:22 面 B 已落地:`MENU_WRITE_FIELDS` 白名单 + 名称非空;`f_system_id` 不传就落当前 App-Code 解析出的系统
PUT /api/system/Menu/{id} implemented menu.ts:26 面 B 已落地:**只 SET body 里出现的键**
GET /api/system/Menu/{id} implemented menu.ts:31 面 B 已落地:菜单详情
DELETE /api/system/Menu/{id} implemented menu.ts:35 面 B 已落地:软删本行;**不级联**子菜单(已知限制)
PUT /api/system/Menu/{id}/Actions/State absent ModuleController.java:498-499 菜单启停未做
POST /api/permission/Authority/Data/{objectId}/Values partial AuthorizeController.java:99-100 面 B 已落地:官方完整 body 真落库、读是 POST;但 list(权限树模型)返空数组
PUT /api/permission/Authority/Data/{objectId} partial AuthorizeController.java:159-160 两面共用(按判别头分流);list(权限树模型)返空数组