面 B:跑通 JNPF 前端用户管理页 + 补齐机构 CRUD

- 前端真跑起来:登录→/home→/permission/user 正常渲染,零非 200
- 新增端点 31 条(Group 一族/SetPosition/getDevUser/workHandover/Organize CRUD+Selector/
  页面级 404 五条)
- 新表 base_group(官方 DDL 逐字),tables 12→13
- 修:preferenceJson 必须为字符串;菜单 urlAddress 走 permission/user;
      Users 列表 keyword 未进 SQL;空关键词多传参数导致 PG bind 报错
- 契约三处 + JNPF_REGISTERED 同步;六闸全绿,cargo test 221 全过
This commit is contained in:
admin committed 2026-10-31 03:13:13 +08:00
1 parent 83d3ef7d66
commit afc4fc1f5f
9 files changed
+1378 -87

No files matched your search

+62 -9
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`,一行一条端点,**44** 条;
> (列:`face` / `method` / `path` / `guard` / `owner`,一行一条端点,**70** 条;
> 外加 `[FACE]` 区段登记各契约面的条数)。
> 由 **`scripts/check-contract.sh`** 把它与**代码里真实注册的路由**逐条对账
> (总数 / 存在性 / 方法 / 归属层 / 守卫,**双向**)⇒
@@ -455,6 +455,8 @@ SELECT row_to_json(q)::text AS _row FROM (<sql>) AS q
|---|---|---|---|
| POST | `/api/oauth/Login` | 无 | **form-urlencoded**:`account` / `password`(密文 hex) / `grant_type=password` |
| GET | `/api/oauth/CurrentUser` | 登录 | `{userInfo:{userId,userAccount,userName,isAdministrator}, menuList}` |
| POST | `/api/oauth/Logout` | 登录 | **恒成功** `{data:null}`(前端忽略返回值,但 404 会弹红条 ⇒ 必须得是 200) |
| GET | `/api/system/BaseLang/LangJson` | 登录 | i18n 远端词条包;恒 `{data:null}` ⇒ 前端不 merge |
**登录失败文案**(逐字):
- 缺 `account` 或 `password` ⇒ `400 '缺少 account / password'`
@@ -1163,7 +1165,33 @@ B POST /api/permission/Users/BatchUpdateState permission.user platform
B GET /api/permission/Users/{id}/GetPosition permission.user platform
B POST /api/permission/Users/{id}/Actions/ResetPassword permission.user platform
B PUT /api/permission/Users/{id}/Actions/unlock permission.user platform
B GET /api/permission/Group permission.user platform
B POST /api/permission/Group permission.user platform
B GET /api/permission/Group/{id} permission.user platform
B PUT /api/permission/Group/{id} permission.user platform
B DELETE /api/permission/Group/{id} permission.user platform
B POST /api/permission/Group/{id}/Actions/AddUser permission.user platform
B POST /api/permission/Group/{id}/Actions/DeleteUser permission.user platform
B POST /api/permission/Users/{id}/SetPosition permission.user platform
B POST /api/permission/Users/SetPositionBatch permission.user platform
B POST /api/permission/Users/workHandover permission.user platform
B GET /api/permission/Users/{id}/SelectorByUserPosId permission.user platform
B GET /api/system/System/getDevUser permission.user platform
B DELETE /api/permission/socials/{id} permission.user platform
B GET /api/system/DictionaryData/All 登录 platform
B GET /api/system/HomeData 登录 platform
B POST /api/system/MenuData/useModuleNum/{id} 登录 platform
B GET /api/oauth/getLoginConfig 无 platform
B GET /api/oauth/getConfig/{account} 无 platform
B GET /api/permission/Organize permission.organize platform
B POST /api/permission/Organize permission.organize platform
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 GET /api/permission/Role permission.role platform
B POST /api/oauth/Logout 登录 platform
B GET /api/system/BaseLang/LangJson 登录 platform
B GET /api/permission/Organize/AsyncList/{id} permission.organize platform
B GET /api/system/Menu/ModuleBySystem permission.menu platform
B POST /api/permission/Authority/Data/{objectId}/Values 登录 platform
@@ -1183,7 +1211,7 @@ A DELETE /api/ssw/asset/DataResource/Delete asset/DataResource asset
[FACE]
# face 条数 说明
A 28 面 A 专属(+ 2 条共用 ⇒ 面 A 合计 30 条)
B 14 面 B 专属(官方 JNPF 形状)
B 40 面 B 专属(官方 JNPF 形状)
AB 2 两面共用(CurrentUser / Authority Data —— 按判别头分流)
[OFFICIAL]
@@ -1200,7 +1228,8 @@ AB 2 两面共用(CurrentUser / Authority Data —— 按判别头分流)
# 反向:代码里**面 B / 共用**的每条路由都必须在本台账里**有账**。
# 覆盖 N/M = (implemented + partial) / (implemented + partial + absent)。
POST /api/oauth/Login partial LoginController.java:117 路径与入参逐字一致;返回的是面 A 形状(token 同名同义),官方 LoginVO 的 theme/wlQrcode/isSaas/saasList 未返
POST /api/oauth/Logout absent LoginController.java:155 登出未做(token 是进程内内存表,进程退出即失效)
POST /api/oauth/Logout implemented LoginController.java:155 面 B 已落地:恒 `{data:null}`(前端 try/catch 丢弃返回值,但 404 会弹红条);服务端不撤销 token(进程内内存表无 revoke,已知限制 B5)
GET /api/system/BaseLang/LangJson implemented baseLang.ts:28-30 面 B 已落地:恒 `{data:null}` ⇒ 前端 `locales/index.ts:114` 走 `!res.data` 早退,不 merge 远端词条(本仓无 base_language 表)
GET /api/oauth/CurrentUser partial LoginController.java:192 面 B 返 PcUserVO 5 字段;sysConfigInfo 返空对象、currentSystemId 固定、按钮级权限恒空、permissionList 按菜单给
GET /api/permission/Users implemented UserController.java:293 面 B 已落地:PageListVO 形状、列表项无 password/secretkey、isAdministrator 是数字
GET /api/permission/Users/{id} implemented UserController.java:355 面 B 已落地:UserInfoVO 形状(Form.vue 的 field 逐字对齐),无 password/secretkey
@@ -1223,6 +1252,30 @@ GET /api/permission/Users/ExportExceptionData oos user.ts:57-69 导入导出族
POST /api/permission/Users/getUserList absent user.ts:49 批量选择族(可后置,未列入 v1 范围也未明确排除)
POST /api/permission/Users/getSelectedList absent user.ts:73 批量选择族(可后置)
POST /api/permission/Users/getSelectedUserList absent user.ts:77 批量选择族(可后置)
GET /api/permission/Group implemented group.ts:9 面 B 已落地:ListVO `{list}`(前端 `user/index.vue:340` 取 `res.data.list`);新表 `base_group`(官方 `JNPF-PostgreSQL.sql:1758`,14 列逐字)
POST /api/permission/Group implemented group.ts:17 面 B 已落地:白名单写库 + 名称非空校验,返 `{id}`;成员关系**不在**本表
GET /api/permission/Group/{id} implemented group.ts:25 面 B 已落地:`GroupForm.vue:64` 直接 `setFieldsValue(res.data)`
PUT /api/permission/Group/{id} implemented group.ts:21 面 B 已落地:**只 SET body 里出现的键**
DELETE /api/permission/Group/{id} implemented group.ts:29 面 B 已落地:软删分组 + 同步软删 `base_user_relation` 的 Group 关系行
POST /api/permission/Group/{id}/Actions/AddUser implemented group.ts:37 面 B 已落地:`base_user_relation`(f_object_type='Group'),幂等插;空集合返成功
POST /api/permission/Group/{id}/Actions/DeleteUser implemented group.ts:41 面 B 已落地:关系行软删;空集合返成功
POST /api/permission/Users/{id}/SetPosition implemented user.ts:101 面 B 已落地:岗位写 `base_user.f_position_id`(逗号分隔);无 base_position 表
POST /api/permission/Users/SetPositionBatch implemented user.ts:105 面 B 已落地:body `{userIds, ids}`,一条 UPDATE … ANY(string_to_array) 原子完成
POST /api/permission/Users/workHandover implemented user.ts:85 面 B 已落地:置 `f_handover_mark=1`;工作流/流程任务不迁 ⇒ 只落能落的部分
GET /api/permission/Users/{id}/SelectorByUserPosId implemented user.ts:93 面 B 已落地:同 `f_position_id` 的其它用户(ListVO)
GET /api/system/System/getDevUser implemented system.ts:53 面 B 已落地:`QueryUserSelect` 的 `:api` ⇒ ListVO;无「开发者」列 ⇒ 退化为全体用户(管理员优先)
DELETE /api/permission/socials/{id} implemented socialsUser.ts:21 面 B 已落地:本仓无 `base_socials_users` 表 ⇒ 无绑可解,恒成功(只返 msg)
GET /api/system/DictionaryData/All implemented dictionary.ts:38-40 面 B 已落地:恒 `{list:[]}`(无 base_dictionary 表);前端 `store/base.ts:48` 取 `res.data.list` ⇒ 不能是裸数组
GET /api/system/HomeData implemented homeData.ts:8 面 B 已落地:恒 `[]`(前端 `dashboard/index.vue:104` 读 `res.data.length` ⇒ 必须是数组)
POST /api/system/MenuData/useModuleNum/{id} implemented collectMenu.ts:21 面 B 已落地:常用菜单计数**无表可记** ⇒ 恒成功(每页 afterEach 都调,404 会弹红条)
GET /api/oauth/getLoginConfig implemented user.ts:33 面 B 已落地:恒 `{}`(**登录前**调用 ⇒ 无守卫;前端读 `res.data.redirect` ⇒ 必须是对象)
GET /api/oauth/getConfig/{account} implemented user.ts:31 面 B 已落地:恒 `{}`(同登录前,无守卫)
GET /api/permission/Organize implemented organize.ts:13 面 B 已落地:ListVO `{list}`(`organize/index.vue:280` 取 `res.data.list`);树本身走 `AsyncList/{parentId}`
POST /api/permission/Organize implemented organize.ts:17 面 B 已落地:白名单写库 + 名称非空校验;`f_organize_id_tree`/`f_org_name_tree` 按「父树+自己」拼
GET /api/permission/Organize/{id} implemented organize.ts:25 面 B 已落地:`OrganizeForm.vue:103` 直接 `setFieldsValue(res.data)`
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/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 官方建角色未做
@@ -1231,12 +1284,12 @@ 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/Organize/AsyncList/{id} partial OrganizeController.java:107-110 面 B 已落地:按父 id 逐层取,但**不分页**(pageSize = 本层条数)
GET /api/permission/Organize absent organize.ts:14 官方机构列表未做
GET /api/permission/Organize/{id} absent OrganizeController.java:290 机构详情未做
POST /api/permission/Organize absent OrganizeController.java:179 官方建机构未做
PUT /api/permission/Organize/{id} absent OrganizeController.java:212 官方改机构未做
DELETE /api/permission/Organize/{id} absent OrganizeController.java:315 官方删机构未做
GET /api/permission/Organize/Selector absent OrganizeController.java:145 机构下拉未做
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)`
POST /api/permission/Organize implemented organize.ts:17 面 B 已落地:白名单写库 + 名称非空;`f_organize_id_tree`/`f_org_name_tree` 按「父树+自己」拼
PUT /api/permission/Organize/{id} implemented organize.ts:21 面 B 已落地:**只 SET body 里出现的键**
DELETE /api/permission/Organize/{id} implemented organize.ts:29 面 B 已落地:软删本行;**不级联**子机构(已知限制)
GET /api/permission/Organize/Selector implemented organize.ts:53 面 B 已落地:ListVO 全树(不做 parentId 剪枝 ⇒ 权限页选择器一次看到全树)
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 管理端菜单树未做
+2
View File
@@ -89,6 +89,8 @@
| (ah) | **三个业务菜单的 `f_en_code` 是本仓自定占位** —— `permission.demo` / `permission.shop.product` / `permission.books.book` | 面 B 规格 §8 B8 | 官方没有 demo/shop/books 三个模块。**代价**:迁官方时要改成官方编码;当前占位**不与官方 `permission.*` 冲突**(官方只用到 `permission.user`/`role`/`organize`/`menu` 等) |
| (ai) | **`AuthorizeDataReturnVO.list`(权限树模型)返空数组** —— 只保证 `ids`/`all` 语义正确 | 面 B 规格 §8 B1 | 官方那套树模型(`modelId` + `button`/`column`/`resource`/`form` 子树)本仓不做。**代价**:官方授权弹窗需二次适配(`ids` 可直接用) |
| (aj) | **组织 `AsyncList/{id}` 不分页** —— 按父 id 逐层取,`pageSize` = 本层条数 | 面 B 规格 §8 B10 | 官方前端就是靠这个接口**逐层展开**机构树。**代价**:机构极多时无分页保护(本仓机构表本身很小) |
| (ak) | **`DELETE /api/permission/Organize/{id}` 不级联** —— 只软删本行 | 面 B 实现 2026-10-31 | 官方删父机构会连带子机构。**代价**:删父后子机构**悬挂**(`f_parent_id` 指向已软删的行),列表里**不会再出现**(`f_delete_mark=0` 过滤)⇒ 表现为「孤儿节点静默消失」。v1 不做递归是**有意**的(避免一次请求删掉整棵子树) |
| (al) | ~~**`GET /api/permission/Users` 的 `keyword` 不生效**~~ —— ✅ **2026-10-31 已补齐**:`f_account` / `f_real_name` / `f_mobile_phone` 三列 ILIKE,空关键词**一个参数都不传** | 面 B 实现 2026-10-31 | 🔴 坑:空关键词时若仍把 `like` 塞进参数数组 ⇒ SQL 里没有 `$1`,PG 报「bind message supplies 1 parameters, but prepared statement requires 0」⇒ **必须** `if keyword.is_empty() { Vec::new() }` |
### H.1 🔴 一条**判别规则**(不是限制,是红线)