面 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

+49
View File
@@ -0,0 +1,49 @@
# 2026-10-31(夜班,无人值守)
## 结论
把 JNPF 7.0 web 前端**真跑起来了**,用户管理页达成目标:可渲染 + 列表/新增/编辑/删除全可用。
- 登录 `admin/123456` → `/home` → `/permission/user` 正常渲染,左侧分组树 + 右侧表格有数据,
**整页零非 200**(fetch+XHR 双钩子实测 `[]`)
- 机构管理 `/permission/organize` 也正常渲染(空状态)
- 面 B 端点 9 → **40** 条;`tables` 12 → **13**(新增官方 `base_group`)
- 六闸全绿:module 114 / boundary 11 / contract 10 / citations 4 / perm-smoke 43 /
perm-smoke-jnpf 23;`cargo test` **221 全过**;官方台账覆盖 49/72
## 做完的批次
1. **启动必需**:`POST /api/oauth/Logout`、`GET /api/system/BaseLang/LangJson`
2. **P0 用户页 8 条**:Group CRUD + AddUser/DeleteUser、SetPosition + SetPositionBatch、
SelectorByUserPosId、getDevUser、`DELETE socials/{id}`、workHandover
3. **页面级 404 补 5 条**:DictionaryData/All、HomeData、MenuData/useModuleNum/{id}、
oauth/getLoginConfig、oauth/getConfig/{account}
4. **P2 机构 6 条**:Organize GET/POST + {id} GET/PUT/DELETE + Selector
5. **修 bug**:`Users` 列表 keyword 搜索(原来压根没进 SQL)
## 坑(下次别再踩)
- 🔴 **`run_in_background` 不可靠**:上下文压缩那一轮 vite 就被回收(日志里明明 ready)。
**用 `nohup ... &`**,实测跨 turn 存活。
- 🔴 **后端一重启 token 就失效**(session 是进程内内存表)⇒ 每轮开工重新登录。
- `preferenceJson` 必须是**字符串** `"{}"`;给对象 ⇒ 前端 `JSON.parse` 抛异常 ⇒ 登录后立刻跳 Logout。
- 面 B 菜单 `urlAddress` 是 `permission/user`,**不是**面 A 的 `system/User`(访问后者必 404)。
- **空关键词时不能把 `like` 塞进参数数组**:SQL 里没有 `$1` ⇒ PG 报
「bind message supplies 1 parameters, but prepared statement requires 0」⇒ 必须
`if kw.is_empty() { Vec::new() } else { params_of(...) }`。
- `Db` **没有** `scalar_params`,只有 `scalar_text`(无参)⇒ 带参 count 用
`query_json_params("SELECT count(*)::bigint AS \"c\" …")`。
- bash 里 **`UID` 是只读变量**,别拿它当变量名(用 `TID`/`OID`)。
- curl 别把 `-o file` 和 `-w` 混用在同一条里再 `head` 那个文件 —— 会得到假 400/404。
排查路由时单独跑:`curl -s -w "\n[%{http_code}]\n" ...`。
## 闸门通过数字
`cargo test` 221 passed / 0 failed;六闸 PASS=114, 11, 10, 4, 43, 23(FAIL 全 0)。
中间红过一次:contract CC10「台账写 absent 但代码已注册」(Organize 6 条忘了翻
implemented)+ citations「organize.ts:71 越界(文件 69 行)」⇒ 都已修。
## 遗留
- P3 未做:菜单管理 / 角色 CRUD+授权 / Authority 一族。机构那 6 条是模板写法,照抄即可。
- 已知限制新增 `(ak)` 删机构不级联、`(al)`(原 keyword 缺失,已修复并划掉)。
+78 -33
View File
@@ -1,6 +1,6 @@
# HANDOFF —— 交给下一个 session 的现场交接
> 更新于 2026-10-30 22:15。**开工先读这一页**,再读 `CLAUDE.md`(硬约定),
> 更新于 2026-10-31 03:35。**开工先读这一页**,再读 `CLAUDE.md`(硬约定),
> 最后看 `.workbuddy/memory/` 最近一天的日志(踩过的坑)。
> 无人值守时不要问用户,选最保守可行的方案继续,并把决策写回本文件。
@@ -15,13 +15,28 @@
---
## 1. 一句话现状
## 1. 一句话现状(2026-10-31 03:30 夜班更新)
Rust 后端(axum + pglite)已能跑,**面 A**(ssw/react 形状)与**面 B**(官方 JNPF 形状,
`Vue-Version: 3`)双契约并存;面 B 的 `Users` 一族 9 条已实现。
**前端依赖已装完**(2169 包 + postinstall stub 全 Done),`pnpm dev:main` 实测 vite 7.3.1
6.8 秒就绪、3000 端口在听、`/` 返 200 —— **但页面从未在浏览器里渲染过一次**,
这是当前唯一的大未知,也是第一优先级。
**✅ 前端已经在浏览器里真跑起来了,用户管理页可渲染、列表/新增/编辑/删除全部可用。**
- 登录 `admin/123456` → 进 `/home` → `/permission/user` 正常渲染,左侧分组树 + 右侧表格有数据,
**整页零非 200 请求**(fetch/XHR 双钩子实测 `[]`)。
- 机构管理 `/permission/organize` 也正常渲染(空状态,零报错)。
- 面 B 端点从「9 条」涨到 **40 条**;`tables` 12 → **13**(新增 `base_group`)。
- 六闸全绿:`check-module 114` / `check-boundary 11` / `check-contract 10` /
`check-citations 4` / `perm-smoke 43` / `perm-smoke-jnpf 23`,`cargo test` **221 全过**。
- 官方端点台账覆盖 **49/72**(implemented 44 / partial 5 / absent 23)。
上一版说「页面从未渲染过一次」——**这个未知已经消除**。
🔴 **本轮踩到并解决的 4 个真 bug**(都是「页面能打开但功能不对」这一类):
1. `CurrentUser` 的 `preferenceJson` 必须是**字符串** `"{}"` —— 给对象会让前端
`handleUpdatePreferences` 抛异常 ⇒ 登录后立刻跳 Logout(表现为「登录无效原地打转」)。
2. 菜单 `urlAddress` 走的是**面 B 路径** `permission/user`,不是面 A 的 `system/User` ⇒
之前直接访问 `/system/User` 必然 404。
3. `Users` 列表的 `keyword` 压根没进 SQL(搜索框形同虚设)⇒ 已补三列 ILIKE。
4. 空关键词时把 `like` 塞进参数数组 ⇒ PG 报「bind supplies 1 params, statement requires 0」
⇒ **必须** `if keyword.is_empty() { Vec::new() }`。
---
@@ -32,8 +47,8 @@ Rust 后端(axum + pglite)已能跑,**面 A**(ssw/react 形状)与**
```bash
cd ~/Desktop/workspace/ssw-platform
RUSTC_WRAPPER=sccache cargo build --manifest-path src/backend/Cargo.toml # 改代码后
PORT=30000 ./target/debug/ssw-platform & # 后台起
curl -s http://127.0.0.1:30000/api/health # 期望 {"ok":true,"tables":12,...}
nohup env PORT=30000 ./target/debug/ssw-platform > /tmp/ssw-backend.log 2>&1 & # 后台起
curl -s http://127.0.0.1:30000/api/health # 期望 {"ok":true,"tables":13,...}(新增 base_group)
```
拿 token(面 B):
@@ -57,7 +72,7 @@ curl -s -X POST http://127.0.0.1:30000/api/oauth/Login \
cd ~/Desktop/workspace/jnpf/7.0/frontend/web/jnpf-web-monorepo-framework
env -u NODE_OPTIONS pnpm install --prefer-offline --reporter=append-only # 断了才需要重跑,约 47s
pnpm -r run stub --if-present # 已由 postinstall 跑过
env -u NODE_OPTIONS pnpm dev:main # vite, 3000, /dev → 30000
env -u NODE_OPTIONS nohup pnpm dev:main > /tmp/vite-main.log 2>&1 & # vite, 3000, /dev → 30000
```
- 成功标志:`node_modules/.modules.yaml` 存在(✅ 已存在)、vite 打印 `ready in ~7s`
@@ -65,7 +80,21 @@ env -u NODE_OPTIONS pnpm dev:main # vit
- 登录:`admin` / `123456`(登录框自己加密,不要手填密文)
⚠️ **后台进程会随 turn 结束被回收**(`run_in_background` 起的东西在回复完就没了)。
所以「起后端 / 起 vite → 验证页面」必须**在同一个 turn 里连续做完**;不要指望上一轮留下的进程。
🔴 **2026-10-31 实测修正**:`run_in_background` **不可靠**(上下文压缩那一轮 vite 就被回收了,
日志里明明 `ready in 5188ms`)。用 **`nohup ... &`** 起,实测能跨 turn 存活:
```bash
# 前端
cd ~/Desktop/workspace/jnpf/7.0/frontend/web/jnpf-web-monorepo-framework
env -u NODE_OPTIONS nohup pnpm dev:main > /tmp/vite-main.log 2>&1 &
# 后端
cd ~/Desktop/workspace/ssw-platform
nohup env PORT=30000 ./target/debug/ssw-platform > /tmp/ssw-backend.log 2>&1 &
```
两个都起好后,浏览器会话 `aix --session ssw` 可以直接复用(登录态在 localStorage)。
⚠️ **后端一重启,token 就失效**(session 是进程内内存表)⇒ 每轮开工必须重新登录拿 token。
### 代码仓库(本机 Gitea)
@@ -88,36 +117,52 @@ xop run --secret GU=git_local_user --secret GP=git_local_pass -- bash -c '
## 3. 待办(按优先级,做完一条划一条)
### P0 —— 用户管理页剩余接口(`scripts/probe-page.py` 实测的 8 条缺路由)
### ~~P0 —— 用户管理页剩余接口~~ ✅ **2026-10-31 全部做完**
| 端点 | 备注 |
| 端点 | 状态 |
|---|---|
| `GET /api/permission/Group` | 左侧用户分组树;**需要新表 `base_user_group`** |
| `GET|POST|PUT|DELETE /api/permission/Group/{id}` | 分组 CRUD |
| `POST /api/permission/Group/{id}/Actions/AddUser` / `DeleteUser` | 分组加/移成员 |
| `POST /api/permission/Users/{id}/SetPosition` + `POST /api/permission/Users/SetPositionBatch` | 设岗位(后者当前 405 ⇒ 同路径要补 POST) |
| `GET /api/permission/Users/{id}/SelectorByUserPosId` | 按岗位选人 |
| `GET /api/system/System/getDevUser` | 开发账号下拉 |
| `DELETE /api/permission/socials/{id}` | 第三方账号解绑 |
| `POST /api/permission/Users/workHandover` | 离职交接(写接口,探针默认跳过) |
| `GET /api/permission/Group` | ✅ 左侧分组树(ListVO)。**表是官方 `base_group`**(不是 `base_user_group`,官方 DDL `JNPF-PostgreSQL.sql:1758` 只有 `base_group`) |
| `GET/POST/PUT/DELETE /api/permission/Group/{id}` | ✅ CRUD 全通,端到端实测(建→详情→改→加成员→移出→删) |
| `POST /api/permission/Group/{id}/Actions/AddUser` / `DeleteUser` | ✅ 走 `base_user_relation`(f_object_type='Group'),幂等插 |
| `POST /api/permission/Users/{id}/SetPosition` + `/SetPositionBatch` | ✅ 405 已修(单独注册 `/Users/SetPositionBatch`) |
| `GET /api/permission/Users/{id}/SelectorByUserPosId` | ✅ |
| `GET /api/system/System/getDevUser` | ✅ |
| `DELETE /api/permission/socials/{id}` | ✅ 本仓无 `base_socials_users` ⇒ 恒成功 |
| `POST /api/permission/Users/workHandover` | ✅ 置 `f_handover_mark=1` |
### P1 —— 让页面真跑起来(比补接口更重要,先验证再补)
**另外顺手补了 5 条页面级 404**(都是「不补就弹红条」的):
`GET /api/system/DictionaryData/All`(恒 `{list:[]}`,**不能是裸数组**)、
`GET /api/system/HomeData`(恒 `[]`,前端读 `res.data.length`)、
`POST /api/system/MenuData/useModuleNum/{id}`(恒成功)、
`GET /api/oauth/getLoginConfig` + `getConfig/{account}`(**登录前调用 ⇒ 无守卫**,恒 `{}`)。
依赖已装好,直接从这里开始:
### ~~P1 —— 让页面真跑起来~~ ✅ **2026-10-31 达成**
1. 同一 turn 内:起后端 → `env -u NODE_OPTIONS pnpm dev:main` → 等 `ready` → 再操作浏览器
2. 浏览器:`aix` 需要 xstudio 内核(`curl --noproxy '*' -sf http://127.0.0.1:19999/health`);
**内核没跑时先起**:`bash /Users/xs/Documents/x/xstudio/source/scripts/xstudio-up.sh`;
还不行就退回 `--chrome` 后端(注意换 `--session`)。`aix snapshot` 拿 `@eN` 再点,别猜 selector
3. 登录后进「用户管理」,把控制台/网络里的 4xx、5xx 按顺序修:先修 500/404 的路由,
再修字段形状(前端拿不到字段会报 undefined,不会报 4xx)
4. 做成可复现步骤写回本文件(哪个 URL、登录后点哪里、期望看到什么)
可复现步骤(实测有效):
### P2 —— 机构管理 `Organize` CRUD + `Selector`
1. `nohup` 起后端 + vite(命令见 §2)
2. `aix open "http://localhost:3000/login" --session ssw` → `aix snapshot` 拿 `@eN`
→ fill 账号/密码 → click 登录 → 约 9s 后落到 `/home`
3. `aix open "http://localhost:3000/permission/user"` ⇒ 期望:左侧「全部用户」+ 分组节点,
右侧表格有 admin 行,零报错
4. 零非 200 的查法(比看控制台准):进页面前先注入 fetch/XHR 双钩子收集 `window.__net`,
再 filter `x[0]!==200`。**控制台看不到 404 的 details 时就用这招**
几乎所有权限页面的公共前置。参照 `platform/sys.rs` 里面 A 的 `org_*` 实现。
### ~~P2 —— 机构管理 `Organize` CRUD + `Selector`~~ ✅ **2026-10-31 做完**
### P3 —— 菜单管理 / 角色授权(时间够再做)
`GET/POST /api/permission/Organize`、`GET/PUT/DELETE /api/permission/Organize/{id}`、
`GET /api/permission/Organize/Selector` 共 6 条。
端到端实测:建父 → 建子(`organizeIdTree` = 父树+自己,`orgNameTree` 同理)→ 详情 →
改(只发 `fullName`,`enCode` 不动)→ Selector 2 行 → 删 → 剩 0 行。
⚠️ 删机构**不级联**(只软删本行)⇒ 已记为已知限制 `(ak)`。
### P3 —— 菜单管理 / 角色授权(**剩下的就这一块了**)
- 菜单:`GET/POST/PUT/DELETE /api/system/Menu/{id}` 一族(面 B 目前只有 `ModuleBySystem`)
- 角色:`/api/permission/Role` 已有列表,缺 CRUD + `Selector` + 授权
- 权限:`/api/permission/Authority` 一族(面 B 目前只有 `Data/{objectId}/Values`)
- 参考:机构那 6 条是**模板写法**(`ORGANIZE_WRITE_FIELDS` 白名单 + `now()` 不占参数位),
照抄即可,`docs/contract.md` 三处登记记得同步
---
+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 🔴 一条**判别规则**(不是限制,是红线)
+24 -2
View File
@@ -115,9 +115,31 @@ CREATE TABLE base_role_relation (
PRIMARY KEY (f_id, f_tenant_id)
);
-- 用户分组(用户管理页左侧的分组树)—— 官方 `JNPF-PostgreSQL.sql:1758`,14 列逐字。
-- 🔴 成员关系**不在这张表里**:分组—用户关系复用 `base_user_relation`
-- (`f_object_type = 'Group'` / `f_object_id` = 分组 id / `f_user_id` = 用户 id),
-- 与官方「组织/岗位关系都在 base_user_relation」的做法一致。
CREATE TABLE base_group (
f_id VARCHAR(50) NOT NULL,
f_full_name VARCHAR(200),
f_en_code VARCHAR(200),
f_description VARCHAR(500),
f_enabled_mark INTEGER,
f_sort_code BIGINT,
f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE,
f_creator_user_id VARCHAR(50),
f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE,
f_last_modify_user_id VARCHAR(50),
f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE,
f_delete_user_id VARCHAR(50),
f_delete_mark INTEGER,
f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL,
PRIMARY KEY (f_id, f_tenant_id)
);
CREATE TABLE base_user (
f_id VARCHAR(50) NOT NULL,
f_account VARCHAR(50),
f_id VARCHAR(50) NOT NULL,
f_account VARCHAR(50),
f_real_name VARCHAR(50),
f_quick_query VARCHAR(100),
f_nick_name VARCHAR(50),
+2 -1
View File
@@ -42,7 +42,8 @@ use ssw_platform::routes;
/// 多应用 MVP 新增了平台表 `base_system`(`SystemEntity` 注册表,
/// 承载 `App-Code` → `systemId` 的映射),故清单现在是 **8 张**
/// (原 7 张 + `base_system`)。
const BASE_TABLES: [&str; 8] = [
const BASE_TABLES: [&str; 9] = [
"base_group",
"base_user",
"base_role",
"base_organize",
+6 -6
View File
@@ -1055,22 +1055,22 @@ mod tests {
}
#[test]
fn schema_sql_has_twelve_tables() {
// schema.sql 必须包含 12 张表的 CREATE TABLE
// (8 张 base_*:7 张官方 + 多应用注册表 base_system,+ 4 张业务表)。
fn schema_sql_has_thirteen_tables() {
// schema.sql 必须包含 13 张表的 CREATE TABLE
// (9 张 base_*:8 张官方 + 多应用注册表 base_system + 用户分组 base_group,+ 4 张业务表)。
let count = SCHEMA_SQL.matches("CREATE TABLE ").count();
assert_eq!(count, 12, "schema.sql 的 CREATE TABLE 数量应为 12");
assert_eq!(count, 13, "schema.sql 的 CREATE TABLE 数量应为 13");
}
/// 🔴 [`ddl_tables`] 的解析必须与上面那条计数一致(不能只数到 12 却解析出别的)。
#[test]
fn ddl_tables_parses_every_create_table() {
let tables = ddl_tables();
assert_eq!(tables.len(), 12, "ddl_tables 应解析出 12 张表");
assert_eq!(tables.len(), 13, "ddl_tables 应解析出 13 张表");
assert!(tables.iter().all(|t| !t.is_empty()));
assert_eq!(
tables.iter().collect::<std::collections::HashSet<_>>().len(),
12,
13,
"表名不许重复"
);
// 8 张 base_* 必须都在(业务表由业务层 spec 派生,不在本文件写死)。
File diff suppressed because it is too large. Load diff
+83 -2
View File
@@ -143,11 +143,72 @@ pub fn build_router(state: AppState) -> axum::Router<AppState> {
"/api/permission/Users/{id}/Actions/unlock",
put(jnpf::user_unlock),
)
// ---- 会话与前端启动(面 B):这两条是**打开第一个页面之前**就会被打的 ----
// 🔴 `Logout` 恒成功(前端把返回值包在 try/catch 里丢弃,但 404 会弹红条)。
.route("/api/oauth/Logout", post(jnpf::logout_handler))
// 🔴 i18n 远端词条包:登录成功后立刻被 `locales/index.ts` 拉,缺了会炸整个 app。
.route("/api/system/BaseLang/LangJson", get(jnpf::base_lang_json))
// ---- 用户分组(用户管理页左侧树)----
.route("/api/permission/Group", get(jnpf::group_list))
.route("/api/permission/Group", post(jnpf::group_create))
.route("/api/permission/Group/{id}", get(jnpf::group_info))
.route("/api/permission/Group/{id}", put(jnpf::group_update))
.route("/api/permission/Group/{id}", delete(jnpf::group_delete))
.route(
"/api/permission/Group/{id}/Actions/AddUser",
post(jnpf::group_add_user),
)
.route(
"/api/permission/Group/{id}/Actions/DeleteUser",
post(jnpf::group_remove_user),
)
// ---- 岗位 / 交接 / 第三方 ----
// 🔴 `SetPositionBatch` 必须**单独注册**:挂在 `/Users/{id}` 上会被当 id 吃掉。
.route(
"/api/permission/Users/SetPositionBatch",
post(jnpf::users_set_position_batch),
)
.route(
"/api/permission/Users/workHandover",
post(jnpf::users_work_handover),
)
.route(
"/api/permission/Users/{id}/SetPosition",
post(jnpf::user_set_position),
)
.route(
"/api/permission/Users/{id}/SelectorByUserPosId",
get(jnpf::user_selector_by_pos_id),
)
.route(
"/api/system/System/getDevUser",
get(jnpf::system_get_dev_user),
)
.route("/api/permission/socials/{id}", delete(jnpf::socials_delete))
// ---- 前端每页都拉的公共接口(本仓无对应表 ⇒ 保守空形状,但必须是 200)----
.route(
"/api/system/DictionaryData/All",
get(jnpf::dictionary_data_all),
)
.route("/api/system/HomeData", get(jnpf::home_data))
.route(
"/api/system/MenuData/useModuleNum/{id}",
post(jnpf::menu_data_use_module_num),
)
// 🔴 登录**前**就会拉 ⇒ 不能挂守卫。
.route("/api/oauth/getLoginConfig", get(jnpf::get_login_config))
.route("/api/oauth/getConfig/{account}", get(jnpf::get_user_config))
.route("/api/permission/Role", get(jnpf::roles_list))
.route(
"/api/permission/Organize/AsyncList/{id}",
get(jnpf::organize_async_list),
)
.route("/api/permission/Organize", get(jnpf::organize_list))
.route("/api/permission/Organize", post(jnpf::organize_create))
.route("/api/permission/Organize/Selector", get(jnpf::organize_selector))
.route("/api/permission/Organize/{id}", get(jnpf::organize_info))
.route("/api/permission/Organize/{id}", put(jnpf::organize_update))
.route("/api/permission/Organize/{id}", delete(jnpf::organize_delete))
.route("/api/system/Menu/ModuleBySystem", get(jnpf::module_by_system))
// 🔴 官方是 `POST /api/permission/Authority/Data/{objectId}/Values`
// —— 与面 A 的 `PUT .../Data/{objectId}` **同前缀不同方法不同路径**
@@ -676,7 +737,7 @@ mod tests {
let (_, body) = raw.split_once("\r\n\r\n").expect("响应必须有头体分隔");
let body: Value = serde_json::from_str(body).expect("响应体必须是合法 JSON");
assert_eq!(body["ok"], true);
assert_eq!(body["tables"], 12);
assert_eq!(body["tables"], 13);
assert_eq!(body["version"], env!("CARGO_PKG_VERSION"));
}
@@ -691,7 +752,7 @@ mod tests {
let port = serve(new_state(db().await)).await;
// 🔴 按**路径**列(同一路径多个方法只算一条)—— 每条都用 PATCH 探 405。
const JNPF_REGISTERED: [&str; 11] = [
const JNPF_REGISTERED: [&str; 31] = [
"/api/permission/Users",
"/api/permission/Users/any-id",
"/api/permission/Users/BatchDelete",
@@ -703,6 +764,26 @@ mod tests {
"/api/permission/Organize/AsyncList/0",
"/api/system/Menu/ModuleBySystem",
"/api/permission/Authority/Data/any-id/Values",
"/api/oauth/Logout",
"/api/system/BaseLang/LangJson",
"/api/permission/Group",
"/api/permission/Group/any-id",
"/api/permission/Group/any-id/Actions/AddUser",
"/api/permission/Group/any-id/Actions/DeleteUser",
"/api/permission/Users/SetPositionBatch",
"/api/permission/Users/workHandover",
"/api/permission/Users/any-id/SetPosition",
"/api/permission/Users/any-id/SelectorByUserPosId",
"/api/system/System/getDevUser",
"/api/permission/socials/any-id",
"/api/permission/Organize",
"/api/permission/Organize/any-id",
"/api/permission/Organize/Selector",
"/api/system/DictionaryData/All",
"/api/system/HomeData",
"/api/system/MenuData/useModuleNum/any-id",
"/api/oauth/getLoginConfig",
"/api/oauth/getConfig/admin",
];
for path in JNPF_REGISTERED {