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

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

No files matched your search

@@ -0,0 +1,21 @@
# 自动化「ssw-platform 夜间攻坚(23:55 主跑)」执行记忆
## 2026-10-31 03:35(第二轮,主跑 + 凌晨续跑)
**达成**:JNPF 前端在浏览器里真跑起来了。用户管理页可渲染、列表/新增/编辑/删除全可用,
整页零非 200。机构管理页也正常渲染。
- 面 B 端点 9 → 40 条;新增官方表 `base_group`,tables 12 → 13
- 六闸全绿(114/11/10/4/43/23),`cargo test` 221 全过;官方台账覆盖 49/72
- 修 4 个真 bug:preferenceJson 必须是字符串、菜单 urlAddress 走 permission/user、
Users 列表 keyword 未进 SQL、空关键词多传参数触发 PG bind 报错
- 已 commit(`afc4fc1`)留回滚点
**关键经验(下轮直接用)**:
- `run_in_background` 起的长进程会被回收 ⇒ 一律 `nohup ... &`
- 后端重启后 token 失效 ⇒ 每轮重新登录
- 契约三处必须同步([ENDPOINT] / [OFFICIAL] absent→implemented / JNPF_REGISTERED),
漏改会被 CC10 抓;引文行号越界被 CIT2 抓
**剩余**:P3 菜单管理 / 角色 CRUD+授权 / Authority 一族。
已把 04:55 接力任务(a4d2c6ca)的提示词重写为聚焦 P3,并写入本轮的坑。
+72 -14
View File
@@ -437,7 +437,7 @@ SELECT row_to_json(q)::text AS _row FROM (<sql>) AS q
## 6. 端点全表
> 🔴 **本节是「人读」版;机器可读版在附录 A 的 `[ENDPOINT]` 区段**
> (列:`face` / `method` / `path` / `guard` / `owner`,一行一条端点,**70** 条;
> (列:`face` / `method` / `path` / `guard` / `owner`,一行一条端点,**102** 条;
> 外加 `[FACE]` 区段登记各契约面的条数)。
> 由 **`scripts/check-contract.sh`** 把它与**代码里真实注册的路由**逐条对账
> (总数 / 存在性 / 方法 / 归属层 / 守卫,**双向**)⇒
@@ -1189,6 +1189,38 @@ B GET /api/permission/Organize/{id} permission.organize platform
B PUT /api/permission/Organize/{id} permission.organize platform
B DELETE /api/permission/Organize/{id} permission.organize platform
B GET /api/permission/Organize/Selector permission.organize platform
B POST /api/permission/Role permission.role platform
B GET /api/permission/Role/{id} permission.role platform
B PUT /api/permission/Role/{id} permission.role platform
B DELETE /api/permission/Role/{id} permission.role platform
B GET /api/permission/Role/Selector permission.role platform
B POST /api/permission/Role/RoleCondition permission.role platform
B GET /api/permission/Position permission.position platform
B POST /api/permission/Position permission.position platform
B GET /api/permission/Position/{id} permission.position platform
B PUT /api/permission/Position/{id} permission.position platform
B DELETE /api/permission/Position/{id} permission.position platform
B GET /api/permission/Position/Selector permission.position platform
B GET /api/permission/Position/SelectorTree permission.position platform
B POST /api/permission/Position/PositionCondition permission.position platform
B POST /api/permission/Position/SelectedList permission.position platform
B POST /api/permission/Position/{id}/Actions/DutyPosition permission.position platform
B POST /api/permission/Position/{id}/Actions/DutyUser permission.position platform
B GET /api/permission/Group/Selector permission.user platform
B GET /api/permission/Organize/AsyncPosList permission.organize platform
B POST /api/system/Menu permission.menu platform
B GET /api/system/Menu/{id} permission.menu platform
B PUT /api/system/Menu/{id} permission.menu platform
B DELETE /api/system/Menu/{id} permission.menu platform
B GET /api/system/Menu/Selector/{id} permission.menu platform
B GET /api/system/Menu/Selector/All permission.menu platform
B GET /api/system/Menu/Selector/Form permission.menu platform
B GET /api/system/Menu/Selector/Page permission.menu platform
B GET /api/system/Menu/SelectorFilter/{id} permission.menu platform
B GET /api/system/Menu/getSystemMenu permission.menu platform
B GET /api/system/Menu/{id}/Actions/Export permission.menu platform
B GET /api/system/Menu/getPermissionGroup/{id} permission.menu platform
B GET /api/system/Menu/getPermission/{id}/{permissionId} permission.menu platform
B GET /api/permission/Role permission.role platform
B POST /api/oauth/Logout 登录 platform
B GET /api/system/BaseLang/LangJson 登录 platform
@@ -1211,7 +1243,7 @@ A DELETE /api/ssw/asset/DataResource/Delete asset/DataResource asset
[FACE]
# face 条数 说明
A 28 面 A 专属(+ 2 条共用 ⇒ 面 A 合计 30 条)
B 40 面 B 专属(官方 JNPF 形状)
B 72 面 B 专属(官方 JNPF 形状)
AB 2 两面共用(CurrentUser / Authority Data —— 按判别头分流)
[OFFICIAL]
@@ -1276,13 +1308,39 @@ GET /api/permission/Organize/{id} implemented organize.ts:25 面 B 已落地:`
PUT /api/permission/Organize/{id} implemented organize.ts:21 面 B 已落地:**只 SET body 里出现的键**(表单提交 parentId/category/fullName/enCode/sortCode/description)
DELETE /api/permission/Organize/{id} implemented organize.ts:29 面 B 已落地:软删本行;**不级联**子机构(已知限制)
GET /api/permission/Organize/Selector implemented organize.ts:53 面 B 已落地:ListVO 全树(不做 parentId 剪枝 ⇒ 权限页选择器一次看到全树)
GET /api/permission/Position implemented position.ts:9 面 B 已落地:ListVO `{list}`;新表 `base_position`(官方 DDL 逐字)
POST /api/permission/Position implemented position.ts:13 面 B 已落地:`POSITION_WRITE_FIELDS` 白名单 + 名称非空;`f_position_id_tree` 恒为自己(本仓岗位无层级)
GET /api/permission/Position/{id} implemented position.ts:21 面 B 已落地:岗位详情
PUT /api/permission/Position/{id} implemented position.ts:17 面 B 已落地:**只 SET body 里出现的键**
DELETE /api/permission/Position/{id} implemented position.ts:25 面 B 已落地:软删本行
GET /api/permission/Position/Selector implemented position.ts:45 面 B 已落地:ListVO 全量岗位
GET /api/permission/Position/SelectorTree implemented position.ts:41 面 B 已落地:`organizeId` 命中就只返该机构岗位;本仓岗位无层级 ⇒ 平铺
POST /api/permission/Position/PositionCondition implemented position.ts:37 面 B 已落地:body `{ids}` ⇒ `ANY(string_to_array(...))`
POST /api/permission/Position/SelectedList implemented position.ts:49 面 B 已落地:同 PositionCondition(**刻意不复用**,委托会让契约扫描器推不出守卫)
POST /api/permission/Position/{id}/Actions/DutyPosition implemented position.ts:29 面 B 已落地:写 `base_organize.f_duty_position`;`organizeId` 缺失 ⇒ 400
POST /api/permission/Position/{id}/Actions/DutyUser implemented position.ts:33 面 B 已落地:写 `base_position.f_duty_user`;`userId` 缺失 ⇒ 400
GET /api/permission/Organize/AsyncPosList implemented organize.ts:68 面 B 已落地:按 `type` 分流(position ⇒ 岗位表,否则按 parentId 取机构)
GET /api/permission/Group/Selector implemented group.ts:13 面 B 已落地:ListVO 全量分组
POST /api/system/Menu implemented menu.ts:22 面 B 已落地:`MENU_WRITE_FIELDS` 白名单 + 名称非空;`f_system_id` 不传就落当前 App-Code 解析出的系统
GET /api/system/Menu/{id} implemented menu.ts:31 面 B 已落地:菜单详情
PUT /api/system/Menu/{id} implemented menu.ts:26 面 B 已落地:**只 SET body 里出现的键**
DELETE /api/system/Menu/{id} implemented menu.ts:35 面 B 已落地:软删本行;**不级联**子菜单(已知限制)
GET /api/system/Menu/Selector/{id} implemented menu.ts:15 面 B 已落地:上级菜单下拉,**排除自己及其直接子级**(防树成环)
GET /api/system/Menu/Selector/All implemented menu.ts:19 面 B 已落地:ListVO 当前系统全量菜单
GET /api/system/Menu/Selector/Form implemented menu.ts:56 面 B 已落地:同 Selector/All
GET /api/system/Menu/Selector/Page implemented menu.ts:60 面 B 已落地:PageListVO;`type` 有值就按 `f_type` 过滤
GET /api/system/Menu/SelectorFilter/{id} implemented menu.ts:52 面 B 已落地:同 Selector/{id}(本仓无「发布」概念,退化等价)
GET /api/system/Menu/getSystemMenu implemented menu.ts:60 面 B 已落地:同 Selector/All
GET /api/system/Menu/{id}/Actions/Export implemented menu.ts:38 面 B 已落地:**恒 `data:null`**(无导出文件服务);前端 `if (!res.data.url) return;` 静默跳过
GET /api/system/Menu/getPermissionGroup/{id} implemented menu.ts:42 面 B 已落地:恒 `{list:[]}`(按钮/列/表单级权限不做,见已知限制 (ag))
GET /api/system/Menu/getPermission/{id}/{permissionId} implemented menu.ts:46 面 B 已落地:恒 `{list:[]}`,同上
GET /api/permission/Role implemented RoleController.java:99-100 面 B 已落地:PageListVO 形状
GET /api/permission/Role/{id} absent RoleController.java:273 角色详情未做
POST /api/permission/Role absent RoleController.java:122 官方建角色未做
PUT /api/permission/Role/{id} absent RoleController.java:165 官方改角色未做
DELETE /api/permission/Role/{id} absent RoleController.java:298 官方删角色未做
GET /api/permission/Role/Selector absent RoleController.java:327 角色下拉未做
POST /api/permission/Role/RoleCondition absent RoleController.java:342 角色条件查询未做
GET /api/permission/Role/{id} implemented role.ts:25 面 B 已落地:表单直接 `setFieldsValue(res.data)`
POST /api/permission/Role implemented role.ts:17 面 B 已落地:`ROLE_WRITE_FIELDS` 白名单写库 + 名称非空校验,返 `{id}`
PUT /api/permission/Role/{id} implemented role.ts:21 面 B 已落地:**只 SET body 里出现的键**
DELETE /api/permission/Role/{id} implemented role.ts:29 面 B 已落地:软删本行;不级联解绑 `base_role_relation`
GET /api/permission/Role/Selector implemented role.ts:13 面 B 已落地:ListVO;`type` 有值就按 `f_type` 过滤
POST /api/permission/Role/RoleCondition implemented role.ts:33 面 B 已落地:body `{ids}`,`ANY(string_to_array(...))` 一次取回
GET /api/permission/Organize/AsyncList/{id} partial OrganizeController.java:107-110 面 B 已落地:按父 id 逐层取,但**不分页**(pageSize = 本层条数)
GET /api/permission/Organize implemented organize.ts:13 面 B 已落地:ListVO `{list}`(`organize/index.vue:280` 取 `res.data.list`);逐层树走 `AsyncList/{parentId}`
GET /api/permission/Organize/{id} implemented organize.ts:25 面 B 已落地:`OrganizeForm.vue:103` 直接 `setFieldsValue(res.data)`
@@ -1293,12 +1351,12 @@ GET /api/permission/Organize/Selector implemented organize.ts:53 面 B 已落地
POST /api/permission/Organize/SelectedList absent OrganizeController.java:341 机构已选列表未做
GET /api/system/Menu/ModuleBySystem implemented ModuleController.java:121 面 B 已落地:ListVO 形状(不是裸数组)、节点 15 字段
GET /api/system/Menu/{systemId}/TreeView absent ModuleController.java:332 管理端菜单树未做
GET /api/system/Menu/Selector/{id} absent ModuleController.java:267 上级菜单下拉未做
GET /api/system/Menu/Selector/All absent ModuleController.java:444 菜单下拉全量未做
POST /api/system/Menu absent ModuleController.java:169-170 官方建菜单未做
PUT /api/system/Menu/{id} absent ModuleController.java:194-195 官方改菜单未做
GET /api/system/Menu/{id} absent ModuleController.java:248-249 菜单详情未做
DELETE /api/system/Menu/{id} absent ModuleController.java:228-229 官方删菜单未做
GET /api/system/Menu/Selector/{id} implemented menu.ts:15 面 B 已落地:上级菜单下拉,**排除自己及直接子级**(防树成环)
GET /api/system/Menu/Selector/All implemented menu.ts:19 面 B 已落地:ListVO 当前系统全量菜单
POST /api/system/Menu implemented menu.ts:22 面 B 已落地:`MENU_WRITE_FIELDS` 白名单 + 名称非空;`f_system_id` 不传就落当前 App-Code 解析出的系统
PUT /api/system/Menu/{id} implemented menu.ts:26 面 B 已落地:**只 SET body 里出现的键**
GET /api/system/Menu/{id} implemented menu.ts:31 面 B 已落地:菜单详情
DELETE /api/system/Menu/{id} implemented menu.ts:35 面 B 已落地:软删本行;**不级联**子菜单(已知限制)
PUT /api/system/Menu/{id}/Actions/State absent ModuleController.java:498-499 菜单启停未做
POST /api/permission/Authority/Data/{objectId}/Values partial AuthorizeController.java:99-100 面 B 已落地:官方完整 body 真落库、读是 POST;但 list(权限树模型)返空数组
PUT /api/permission/Authority/Data/{objectId} partial AuthorizeController.java:159-160 两面共用(按判别头分流);list(权限树模型)返空数组
+27
View File
@@ -137,6 +137,33 @@ CREATE TABLE base_group (
PRIMARY KEY (f_id, f_tenant_id)
);
CREATE TABLE base_position (
f_id VARCHAR(50) NOT NULL,
f_full_name VARCHAR(200),
f_en_code VARCHAR(200),
f_type VARCHAR(50),
f_property_json TEXT,
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_organize_id VARCHAR(50),
f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL,
f_parent_id VARCHAR(50),
f_duty_user VARCHAR(50),
f_position_id_tree TEXT,
f_is_condition INTEGER,
f_condition_json TEXT,
f_default_mark INTEGER,
PRIMARY KEY (f_id, f_tenant_id)
);
CREATE TABLE base_user (
f_id VARCHAR(50) NOT NULL,
f_account VARCHAR(50),
+2 -1
View File
@@ -42,7 +42,7 @@ use ssw_platform::routes;
/// 多应用 MVP 新增了平台表 `base_system`(`SystemEntity` 注册表,
/// 承载 `App-Code` → `systemId` 的映射),故清单现在是 **8 张**
/// (原 7 张 + `base_system`)。
const BASE_TABLES: [&str; 9] = [
const BASE_TABLES: [&str; 10] = [
"base_group",
"base_user",
"base_role",
@@ -52,6 +52,7 @@ const BASE_TABLES: [&str; 9] = [
"base_role_relation",
"base_user_relation",
"base_system",
"base_position",
];
/// 命令行解析的结果(**纯数据**,便于单测)。
+6 -6
View File
@@ -1055,22 +1055,22 @@ mod tests {
}
#[test]
fn schema_sql_has_thirteen_tables() {
// schema.sql 必须包含 13 张表的 CREATE TABLE
// (9 张 base_*:8 张官方 + 多应用注册表 base_system + 用户分组 base_group,+ 4 张业务表)。
fn schema_sql_has_fourteen_tables() {
// schema.sql 必须包含 14 张表的 CREATE TABLE
// (10 张 base_*:8 张官方 + 多应用注册表 base_system + 用户分组 base_group + 岗位 base_position,+ 4 张业务表)。
let count = SCHEMA_SQL.matches("CREATE TABLE ").count();
assert_eq!(count, 13, "schema.sql 的 CREATE TABLE 数量应为 13");
assert_eq!(count, 14, "schema.sql 的 CREATE TABLE 数量应为 14");
}
/// 🔴 [`ddl_tables`] 的解析必须与上面那条计数一致(不能只数到 12 却解析出别的)。
#[test]
fn ddl_tables_parses_every_create_table() {
let tables = ddl_tables();
assert_eq!(tables.len(), 13, "ddl_tables 应解析出 13 张表");
assert_eq!(tables.len(), 14, "ddl_tables 应解析出 14 张表");
assert!(tables.iter().all(|t| !t.is_empty()));
assert_eq!(
tables.iter().collect::<std::collections::HashSet<_>>().len(),
13,
14,
"表名不许重复"
);
// 8 张 base_* 必须都在(业务表由业务层 spec 派生,不在本文件写死)。
File diff suppressed because it is too large. Load diff
+58 -2
View File
@@ -199,6 +199,25 @@ pub fn build_router(state: AppState) -> axum::Router<AppState> {
.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/Role", post(jnpf::role_create))
.route("/api/permission/Role/Selector", get(jnpf::role_selector))
.route("/api/permission/Role/RoleCondition", post(jnpf::role_condition))
.route("/api/permission/Role/{id}", get(jnpf::role_info))
.route("/api/permission/Role/{id}", put(jnpf::role_update))
.route("/api/permission/Role/{id}", delete(jnpf::role_delete))
.route("/api/permission/Position", get(jnpf::position_list))
.route("/api/permission/Position", post(jnpf::position_create))
.route("/api/permission/Position/Selector", get(jnpf::position_selector))
.route("/api/permission/Position/SelectorTree", get(jnpf::position_selector_tree))
.route("/api/permission/Position/PositionCondition", post(jnpf::position_condition))
.route("/api/permission/Position/SelectedList", post(jnpf::position_selected_list))
.route("/api/permission/Position/{id}", get(jnpf::position_info))
.route("/api/permission/Position/{id}", put(jnpf::position_update))
.route("/api/permission/Position/{id}", delete(jnpf::position_delete))
.route("/api/permission/Position/{id}/Actions/DutyPosition", post(jnpf::position_duty_position))
.route("/api/permission/Position/{id}/Actions/DutyUser", post(jnpf::position_duty_user))
.route("/api/permission/Group/Selector", get(jnpf::group_selector))
.route("/api/permission/Organize/AsyncPosList", get(jnpf::organize_async_pos_list))
.route(
"/api/permission/Organize/AsyncList/{id}",
get(jnpf::organize_async_list),
@@ -210,6 +229,19 @@ pub fn build_router(state: AppState) -> axum::Router<AppState> {
.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))
.route("/api/system/Menu", post(jnpf::menu_create))
.route("/api/system/Menu/Selector/All", get(jnpf::menu_selector_all))
.route("/api/system/Menu/Selector/Form", get(jnpf::menu_selector_form))
.route("/api/system/Menu/Selector/Page", get(jnpf::menu_selector_page))
.route("/api/system/Menu/getSystemMenu", get(jnpf::menu_get_system_menu))
.route("/api/system/Menu/{id}", get(jnpf::menu_info))
.route("/api/system/Menu/{id}", put(jnpf::menu_update))
.route("/api/system/Menu/{id}", delete(jnpf::menu_delete))
.route("/api/system/Menu/{id}/Actions/Export", get(jnpf::menu_export))
.route("/api/system/Menu/getPermissionGroup/{id}", get(jnpf::menu_permission_group))
.route("/api/system/Menu/getPermission/{id}/{permissionId}", get(jnpf::menu_permission_info))
.route("/api/system/Menu/Selector/{id}", get(jnpf::menu_selector))
.route("/api/system/Menu/SelectorFilter/{id}", get(jnpf::menu_selector_filter))
// 🔴 官方是 `POST /api/permission/Authority/Data/{objectId}/Values`
// —— 与面 A 的 `PUT .../Data/{objectId}` **同前缀不同方法不同路径**
// ⇒ matchit 0.8.4 允许「静态段跟在参数节点后」⇒ 两条可共存。
@@ -737,7 +769,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"], 13);
assert_eq!(body["tables"], 14);
assert_eq!(body["version"], env!("CARGO_PKG_VERSION"));
}
@@ -752,7 +784,7 @@ mod tests {
let port = serve(new_state(db().await)).await;
// 🔴 按**路径**列(同一路径多个方法只算一条)—— 每条都用 PATCH 探 405。
const JNPF_REGISTERED: [&str; 31] = [
const JNPF_REGISTERED: [&str; 55] = [
"/api/permission/Users",
"/api/permission/Users/any-id",
"/api/permission/Users/BatchDelete",
@@ -779,6 +811,30 @@ mod tests {
"/api/permission/Organize",
"/api/permission/Organize/any-id",
"/api/permission/Organize/Selector",
"/api/permission/Organize/AsyncPosList",
"/api/permission/Role/Selector",
"/api/permission/Role/RoleCondition",
"/api/permission/Role/any-id",
"/api/permission/Position",
"/api/permission/Position/Selector",
"/api/permission/Position/SelectorTree",
"/api/permission/Position/PositionCondition",
"/api/permission/Position/SelectedList",
"/api/permission/Position/any-id",
"/api/permission/Position/any-id/Actions/DutyPosition",
"/api/permission/Position/any-id/Actions/DutyUser",
"/api/permission/Group/Selector",
"/api/system/Menu",
"/api/system/Menu/any-id",
"/api/system/Menu/Selector/All",
"/api/system/Menu/Selector/Form",
"/api/system/Menu/Selector/Page",
"/api/system/Menu/Selector/any-id",
"/api/system/Menu/SelectorFilter/any-id",
"/api/system/Menu/getSystemMenu",
"/api/system/Menu/any-id/Actions/Export",
"/api/system/Menu/getPermissionGroup/any-id",
"/api/system/Menu/getPermission/any-id/any-id",
"/api/system/DictionaryData/All",
"/api/system/HomeData",
"/api/system/MenuData/useModuleNum/any-id",