From afc4fc1f5f0fca2959183a512905ae592fa6dfbe Mon Sep 17 00:00:00 2001 From: admin Date: Sat, 31 Oct 2026 03:13:13 +0800 Subject: [PATCH] =?UTF-8?q?=E9=9D=A2=20B=EF=BC=9A=E8=B7=91=E9=80=9A=20JNPF?= =?UTF-8?q?=20=E5=89=8D=E7=AB=AF=E7=94=A8=E6=88=B7=E7=AE=A1=E7=90=86?= =?UTF-8?q?=E9=A1=B5=20+=20=E8=A1=A5=E9=BD=90=E6=9C=BA=E6=9E=84=20CRUD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 前端真跑起来:登录→/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 全过 --- .workbuddy/memory/2026-10-31.md | 49 ++ HANDOFF.md | 111 ++- docs/contract.md | 71 +- docs/known-limitations.md | 2 + src/backend/db/schema.sql | 26 +- src/backend/src/main.rs | 3 +- src/backend/src/platform/db.rs | 12 +- src/backend/src/platform/jnpf.rs | 1106 +++++++++++++++++++++++++++++- src/backend/src/routes.rs | 85 ++- 9 files changed, 1378 insertions(+), 87 deletions(-) create mode 100644 .workbuddy/memory/2026-10-31.md diff --git a/.workbuddy/memory/2026-10-31.md b/.workbuddy/memory/2026-10-31.md new file mode 100644 index 0000000..6d8d284 --- /dev/null +++ b/.workbuddy/memory/2026-10-31.md @@ -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 缺失,已修复并划掉)。 diff --git a/HANDOFF.md b/HANDOFF.md index b11fc6e..a694428 100644 --- a/HANDOFF.md +++ b/HANDOFF.md @@ -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` 三处登记记得同步 --- diff --git a/docs/contract.md b/docs/contract.md index b307aa8..ebedd8c 100644 --- a/docs/contract.md +++ b/docs/contract.md @@ -437,7 +437,7 @@ SELECT row_to_json(q)::text AS _row FROM () 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 () 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 管理端菜单树未做 diff --git a/docs/known-limitations.md b/docs/known-limitations.md index 04a41ca..a29414b 100644 --- a/docs/known-limitations.md +++ b/docs/known-limitations.md @@ -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 🔴 一条**判别规则**(不是限制,是红线) diff --git a/src/backend/db/schema.sql b/src/backend/db/schema.sql index 2d32d9d..09b9f24 100644 --- a/src/backend/db/schema.sql +++ b/src/backend/db/schema.sql @@ -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), diff --git a/src/backend/src/main.rs b/src/backend/src/main.rs index 3d2c3d4..dca8ef1 100644 --- a/src/backend/src/main.rs +++ b/src/backend/src/main.rs @@ -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", diff --git a/src/backend/src/platform/db.rs b/src/backend/src/platform/db.rs index 1799164..cff673d 100644 --- a/src/backend/src/platform/db.rs +++ b/src/backend/src/platform/db.rs @@ -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::>().len(), - 12, + 13, "表名不许重复" ); // 8 张 base_* 必须都在(业务表由业务层 spec 派生,不在本文件写死)。 diff --git a/src/backend/src/platform/jnpf.rs b/src/backend/src/platform/jnpf.rs index b2f89d2..10032cb 100644 --- a/src/backend/src/platform/jnpf.rs +++ b/src/backend/src/platform/jnpf.rs @@ -268,6 +268,20 @@ fn parse_property_json(raw: Option<&str>) -> Value { serde_json::from_str::(trimmed).unwrap_or(Value::Null) } +/// 菜单在**面 B** 里对外的 `urlAddress` —— 官方前端的**视图路径**。 +/// +/// 规则(与官方前端 `generate-routes-backend.ts:57` 对目录的做法**同一条**): +/// `f_en_code` 的点换斜杠(`permission.user` ⇒ `permission/user`)。 +/// 🔴 库里的 `f_url_address` 是**面 A** 的守卫 key(`system/User`),**不能**直接给面 B。 +fn official_view_path(en_code: Option<&str>, fallback: Option<&str>) -> Option { + let code = en_code.map(str::trim).filter(|s| !s.is_empty())?; + let path = code.replace('.', "/"); + if path.is_empty() { + return fallback.map(str::to_string); + } + Some(path) +} + /// 一个菜单节点 ⇒ 官方 `AllMenuSelectVO`(**15 个字段,一个不少**)。 /// /// 🔴 **键名与顺序照官方 `AllMenuSelectVO.java:12-50`**(`id` / `fullName` / `enCode` / @@ -296,7 +310,16 @@ fn menu_value(row: MenuRow, children: Vec, has_children: bool) -> Value { "parentId": parent_id, "icon": icon, "hasChildren": has_children, - "urlAddress": url_address, + // 🔴 **面 B 的 `urlAddress` 必须是「官方前端的视图路径」**,不是库里的 `f_url_address`。 + // 前端 `packages/utils/src/helpers/generate-routes-backend.ts:71-92`: + // `route.path = '/' + urlAddress`,且 `component = pageMap['/' + urlAddress + '/index.vue']` + // (`pageMap` = `import.meta.glob('../views/**/*.vue'`)⇒ 值必须指向**真实 .vue 文件**。 + // 而库里的 `f_url_address`(`system/User`)是**面 A** 的守卫 key,官方前端没有 + // `views/system/User/index.vue` ⇒ 点了菜单永远 404。 + // 官方自己的口径就是「编码 ⇒ 路径」(同一文件 `:57` 对目录/应用用的是 + // `/${enCode.replaceAll('.', '/')}`)⇒ 这里对**所有类型**统一用同一条规则: + // `permission.user` ⇒ `permission/user` ⇒ 命中 `views/permission/user/index.vue` ✅ + "urlAddress": official_view_path(en_code.as_deref(), url_address.as_deref()), "pageAddress": page_address, "linkTarget": link_target, "children": children, @@ -531,8 +554,14 @@ async fn build_user_info(db: &Db, user: &TokenUser, system_id: &str, system_code "signImg": "", "saasAppId": "", "saasAppName": "", - // 🔴 前端 `handleUpdatePreferences` 会 `JSON.parse(preferenceJson)` ⇒ 必须是**字符串**。 - "preferenceJson": "{}", + // 🔴 前端 `store/auth.ts:143` 的 `handleUpdatePreferences`: + // `if (userInfo.preferenceJson) preferenceJson = JSON.parse(userInfo.preferenceJson)` + // ⇒ **空串会被判假** ⇒ 保留前端自带的 `defaultPreferencesConfig`; + // 而给 `"{}"` 会被 parse 成空对象 ⇒ `updatePreferences({})` 把整套偏好清空 + // ⇒ `app.locale` / `app.defaultHomePath` 全丢 ⇒ 抛错 ⇒ `fetchUserInfo` 进 catch + // ⇒ 立刻 logout(**登录页原地打转的真正原因**,排查了两个小时的那条)。 + // ⇒ 必须是**字符串**,且必须是**空串**(不是 `"{}"`)。 + "preferenceJson": "", // 🔴 官方 `prevLogin`:1 = 上次登录 / 2 = 本次登录。本仓不区分 ⇒ 恒 1。 "prevLogin": 1, "prevLoginTime": prev_login_time, @@ -584,43 +613,73 @@ pub async fn users_list( } let page = Paging::of(&raw); - let total = match state - .db - .scalar_text("SELECT count(*) FROM base_user WHERE f_delete_mark = 0") - .await - { - Ok(Some(t)) => t.trim().parse::().unwrap_or(0), - Ok(None) => 0, + // 🔴 `keyword`:用户管理页顶部搜索框。空 ⇒ 不参与 WHERE(与 `group_list` 同一套写法)。 + // 搜 `f_account` / `f_real_name` / `f_mobile_phone` 三列(官方 `UserController` 同口径)。 + let keyword = crate::platform::sys::query_param(&raw, "keyword"); + let keyword = keyword.trim().to_string(); + let like_values = [Some(format!("%{keyword}%"))]; + // 🔴 空关键词 ⇒ **一个参数都不传**(SQL 里没有 `$1`,多传一个就是 + // 「bind message supplies 1 parameters, but prepared statement requires 0」)。 + let kw_params: Vec<&(dyn ToSql + Sync)> = if keyword.is_empty() { + Vec::new() + } else { + params_of(&like_values) + }; + let kw_filter = if keyword.is_empty() { + String::new() + } else { + " AND (f_account ILIKE $1::text OR f_real_name ILIKE $1::text \ + OR COALESCE(f_mobile_phone,'') ILIKE $1::text)".to_string() + }; + + let total_sql = format!( + "SELECT count(*)::bigint AS \"c\" FROM base_user WHERE f_delete_mark = 0{}", + kw_filter + ); + let total = match state.db.query_json_params(&total_sql, &kw_params).await { + Ok(rows) => rows + .into_iter() + .next() + .and_then(|r| r["c"].as_i64()) + .unwrap_or(0), Err(e) => return db_error(e, "用户总数查询"), }; let limit = Some(page.page_size.to_string()); let offset = Some(page.offset.to_string()); - let values = [limit, offset]; + let tail = [limit, offset]; + // 🔴 关键词占位符必须**排在分页之前**(`$1` = like,`$2`/`$3` = limit/offset)。 + let mut values: Vec> = Vec::new(); + if !keyword.is_empty() { + values.push(like_values[0].clone()); + } + values.extend(tail.iter().cloned()); let params = params_of(&values); - let rows = match state - .db - .query_json_params( - "SELECT f_id AS \"id\", f_account AS \"account\", f_real_name AS \"realName\", \ - f_real_name AS \"fullName\", f_gender AS \"gender\", \ - f_mobile_phone AS \"mobilePhone\", f_email AS \"email\", \ - f_organize_id AS \"organize\", f_description AS \"description\", \ - COALESCE(f_enabled_mark, 0) AS \"enabledMark\", \ - (EXTRACT(EPOCH FROM f_creator_time) * 1000)::bigint AS \"creatorTime\", \ - COALESCE(f_sort_code, 0) AS \"sortCode\", \ - COALESCE(f_lock_mark, 0) AS \"lockMark\", \ - COALESCE(f_handover_mark, 0) AS \"handoverMark\", \ - COALESCE(f_is_administrator, 0) AS \"isAdministrator\", \ - f_head_icon AS \"headIcon\", f_unlock_time AS \"unlockTime\", \ - f_position_id AS \"position\", 0 AS \"isDutyUser\", \ - NULL::text AS \"maxRelationId\" \ - FROM base_user WHERE f_delete_mark = 0 \ - ORDER BY f_creator_time DESC, f_id ASC \ - LIMIT $1::text::integer OFFSET $2::text::integer", - ¶ms, - ) - .await - { + let (p_limit, p_offset) = if keyword.is_empty() { + ("$1", "$2") + } else { + ("$2", "$3") + }; + let sql = format!( + "SELECT f_id AS \"id\", f_account AS \"account\", f_real_name AS \"realName\", \ + f_real_name AS \"fullName\", f_gender AS \"gender\", \ + f_mobile_phone AS \"mobilePhone\", f_email AS \"email\", \ + f_organize_id AS \"organize\", f_description AS \"description\", \ + COALESCE(f_enabled_mark, 0) AS \"enabledMark\", \ + (EXTRACT(EPOCH FROM f_creator_time) * 1000)::bigint AS \"creatorTime\", \ + COALESCE(f_sort_code, 0) AS \"sortCode\", \ + COALESCE(f_lock_mark, 0) AS \"lockMark\", \ + COALESCE(f_handover_mark, 0) AS \"handoverMark\", \ + COALESCE(f_is_administrator, 0) AS \"isAdministrator\", \ + f_head_icon AS \"headIcon\", f_unlock_time AS \"unlockTime\", \ + f_position_id AS \"position\", 0 AS \"isDutyUser\", \ + NULL::text AS \"maxRelationId\" \ + FROM base_user WHERE f_delete_mark = 0{} \ + ORDER BY f_creator_time DESC, f_id ASC \ + LIMIT {p_limit}::text::integer OFFSET {p_offset}::text::integer", + kw_filter + ); + let rows = match state.db.query_json_params(&sql, ¶ms).await { Ok(rows) => rows, Err(e) => return db_error(e, "用户列表查询"), }; @@ -1383,6 +1442,985 @@ pub async fn user_get_position( ok(Value::Array(list)) } +// ---------------------------------------------------------------- 会话与前端启动 + +/// `POST /api/oauth/Logout` —— 官方 `LoginController.java:155`。 +/// +/// 🔴 **未登录也返成功**:前端 `store/auth.ts:86` 把 `logoutApi()` 包在 +/// `try { … } catch { /* 不做任何处理 */ }` 里,**返回值完全被忽略**; +/// 但它一旦是 **HTTP 404**,会走 `errorMessageResponseInterceptor` 弹一个红条。 +/// ⇒ 这里恒 `ok(null)`,无论有没有 token。 +/// +/// 🔴 **不改变服务端会话状态**:本仓 token 是进程内内存表(`platform/session.rs`), +/// 没有 `revoke` 接口(接口 immutability 见 `SessionStore`)⇒ 登出即「客户端丢弃 token」, +/// 服务端不做失效登记。这是**已知限制 B5**(`docs/known-limitations.md`)。 +pub async fn logout_handler(State(state): State, headers: HeaderMap) -> Json { + // 鉴权结果刻意丢弃:有 token ⇒ 走一遍换取无效的分支也已经够了(无 remove 接口)。 + let _ = require_login_jnpf(&state, &headers).await; + ok(Value::Null) +} + +/// `GET /api/system/BaseLang/LangJson` —— 前端 i18n 远端词条包。 +/// +/// 官方真源:`jnpf-web-apps-main/src/api/system/baseLang.ts:28-30` +/// (`defHttp.get({ url: '/api/system/BaseLang/LangJson' })`), +/// 消费点在 `src/locales/index.ts:113-116`: +/// ```ts +/// const res = await getLangJson(); +/// if (!res || !res.data) return; // ← `data` 为空就**直接返回**,不 merge +/// i18n.global.mergeLocaleMessage(locale, JSON.parse(res.data)); +/// ``` +/// ⇒ **`data` 必须是「字符串(JSON 文本)」或空**:本仓不落 `base_language` 表 +/// (`JNPF-PostgreSQL.sql:2125`,本仓 12 张表里没有它),前端自带的 zh-CN 词条 +/// 已经够用 ⇒ 恒返 `data: null` ⇒ 前端走 `!res.data` 早退,一个字都不 merge。 +pub async fn base_lang_json(State(state): State, headers: HeaderMap) -> Json { + if let Err(resp) = require_login_jnpf(&state, &headers).await { + return resp; + } + ok(Value::Null) +} + +// ---------------------------------------------------------------- 用户分组(base_group) + +/// 分组投影(不含 `f_delete_time` / `f_delete_user_id` 等无人消费的审计列)。 +const GROUP_PROJECTION: &str = "f_id AS \"id\", f_full_name AS \"fullName\", \ + f_en_code AS \"enCode\", f_description AS \"description\", \ + COALESCE(f_enabled_mark, 0) AS \"enabledMark\", \ + COALESCE(f_sort_code, 0) AS \"sortCode\", \ + (EXTRACT(EPOCH FROM f_creator_time) * 1000)::bigint AS \"creatorTime\""; + +/// 🔴 **列名只来自这张白名单**(`JNPF-PostgreSQL.sql:1758` 的 14 列): +/// 驼峰 ≠ 下划线机械转换 ⇒ 别用 `snake_case()` 猜。 +const GROUP_WRITE_FIELDS: [(&str, &str, &str); 5] = [ + ("fullName", "f_full_name", ""), + ("enCode", "f_en_code", ""), + ("description", "f_description", ""), + ("enabledMark", "f_enabled_mark", "::integer"), + ("sortCode", "f_sort_code", "::bigint"), +]; + +/// `GET /api/permission/Group` —— 用户管理页左侧的**分组树**(`ListVO`)。 +/// +/// 🔴 前端 `views/permission/user/index.vue:338-341`: +/// `state.treeData = [{fullName:'全部用户', id:''}, ...(res.data.list || [])]` +/// ⇒ **`data` 必须是有 `list` 的对象**(裸数组会被 `|| []` 吞成空树)。 +pub async fn group_list( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_USER).await { + return resp; + } + let keyword = crate::platform::sys::query_param(&raw, "keyword"); + let keyword = keyword.trim().to_string(); + // 空关键词 ⇒ 不参与 WHERE(`like '%%'` 也能过,但显式分开更好读、更好测)。 + let sql = if keyword.is_empty() { + format!( + "SELECT {GROUP_PROJECTION} FROM base_group WHERE COALESCE(f_delete_mark,0) = 0 \ + ORDER BY f_sort_code ASC, f_full_name ASC" + ) + } else { + format!( + "SELECT {GROUP_PROJECTION} FROM base_group WHERE COALESCE(f_delete_mark,0) = 0 \ + AND (f_full_name ILIKE $1::text OR f_en_code ILIKE $1::text) \ + ORDER BY f_sort_code ASC, f_full_name ASC" + ) + }; + // 🔴 `like` 必须**先绑定再取引用**:`params_of(&[like])` 里的临时数组活不过这条语句。 + let like_values = [Some(format!("%{keyword}%"))]; + let params: Vec<&(dyn ToSql + Sync)> = if keyword.is_empty() { + Vec::new() + } else { + params_of(&like_values) + }; + let rows = match state.db.query_json_params(&sql, ¶ms).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "分组列表查询"), + }; + ok(list_vo(rows)) +} + +/// `GET /api/permission/Group/{id}` —— 分组详情(`GroupForm.vue:64` 直接 `setFieldsValue(res.data)`)。 +pub async fn group_info( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_USER).await { + return resp; + } + let id = id.trim().to_string(); + let sql = format!( + "SELECT {GROUP_PROJECTION} FROM base_group \ + WHERE f_id = $1::text AND COALESCE(f_delete_mark,0) = 0 LIMIT 1" + ); + let rows = match state.db.query_json_params(&sql, &[&id]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "分组详情查询"), + }; + match rows.into_iter().next() { + Some(row) => ok(row), + None => fail(code::FAIL, "分组不存在"), + } +} + +/// `POST /api/permission/Group` —— 建分组。 +pub async fn group_create( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_USER).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + let full_name = obj + .get("fullName") + .and_then(Value::as_str) + .unwrap_or_default() + .trim() + .to_string(); + if full_name.is_empty() { + return fail(code::FAIL, "分组名称不能为空"); + } + + let new_id = new_uuid(); + let mut columns: Vec<&str> = vec!["f_id", "f_tenant_id", "f_full_name"]; + let mut casts: Vec<&str> = vec!["", "", ""]; + let mut values: Vec> = + vec![Some(new_id.clone()), Some("0".to_string()), Some(full_name)]; + + for (json_key, column, cast) in GROUP_WRITE_FIELDS { + // `fullName` 已写入首列,跳过(避免重复列)。 + if column == "f_full_name" { + continue; + } + if obj.contains_key(json_key) { + columns.push(column); + casts.push(cast); + values.push(value_to_text(obj.get(json_key))); + } + } + if !obj.contains_key("enabledMark") { + columns.push("f_enabled_mark"); + casts.push("::integer"); + values.push(Some("1".to_string())); + } + if !obj.contains_key("sortCode") { + columns.push("f_sort_code"); + casts.push("::bigint"); + values.push(Some("0".to_string())); + } + columns.push("f_creator_user_id"); + casts.push(""); + values.push(Some(user.account)); + columns.push("f_delete_mark"); + casts.push("::integer"); + values.push(Some("0".to_string())); + // 🔴 `f_creator_time` 用 SQL `now()` ⇒ **不占参数位**(否则 `$n` 与 columns 错位)。 + columns.push("f_creator_time"); + let mut marks: Vec = (0..values.len()) + .map(|i| placeholder(i + 1, casts[i])) + .collect(); + marks.push("now()".to_string()); + let sql = format!( + "INSERT INTO base_group ({}) VALUES ({})", + columns.join(", "), + marks.join(", ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "新建分组"); + } + ok(json!({ "id": new_id })) +} + +/// `PUT /api/permission/Group/{id}` —— 改分组(**只 SET body 里出现的键**)。 +pub async fn group_update( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_USER).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + let rows = match state + .db + .query_json_params( + "SELECT f_id AS \"id\" FROM base_group \ + WHERE f_id = $1::text AND COALESCE(f_delete_mark,0) = 0 LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "分组查询"), + }; + if rows.is_empty() { + return fail(code::FAIL, "分组不存在"); + } + + let mut sets: Vec = Vec::new(); + let mut values: Vec> = Vec::new(); + for (json_key, column, cast) in GROUP_WRITE_FIELDS { + if !obj.contains_key(json_key) { + continue; + } + values.push(value_to_text(obj.get(json_key))); + sets.push(format!("{} = ${}::text{}", column, values.len(), cast)); + } + if sets.is_empty() { + return ok(Value::Null); + } + values.push(Some(user.account)); + sets.push(format!("f_last_modify_user_id = ${}::text", values.len())); + sets.push("f_last_modify_time = now()".to_string()); + values.push(Some(id)); + let sql = format!( + "UPDATE base_group SET {} WHERE f_id = ${}::text", + sets.join(", "), + values.len() + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "修改分组"); + } + ok(Value::Null) +} + +/// `DELETE /api/permission/Group/{id}` —— 删分组(软删 + 解绑成员)。 +pub async fn group_delete( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + let user = match guard(&state, &headers, EN_USER).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let values = [Some(user.account.clone()), Some(id.clone())]; + if let Err(e) = state + .db + .exec_params( + "UPDATE base_group SET f_delete_mark = 1, f_delete_time = now(), \ + f_delete_user_id = $1::text WHERE f_id = $2::text", + ¶ms_of(&values), + ) + .await + { + return db_error(e, "删除分组"); + } + // 关系行同步软删(否则树删了、成员还在 ⇒ 下次同 id 建组会「复活」旧成员)。 + let rel = [Some(user.account), Some(id)]; + if let Err(e) = state + .db + .exec_params( + "UPDATE base_user_relation SET f_delete_mark = 1, f_delete_time = now() \ + WHERE f_object_type = 'Group' AND f_object_id = $2::text \ + AND f_delete_user_id = $1::text", + ¶ms_of(&rel), + ) + .await + { + return db_error(e, "删除分组关系"); + } + ok(Value::Null) +} + +/// 分组—用户关系的**软删/插回**(`AddUser` / `DeleteUser` 共用)。 +/// +/// 🔴 关系落在 `base_user_relation`(`f_object_type = 'Group'`),**不**在 `base_group`。 +async fn group_toggle_members( + state: &AppState, + user: &str, + group_id: &str, + ids: Vec, + add: bool, +) -> Result<(), pglite::Error> { + for user_id in ids { + if add { + // 幂等:同一 (用户, 分组) 只留一条未删的关系行。 + let exists = state + .db + .query_json_params( + "SELECT f_id AS \"id\" FROM base_user_relation \ + WHERE f_user_id = $1::text AND f_object_type = 'Group' \ + AND f_object_id = $2::text AND COALESCE(f_delete_mark,0) = 0 LIMIT 1", + ¶ms_of(&[Some(user_id.clone()), Some(group_id.to_string())]), + ) + .await?; + if exists.is_empty() { + let new_id = new_uuid(); + let values = [ + Some(new_id), + Some(user_id), + Some(group_id.to_string()), + Some(user.to_string()), + ]; + state + .db + .exec_params( + "INSERT INTO base_user_relation \ + (f_id, f_tenant_id, f_user_id, f_object_type, f_object_id, \ + f_creator_user_id, f_creator_time, f_delete_mark) \ + VALUES ($1::text, '0', $2::text, 'Group', $3::text, $4::text, now(), 0)", + ¶ms_of(&values), + ) + .await?; + } + } else { + let values = [Some(user.to_string()), Some(user_id), Some(group_id.to_string())]; + state + .db + .exec_params( + "UPDATE base_user_relation SET f_delete_mark = 1, f_delete_time = now(), \ + f_delete_user_id = $1::text \ + WHERE f_user_id = $2::text AND f_object_type = 'Group' \ + AND f_object_id = $3::text", + ¶ms_of(&values), + ) + .await?; + } + } + Ok(()) +} + +/// `POST /api/permission/Group/{id}/Actions/AddUser` —— 分组加成员(body `{ids:[…]}`)。 +pub async fn group_add_user( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_USER).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + let ids = id_list(&obj); + if ids.is_empty() { + return ok(Value::Null); + } + if let Err(e) = group_toggle_members(&state, &user.account, &id, ids, true).await { + return db_error(e, "分组添加用户"); + } + ok(Value::Null) +} + +/// `POST /api/permission/Group/{id}/Actions/DeleteUser` —— 分组移出成员。 +pub async fn group_remove_user( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_USER).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + let ids = id_list(&obj); + if ids.is_empty() { + return ok(Value::Null); + } + if let Err(e) = group_toggle_members(&state, &user.account, &id, ids, false).await { + return db_error(e, "分组移除用户"); + } + ok(Value::Null) +} + +// ---------------------------------------------------------------- 岗位 / 交接 / 第三方 + +/// 用户选择器的投影(`QueryUserSelect` 要 `id` + `fullName`,多选还要 `headIcon`)。 +const USER_SELECTOR_PROJECTION: &str = "f_id AS \"id\", f_real_name AS \"fullName\", \ + f_account AS \"account\", f_head_icon AS \"headIcon\", \ + f_organize_id AS \"organizeId\", f_gender AS \"gender\""; + +/// `POST /api/permission/Users/{id}/SetPosition` —— 给单个用户设岗位。 +/// +/// 🔴 **没有 `base_position` 表** ⇒ 岗位只能落在 `base_user.f_position_id`(逗号分隔), +/// 与 `GET .../GetPosition` 的读法(同一个字段反推)成一对。 +pub async fn user_set_position( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_USER).await { + return resp; + } + let id = id.trim().to_string(); + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + let ids = id_list(&obj); + let values = [Some(ids.join(",")), Some(id)]; + if let Err(e) = state + .db + .exec_params( + "UPDATE base_user SET f_position_id = $1::text, f_last_modify_time = now() \ + WHERE f_id = $2::text", + ¶ms_of(&values), + ) + .await + { + return db_error(e, "设置用户岗位"); + } + ok(Value::Null) +} + +/// `POST /api/permission/Users/SetPositionBatch` —— 批量设岗位(body `{userIds:[…], ids:[…]}`)。 +/// +/// 🔴 **同路径不能挂在 `/Users/{id}` 上**:那条路由会把 `SetPositionBatch` 当 id 吃掉。 +/// matchit 静态段优先 ⇒ 单独注册 `/Users/SetPositionBatch` 即可正确分流。 +pub async fn users_set_position_batch( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_USER).await { + return resp; + } + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + // 🔴 批量接口的**用户**集合是 `userIds`(不是 `ids`)—— `ids` 在这里是**岗位**集合 + // (`views/permission/user/index.vue:380`:`batchSetUserPosition({ userIds, ids })`)。 + let user_ids = match obj.get("userIds") { + Some(Value::Array(items)) => items + .iter() + .filter_map(Value::as_str) + .map(str::to_string) + .collect::>(), + _ => Vec::new(), + }; + if user_ids.is_empty() { + return ok(Value::Null); + } + let positions = id_list(&obj).join(","); + let values = [Some(positions), Some(user_ids.join(","))]; + // 一条 SQL 覆盖全部用户(用 `= ANY(string_to_array(...))` ⇒ 原子,不用循环)。 + if let Err(e) = state + .db + .exec_params( + "UPDATE base_user SET f_position_id = $1::text, f_last_modify_time = now() \ + WHERE f_id = ANY(string_to_array($2::text, ','))", + ¶ms_of(&values), + ) + .await + { + return db_error(e, "批量设置用户岗位"); + } + ok(Value::Null) +} + +/// `GET /api/permission/Users/{id}/SelectorByUserPosId` —— 同岗位用户(离职交接的接收人选)。 +pub async fn user_selector_by_pos_id( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_USER).await { + return resp; + } + let id = id.trim().to_string(); + let sql = format!( + "SELECT {USER_SELECTOR_PROJECTION} FROM base_user \ + WHERE f_delete_mark = 0 AND f_id <> $1::text \ + AND COALESCE(f_position_id, '') <> '' \ + AND COALESCE(f_position_id, '') = \ + (SELECT COALESCE(f_position_id, '') FROM base_user WHERE f_id = $1::text LIMIT 1) \ + ORDER BY f_real_name ASC" + ); + let rows = match state.db.query_json_params(&sql, &[&id]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "同岗位用户查询"), + }; + ok(list_vo(rows)) +} + +/// `GET /api/system/System/getDevUser` —— 开发账号下拉(`QueryUserSelect` 的 `:api`)。 +/// +/// 🔴 官方语义是「有开发权限的用户」;本仓没有 `base_user.f_is_developer` 之类的列 +/// ⇒ 退化为「全体未删用户」(`isAdministrator` 优先排在前面)。 +pub async fn system_get_dev_user( + State(state): State, + headers: HeaderMap, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_USER).await { + return resp; + } + let sql = format!( + "SELECT {USER_SELECTOR_PROJECTION} FROM base_user WHERE f_delete_mark = 0 \ + ORDER BY COALESCE(f_is_administrator, 0) DESC, f_real_name ASC" + ); + let rows = match state.db.query_json_params(&sql, &[]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "开发账号查询"), + }; + ok(list_vo(rows)) +} + +/// `DELETE /api/permission/socials/{id}?userId=` —— 第三方账号解绑。 +/// +/// 🔴 本仓没有 `base_socials_users` 表(`JNPF-PostgreSQL.sql:4038`)⇒ **无绑可解** +/// ⇒ 恒返成功(前端 `createMessage.success(res.msg)`,不读 `data`)。 +pub async fn socials_delete( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_USER).await { + return resp; + } + // 路径参数读了但不落库:留着是为了让「未注册路径」与「已注册但无表」可区分。 + let _ = id.trim(); + ok(Value::Null) +} + +/// `POST /api/permission/Users/workHandover` —— 离职交接(写接口)。 +/// +/// 🔴 本仓**不落**工作流/流程任务 ⇒ 只做「能落库的那部分」: +/// `handoverMark` 置 1(离职)与 `f_last_modify_time`;其余交给调用方页面。 +/// body 形如 `{ fromId, toUserId, … }`(`WorkHandoverModal.vue`)。 +pub async fn users_work_handover( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_USER).await { + return resp; + } + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + let from_id = obj + .get("fromId") + .and_then(Value::as_str) + .unwrap_or_default() + .trim() + .to_string(); + if from_id.is_empty() { + return fail(code::FAIL, "交接人不能为空"); + } + let values = [Some(from_id)]; + if let Err(e) = state + .db + .exec_params( + "UPDATE base_user SET f_handover_mark = 1, f_last_modify_time = now() \ + WHERE f_id = $1::text", + ¶ms_of(&values), + ) + .await + { + return db_error(e, "离职交接"); + } + ok(Value::Null) +} + +// ---------------------------------------------------------------- 前端公共拉取(本仓无对应能力 ⇒ 保守空形状) + +/// `GET /api/system/DictionaryData/All` —— 数据字典全量(**每进一个页面都会拉一次**)。 +/// +/// 🔴 前端 `store/base.ts:48`:`this.dictionaryList = res.data.list` ⇒ `data` 必须是 +/// **有 `list` 的对象**(裸数组会把整站的下拉选项打崩)。 +/// 本仓没有 `base_dictionary` / `base_dictionary_data` 表 ⇒ 恒返**空列表**, +/// 各页面的字典下拉退化为空(`getDictionaryData` 判空返 `[]`,不抛错)。 +pub async fn dictionary_data_all( + State(state): State, + headers: HeaderMap, +) -> Json { + if let Err(resp) = require_login_jnpf(&state, &headers).await { + return resp; + } + ok(list_vo(Vec::new())) +} + +/// `GET /api/system/HomeData` —— 控制台各卡片的数据源。 +/// +/// 🔴 前端 `views/_core/home/dashboard/index.vue:104`:`for (i < res.data.length)` +/// ⇒ `data` 必须是**数组**(给 `{}` 会 `undefined.length` 直接抛错)。 +pub async fn home_data(State(state): State, headers: HeaderMap) -> Json { + if let Err(resp) = require_login_jnpf(&state, &headers).await { + return resp; + } + ok(Value::Array(Vec::new())) +} + +/// `POST /api/system/MenuData/useModuleNum/{id}` —— 记一次「常用菜单」。 +/// +/// 🔴 本仓没有收藏/常用表 ⇒ **记不了**,但前端在 `guard.ts` 的 `afterEach` 里 +/// **每个页面都调一次** ⇒ 必须为 200,否则每跳一页弹一个红条。 +pub async fn menu_data_use_module_num( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_jnpf(&state, &headers).await { + return resp; + } + let _ = id.trim(); + ok(Value::Null) +} + +/// `GET /api/oauth/getLoginConfig` —— 登录页配置(**登录前**就拉 ⇒ 不能要 token)。 +/// +/// 🔴 前端 `views/_core/login/LoginForm.vue:160-163`:`res.data.redirect` ⇒ `data` +/// 必须是**对象**(给 `null` 会 `Cannot read properties of null`)。 +pub async fn get_login_config() -> Json { + ok(json!({})) +} + +/// `GET /api/oauth/getConfig/{account}` —— 帐号的登录/锁屏配置(`user.ts:31`)。 +pub async fn get_user_config(Path(account): Path) -> Json { + let _ = account.trim(); + ok(json!({})) +} + +// ---------------------------------------------------------------- 机构管理(base_organize) + +/// 机构投影(对齐 `organize_async_list` 的字段集,两处必须一致)。 +const ORGANIZE_PROJECTION: &str = "f_id AS \"id\", f_full_name AS \"fullName\", \ + f_en_code AS \"enCode\", COALESCE(f_parent_id, '0') AS \"parentId\", \ + f_category AS \"category\", f_manager_id AS \"managerId\", \ + COALESCE(f_sort_code, 0) AS \"sortCode\", \ + COALESCE(f_enabled_mark, 0) AS \"enabledMark\", \ + f_description AS \"description\", f_organize_id_tree AS \"organizeIdTree\", \ + f_org_name_tree AS \"orgNameTree\", f_duty_position AS \"dutyPosition\", \ + (EXTRACT(EPOCH FROM f_creator_time) * 1000)::bigint AS \"creatorTime\""; + +/// 🔴 **列名只来自这张白名单**(`db/schema.sql:53` 的 21 列): +/// 驼峰 ≠ 下划线机械转换 ⇒ 别用 `snake_case()` 猜。 +/// 表单实际提交的键(`OrganizeForm.vue:33-68`):parentId/category/fullName/enCode/sortCode/description。 +const ORGANIZE_WRITE_FIELDS: [(&str, &str, &str); 8] = [ + ("parentId", "f_parent_id", ""), + ("category", "f_category", ""), + ("fullName", "f_full_name", ""), + ("enCode", "f_en_code", ""), + ("description", "f_description", ""), + ("managerId", "f_manager_id", ""), + ("enabledMark", "f_enabled_mark", "::integer"), + ("sortCode", "f_sort_code", "::bigint"), +]; + +/// `GET /api/permission/Organize` —— 机构全量列表(`ListVO`)。 +pub async fn organize_list( + State(state): State, + headers: HeaderMap, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_ORGANIZE).await { + return resp; + } + let sql = format!( + "SELECT {ORGANIZE_PROJECTION} FROM base_organize WHERE COALESCE(f_delete_mark,0) = 0 \ + ORDER BY f_sort_code ASC, f_full_name ASC" + ); + let rows = match state.db.query_json_params(&sql, &[]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "机构列表查询"), + }; + ok(list_vo(rows)) +} + +/// `GET /api/permission/Organize/{id}` —— 机构详情(`OrganizeForm.vue:103` 直接 `setFieldsValue(res.data)`)。 +pub async fn organize_info( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_ORGANIZE).await { + return resp; + } + let id = id.trim().to_string(); + let sql = format!( + "SELECT {ORGANIZE_PROJECTION} FROM base_organize \ + WHERE f_id = $1::text AND COALESCE(f_delete_mark,0) = 0 LIMIT 1" + ); + let rows = match state.db.query_json_params(&sql, &[&id]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "机构详情查询"), + }; + match rows.into_iter().next() { + Some(row) => ok(row), + None => fail(code::FAIL, "机构不存在"), + } +} + +/// `POST /api/permission/Organize` —— 建机构。 +/// +/// 🔴 `f_organize_id_tree` / `f_org_name_tree`:官方是「父树 + 自己」的拼接, +/// 这里按同样的语义落库(父不存在 ⇒ 自己就是根)。 +pub async fn organize_create( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_ORGANIZE).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + let full_name = obj + .get("fullName") + .and_then(Value::as_str) + .unwrap_or_default() + .trim() + .to_string(); + if full_name.is_empty() { + return fail(code::FAIL, "机构名称不能为空"); + } + let parent_id = obj + .get("parentId") + .and_then(Value::as_str) + .unwrap_or_default() + .trim(); + let parent_id: String = if parent_id.is_empty() { + "0".to_string() + } else { + parent_id.to_string() + }; + + // 父树:查父节点的 id_tree / name_tree,没有就视为根。 + let (id_tree_prefix, name_tree_prefix) = if parent_id == "0" { + (String::new(), String::new()) + } else { + let prow = state + .db + .query_json_params( + "SELECT COALESCE(f_organize_id_tree, f_id) AS \"t\", \ + COALESCE(f_org_name_tree, f_full_name) AS \"n\" \ + FROM base_organize WHERE f_id = $1::text AND COALESCE(f_delete_mark,0) = 0 LIMIT 1", + &[&parent_id], + ) + .await + .unwrap_or_default(); + match prow.into_iter().next() { + Some(r) => ( + r["t"].as_str().unwrap_or_default().to_string(), + r["n"].as_str().unwrap_or_default().to_string(), + ), + None => (String::new(), String::new()), + } + }; + + let new_id = new_uuid(); + let id_tree = if id_tree_prefix.is_empty() { + new_id.clone() + } else { + format!("{id_tree_prefix},{new_id}") + }; + let name_tree = if name_tree_prefix.is_empty() { + full_name.clone() + } else { + format!("{name_tree_prefix},{full_name}") + }; + + let mut columns: Vec<&str> = vec![ + "f_id", + "f_tenant_id", + "f_full_name", + "f_parent_id", + "f_organize_id_tree", + "f_org_name_tree", + ]; + let mut casts: Vec<&str> = vec!["", "", "", "", "", ""]; + let mut values: Vec> = vec![ + Some(new_id.clone()), + Some("0".to_string()), + Some(full_name), + Some(parent_id), + Some(id_tree), + Some(name_tree), + ]; + + for (json_key, column, cast) in ORGANIZE_WRITE_FIELDS { + // `fullName` / `parentId` 已作为首四列写入,跳过(避免重复列)。 + if column == "f_full_name" || column == "f_parent_id" { + continue; + } + if obj.contains_key(json_key) { + columns.push(column); + casts.push(cast); + values.push(value_to_text(obj.get(json_key))); + } + } + if !obj.contains_key("enabledMark") { + columns.push("f_enabled_mark"); + casts.push("::integer"); + values.push(Some("1".to_string())); + } + if !obj.contains_key("sortCode") { + columns.push("f_sort_code"); + casts.push("::bigint"); + values.push(Some("0".to_string())); + } + columns.push("f_creator_user_id"); + casts.push(""); + values.push(Some(user.account)); + columns.push("f_delete_mark"); + casts.push("::integer"); + values.push(Some("0".to_string())); + // 🔴 `f_creator_time` 用 SQL `now()` ⇒ **不占参数位**(否则 `$n` 与 columns 错位)。 + columns.push("f_creator_time"); + let mut marks: Vec = (0..values.len()) + .map(|i| placeholder(i + 1, casts[i])) + .collect(); + marks.push("now()".to_string()); + let sql = format!( + "INSERT INTO base_organize ({}) VALUES ({})", + columns.join(", "), + marks.join(", ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "新建机构"); + } + ok(json!({ "id": new_id })) +} + +/// `PUT /api/permission/Organize/{id}` —— 改机构(**只 SET body 里出现的键**)。 +pub async fn organize_update( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_ORGANIZE).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let obj = match parse_body(&body) { + Ok(Value::Object(o)) => o, + Ok(_) => return fail(code::FAIL, "请求参数格式错误"), + Err(resp) => return resp, + }; + let rows = match state + .db + .query_json_params( + "SELECT f_id AS \"id\" FROM base_organize \ + WHERE f_id = $1::text AND COALESCE(f_delete_mark,0) = 0 LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "机构查询"), + }; + if rows.is_empty() { + return fail(code::FAIL, "机构不存在"); + } + + let mut sets: Vec = Vec::new(); + let mut values: Vec> = Vec::new(); + for (json_key, column, cast) in ORGANIZE_WRITE_FIELDS { + if !obj.contains_key(json_key) { + continue; + } + values.push(value_to_text(obj.get(json_key))); + sets.push(format!("{} = ${}::text{}", column, values.len(), cast)); + } + if sets.is_empty() { + return ok(Value::Null); + } + values.push(Some(user.account)); + sets.push(format!("f_last_modify_user_id = ${}::text", values.len())); + sets.push("f_last_modify_time = now()".to_string()); + values.push(Some(id)); + let sql = format!( + "UPDATE base_organize SET {} WHERE f_id = ${}::text", + sets.join(", "), + values.len() + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "修改机构"); + } + ok(Value::Null) +} + +/// `DELETE /api/permission/Organize/{id}` —— 删机构(软删)。 +/// +/// 🔴 **不级联**:官方删父机构会连带子机构,本仓只软删本行(子机构会「悬挂」)。 +/// 这是**已知限制**,写进 `docs/known-limitations.md`,避免误以为级联已实现。 +pub async fn organize_delete( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + let user = match guard(&state, &headers, EN_ORGANIZE).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let values = [Some(user.account), Some(id)]; + let sql = "UPDATE base_organize SET f_delete_mark = 1, f_delete_time = now(), \ + f_delete_user_id = $1::text WHERE f_id = $2::text \ + AND COALESCE(f_delete_mark,0) = 0"; + if let Err(e) = state.db.exec_params(sql, ¶ms_of(&values)).await { + return db_error(e, "删除机构"); + } + ok(Value::Null) +} + +/// `GET /api/permission/Organize/Selector` —— 机构下拉(`ListVO`)。 +/// +/// 🔴 前端 `getOrganizeSelector()` 默认 `{parentId:'0'}`,但**本仓不做逐层剪枝**: +/// 权限页的组织选择器要能一次看到全树 ⇒ 恒返全部机构,`parentId` 仅做兼容占位。 +pub async fn organize_selector( + State(state): State, + headers: HeaderMap, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_ORGANIZE).await { + return resp; + } + let sql = format!( + "SELECT f_id AS \"id\", f_full_name AS \"fullName\", \ + COALESCE(f_parent_id, '0') AS \"parentId\", f_category AS \"category\", \ + COALESCE(f_enabled_mark, 0) AS \"enabledMark\", \ + COALESCE(f_sort_code, 0) AS \"sortCode\", \ + f_organize_id_tree AS \"organizeIdTree\" \ + FROM base_organize WHERE COALESCE(f_delete_mark,0) = 0 \ + ORDER BY f_sort_code ASC, f_full_name ASC" + ); + let rows = match state.db.query_json_params(&sql, &[]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "机构下拉查询"), + }; + ok(list_vo(rows)) +} + #[cfg(test)] mod tests { use super::*; diff --git a/src/backend/src/routes.rs b/src/backend/src/routes.rs index ec90f13..4bdd830 100644 --- a/src/backend/src/routes.rs +++ b/src/backend/src/routes.rs @@ -143,11 +143,72 @@ pub fn build_router(state: AppState) -> axum::Router { "/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 {