- axum 0.8 + pglite:12 张表,多应用按 App-Code 头解析 f_system_id 隔离 - 面 A(ssw/react 形状)+ 面 B(官方 JNPF 形状,Vue-Version: 3)双契约并存 - 业务模块 asset/DataResource;面 B 用户 CRUD 9 条已落地 - 六道闸门 + 两把运行时尺子(perm-smoke 43 / perm-smoke-jnpf 23) - scripts/:前端接口清单、页面依赖反查、运行时探针
25 KiB
面 B:官方 JNPF 契约面(规格书)
这份文档是「尺子的规格」 ——
scripts/perm-smoke-jnpf.sh逐条断言的就是本文的每一条。 官方源码依据见JNPF_SOURCE_AUDIT.md(每条带文件:行号)。
0. 一句话
面 A = 本仓现有契约(ssw/react 技能那套),一个字都不动。
面 B = 官方 JNPF 契约(官方 Vue 前端那套),与面 A 共用同一个进程、同一个库、同一套 base_* 表。
⇒ 官方 JNPF 的 Vue 前端,可以直接指着本仓的后端跑;本仓的 React 前端,也照旧跑。
1. 为什么需要面 B
审计结论(JNPF_SOURCE_AUDIT.md §3):
| 差异 | 能否靠「改前端」绕过 | 结论 |
|---|---|---|
D2 列表响应(PageListVO) |
❌ 官方前端分页组件要 pagination.total |
必须后端出 |
D3 CurrentUser 形状(PcUserVO) |
❌ 官方前端读 permissionList / userInfo.* |
必须后端出 |
| D4 码表缺 602 | ❌ 官方前端靠 602 清 token 跳登录 | 必须后端出 |
D5 菜单接口(ModuleBySystem) |
❌ 官方前端启动就调 | 必须后端出 |
D6 点权限(f_en_code) |
⚠️ 可前端硬编码,但不可维护 | 后端出更好 |
| D1 端点风格 | ✅ 官方前端路径写死 | 必须后端出(新路径) |
| D7 请求头 | ✅ 忽略即可 | 后端别拒 |
| D8 口令存储 | ✅ 换算期处理 | 迁移期一次性 |
⇒ 结论:「官方前端 → Rust 后端能跑」这件事,后端必须有一层官方形状。这就是面 B。
2. 面 A / 面 B 的边界规则
2.1 路由层:面 B = 新增路径 + 少数共用路径
| 情况 | 处理 |
|---|---|
官方路径与面 A 不冲突(/api/permission/*、/api/system/*) |
新增面 B 路由,与面 A 并存 |
官方路径与面 A 冲突(/api/oauth/Login、/api/oauth/CurrentUser、PUT /api/permission/Authority/Data/{objectId}) |
共用同一路由,按规则分流(见 §2.2) |
| 官方请求体是面 A 请求体的超集(授权写) | 直接兼容,零改动 |
2.2 共用路由的分流规则:按请求头 Vue-Version: 3 判面
官方前端必然带这三个头(jnpf-web-apps-main/src/api/request.ts:109-112):
App-Code: <应用编码>
Jnpf-Origin: pc
Vue-Version: 3
🔴 本仓前端带其中两个(src/frontend/src/api/request.ts:35-37,与官方同款):
config.headers.set('App-Code', 'sswflow');
config.headers.set('Jnpf-Origin', 'pc'); // ← 官方也有 ⇒ **不能**用它判别
if (token) config.headers.set('Authorization', token);
⇒ 三个官方头里,本仓前端唯一不发的是 Vue-Version ⇒ 判别只能用它。
⇒ 判定规则(唯一规则,全局生效):
请求头含 "Vue-Version: 3" ⇒ 走【面 B】官方形状
否则 ⇒ 走【面 A】ssw 形状
为什么用这个头:官方前端无条件携带 Vue-Version: 3,而本仓前端从不携带 ⇒ 零歧义、零配置、双方都不需要改。
(App-Code 与 Jnpf-Origin 不作判据 —— 本仓前端也发这两个,判了必错。)
🔴 红线:本仓前端禁止发 Vue-Version 头(一旦发出,面 A 的请求会被误判成面 B ⇒ 契约整体错位)。
scripts/check-module.sh 的「全局红线」段静态钉住这一条(查 src/frontend/src/api/request.ts),
面 B 尺子 scripts/perm-smoke-jnpf.sh 也必须带 Vue-Version: 3(否则面 B 请求不会被识别成面 B)—— 同一处静态自检。
2.3 三个共用路由的逐条结论
| 路由 | 面 A 现状 | 面 B 要求 | 判定 |
|---|---|---|---|
POST /api/oauth/Login |
{token, expiresIn:7200, tokenTypeName:'bearer'} |
官方读 data.token(LoginVO.java:17) |
✅ 零改动(官方前端忽略多余字段) |
PUT /api/permission/Authority/Data/{objectId} |
body {objectType, module:[…]} |
官方 body = {objectType, module, button, column, resource, form, systemIds}(AuthorizeDataUpForm.java:14-38) |
✅ 零改动(官方 body 是面 A 的超集;面 A 只消费 objectType+module) |
GET /api/oauth/CurrentUser |
{userInfo:{4 字段}, menuList:[本仓自定义节点]} |
官方 PcUserVO(PcUserVO.java:16-34) |
⚠️ 必须分流(§3.3) |
3. 面 B 端点规格
3.1 认证
POST /api/oauth/Login
- 共用面 A,零改动。
- 请求:
application/x-www-form-urlencoded,account/password(密文 hex) /grant_type=password。 - 响应:
ActionResult<{token, expiresIn, tokenTypeName}>。官方前端只读data.token⇒ 兼容。
GET /api/oauth/CurrentUser ★ 形状分流点
面 A 形状(无 Vue-Version 头)——不动:
{ "code":200, "msg":"操作成功", "data":{
"userInfo":{ "userId":"…","userAccount":"admin","userName":"admin","isAdministrator":true },
"menuList":[ …本仓菜单节点… ] } }
面 B 形状(带 Vue-Version: 3)——官方 PcUserVO:
{ "code":200, "msg":"操作成功", "data":{
"menuList":[ { "id":"…","fullName":"系统管理","enCode":"…","parentId":"0","icon":"…",
"hasChildren":true,"urlAddress":"system/User","pageAddress":"…","linkTarget":null,
"children":[…],"type":1,"propertyJson":null,"sortCode":0,
"systemId":"…","isData":false } ],
"permissionList":[ { "modelId":"…","moduleName":"…","button":[],"column":[],"resource":[],"form":[] } ],
"userInfo":{ "userId":"…","userAccount":"admin","userName":"…","isAdministrator":true,
"headIcon":null,"organizeId":"…","organizeName":"…",
"positionId":"…","positionName":"…","systemId":"…","systemCode":"…",
"prevLogin":1,"prevLoginTime":…,"prevLoginIPAddress":null,"prevLoginIPAddressName":null },
"currentSystemId":"…",
"sysConfigInfo":{ … } } }
字段依据:
PcUserVO.java::19menuList /:22permissionList /:25userInfo /:27currentSystemId /:33sysConfigInfoAllMenuSelectVO.java::12id /:15fullName /:18enCode /:21parentId /:24icon /:27hasChildren /:30urlAddress /:33pageAddress /:36linkTarget /:39children /:42type /:44propertyJson /:46sortCode /:48systemId /:50isDataPermissionModel.java::10modelId /:12moduleName /:14button /:16column /:18resource /:20formUserCommonInfoVO.java::16userId /:19userAccount /:22userName /:25headIcon /:28organizeId /:31organizeName /:34positionId /:37positionName /:40prevLogin /:43prevLoginTime /:47prevLoginIPAddress /:51prevLoginIPAddressName /:75isAdministrator /:83systemId /:87systemCode
硬性要求:
- 五个顶层字段一个都不能少(官方前端按
menuList+permissionList渲染侧栏与按钮)。 menuList节点的type:1=目录 /2=页面(与base_module.f_type语义一致)。permissionList可为空数组[](但不能是null)—— 官方前端遍历它。
📌 不实现
sysConfigInfo的真实内容时,返{}(空对象)而不是null⇒ 官方前端不炸。
POST /api/oauth/Logout — 可后置
官方 LoginController.java:155。本仓 v1 无此端点(前端本地清 token)。
优先级:低(官方前端退出时若 404,会在控制台报错但不影响使用)。
3.2 用户 /api/permission/Users
列表 GET /api/permission/Users
请求参数(UserPagination.java:11-36 = Pagination.java:19-29 + 过滤):
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
pageSize |
long | 20 |
Pagination.java:19 |
currentPage |
long | 1 |
Pagination.java:25 |
sort |
string | "DESC" |
Pagination.java:21 |
sidx |
string | "" |
Pagination.java:23 |
keyword |
string | — | 关键字(Pagination 父类 Page) |
gender |
string | — | UserPagination.java:14 |
enabledMark |
int | — | :17(0 禁用 / 1 启用 / 2 锁定 / 12 启用和锁定) |
groupId / organizeId / positionId / roleId |
string | — | :20/23/26/29 |
showSubOrganize |
int | — | :32 |
dataType |
int | — | :35(1 = 全部数据) |
响应(UserController.java:295 ⇒ ActionResult<PageListVO<UserListVO>>):
{ "code":200, "msg":"操作成功", "data":{
"pagination":{ "currentPage":1, "pageSize":20, "total":42 },
"list":[ { "id":"…","account":"admin","realName":"管理员","fullName":"管理员",
"gender":null,"mobilePhone":null,"email":null,"organize":"…",
"description":null,"enabledMark":1,"creatorTime":1730000000000,
"sortCode":0,"lockMark":0,"handoverMark":0,"isAdministrator":1,
"headIcon":null,"unlockTime":null,"position":"…",
"isDutyUser":0,"maxRelationId":null } ] } }
列表项字段依据:UserListVO.java:19-74。
硬性要求:
data必须是对象(含pagination+list),不是裸数组。list项不得含password/secretkey。pagination.total= 总条数(不是本页条数)。currentPage/pageSize原样回显请求值(官方前端会算总页数)。creatorTime是毫秒时间戳(数字)。isAdministrator是数字0|1(不是布尔)—— 官方 VO 是Integer(UserListVO.java:60)。
单条 / 增 / 改 / 删(UserController.java:355/409/429/496):
| 方法 | 路径 | 官方权限码 | 面 B 行为 |
|---|---|---|---|
| GET | /api/permission/Users/{id} |
permission.user |
返 UserListVO 同构单对象 |
| POST | /api/permission/Users |
permission.user |
建号;body 用去前缀名(account/realName/organizeId/…) |
| PUT | /api/permission/Users/{id} |
permission.user |
改;body 同上 + id 在 path |
| DELETE | /api/permission/Users/{id} |
permission.user |
删;成功返 ActionResult.success() |
权限码语义(面 B):官方用 @SaCheckPermission("permission.user") ⇒ 判定依据是
该用户是否持有 f_en_code = 'permission.user' 的菜单授权(base_module.f_en_code)。
本仓的菜单路径白名单(system/User)在面 B 不适用 ⇒ 面 B 用 f_en_code 判。
🔴 这意味着面 B 必须能读到
f_en_code且种子菜单要带f_en_code值。 本仓base_module表已有f_en_code列(官方 DDL 逐字)⇒ 列在,值要补种子。
3.3 角色 /api/permission/Role
| 方法 | 路径 | 官方出处 | 权限码 |
|---|---|---|---|
| GET | /api/permission/Role |
RoleController.java:99-100 |
permission.auth OR permission.role |
| GET | /api/permission/Role/{id} |
:273 |
permission.role |
| POST | /api/permission/Role |
:122 |
permission.role |
| PUT | /api/permission/Role/{id} |
:165 |
permission.role |
| DELETE | /api/permission/Role/{id} |
:298 |
permission.role |
| GET | /api/permission/Role/Selector |
:327 |
登录即可 |
列表响应:ActionResult<PageListVO<RoleListVO>>(RoleController.java:101)—— 形状同 §3.2 的列表规则。
3.4 组织 /api/permission/Organize
| 方法 | 路径 | 官方出处 | 权限码 |
|---|---|---|---|
| GET | /api/permission/Organize/AsyncList/{id} |
OrganizeController.java:107-110 |
permission.organize OR permission.user OR permission.role OR … |
| GET | /api/permission/Organize |
前端 organize.ts:14 |
登录即可 |
| GET | /api/permission/Organize/{id} |
:290 |
permission.organize |
| POST | /api/permission/Organize |
:179 |
permission.organize |
| PUT | /api/permission/Organize/{id} |
:212 |
permission.organize |
| DELETE | /api/permission/Organize/{id} |
:315 |
permission.organize |
| GET | /api/permission/Organize/Selector |
:145 |
登录即可 |
注意:官方组织列表是按 parentId 逐层取(AsyncList/{id},id = 父节点 id,根为 0)⇒ 面 B 必须支持 AsyncList 路径,
不能只有"全量列表"。
🔴 AsyncList/{id} 的响应是 ActionResult<PageListVO<OrganizeListVO>>(OrganizeController.java:110-112)
⇒ data 是 {pagination, list}(PageListVO),不是裸数组。
3.5 菜单 /api/system/Menu
| 方法 | 路径 | 官方出处 | 面 B 行为 |
|---|---|---|---|
| GET | /api/system/Menu/ModuleBySystem |
ModuleController.java:121 |
官方前端启动入口:返该系统下的菜单列表(平铺) |
| GET | /api/system/Menu/{systemId}/TreeView |
:332 |
菜单树 |
| GET | /api/system/Menu/Selector/{id} |
:267 |
上级菜单下拉 |
| GET | /api/system/Menu/Selector/All |
:444 |
全量下拉 |
| POST | /api/system/Menu |
:169-170 |
新建 |
| PUT | /api/system/Menu/{id} |
:194-195 |
修改 |
| GET | /api/system/Menu/{id} |
:248-249 |
详情 |
| DELETE | /api/system/Menu/{id} |
:228-229 |
删除 |
ModuleBySystem 的 systemId 从哪来?官方前端 api/system/menu.ts:9 传 data(query)。
本仓单系统 ⇒ 忽略入参、返本仓全部菜单(平铺,parentId 表达层级)。
🔴 ModuleBySystem 的 data 不是裸数组 —— 官方返回 ActionResult<ListVO<MenuListVO>>
(ModuleController.java:121 + ListVO.java:19-22)⇒ 线形是 { "list": [...] }。
(ListVO 全仓只有 list 一个字段;PageListVO 才是 pagination + list。)
⇒ 尺子断言 16 判的是 code=200 + data.list 是数组,不是「data 是数组」。
菜单项字段:官方 base_module 实体字段(f_id/f_full_name/f_en_code/f_parent_id/f_icon/f_url_address/f_type/f_sort_code/f_system_id/f_property_json/f_link_target/f_page_address)
⇒ 键名去 f_ 前缀后 camelCase,与本仓 JSON 键名规则一致。
3.6 授权 /api/permission/Authority
| 方法 | 路径 | 官方出处 | 面 B 行为 |
|---|---|---|---|
| POST | /api/permission/Authority/Data/{objectId}/Values |
AuthorizeController.java:99-100 |
返权限树 + 已勾选值 |
| PUT | /api/permission/Authority/Data/{objectId} |
:159-160 |
✅ 与面 A 共用,零改动 |
Values 的请求体(DataValuesQuery.java:14-24):
{ "type":"module", "objectType":"role", "moduleIds":"" }
type= 项目类型:module(菜单)/button/column/form/resourceobjectType=role/organize/position/user(PermissionConst.java:8-58)- 🔴
moduleIds是String(逗号分隔的菜单 id),不是数组(DataValuesQuery.java:19-20) - 🔴
type为空 ⇒ 官方直接返ActionResult.fail(MsgCode.PS012)(AuthorizeController.java:112-114)⇒ 不能省type
响应:官方 AuthorizeDataReturnVO.java:16-27 = { list: AuthorizeDataReturnModel[], ids: String[], all: String[] }
(list = 权限树模型集合 / ids = 已勾选 id / all = 全部 id,all 不含菜单 id)。
🔴 面 B v1 降级:本仓不实现完整权限树模型 ⇒ 先只保证 ids(已勾选 id)语义正确,
list 可返空数组、all 可返本仓全部菜单 id;并在面 B 规格里标注「list 未与官方 AuthorizeDataReturnModel 逐字对齐」。
官方前端的「授权弹窗」需要 list 才是完整体验 ⇒ 属面 B 后续项。
4. 码表(面 B)
| 码 | 场景 | 官方行为 |
|---|---|---|
| 200 | 成功 | 放行 |
| 400 | 业务失败 | 提示 msg |
| 401 | 验证错误 | 提示 msg |
| 500 | 异常 | 提示 msg |
| 600 | 登录过期 | 提示 |
| 601 | 被踢出 | 清 token |
| 602 | token 失效 | 清 token 跳登录 ★ 官方前端靠它 |
| 403 | 权限异常 | 跳无权限页 |
面 B 硬性要求:
- 未登录/无效 token 一律返
602(不是 600) —— 官方前端request.ts:78-80只对TOKEN_ERROR/TOKEN_LOGGED/TOKEN_TIMEOUT清 token。 - 权限不足返
403。 - 业务失败返
400+msg(HTTP 仍是 200)。
⚠️ 这与面 A 不同(面 A 用
600)⇒ 同一个「未登录」场景,面 A 返 600、面 B 返 602。这正是分流规则要处理的地方。
5. 请求头
面 B 必须接受(且不得因此报错):
| 头 | 值 | 作用 |
|---|---|---|
Jnpf-Origin |
pc |
本仓前端也发 ⇒ 不作判据 |
Vue-Version |
3 |
面 B 判别依据(§2.2)——本仓前端唯一不发的一头 |
App-Code |
应用编码 | 本仓单系统 ⇒ 忽略 |
Authorization |
Bearer <token> |
鉴权(面 A 同) |
6. 尺子:scripts/perm-smoke-jnpf.sh
6.1 它测什么
第二把尺子(第一把是 scripts/perm-smoke.sh,测面 A 的 32 条断言)。
本脚本测官方形状:同一个后端进程,按官方请求头 + 官方路径 + 官方响应形状断言。
6.2 断言清单(目标 18 条)
| # | 断言 | 判据 |
|---|---|---|
| 1 | 面 A 未受影响 | 无 Vue-Version 头时 CurrentUser 仍是面 A 形状(2 字段) |
| 2 | 面 A 登录仍通 | 无头登录 → code=200 + token |
| 3 | 面 B 登录 | 带 Vue-Version: 3 登录 → code=200 + data.token |
| 4 | 面 B CurrentUser 顶层 5 字段 |
data 同时有 menuList/permissionList/userInfo/currentSystemId/sysConfigInfo |
| 5 | 面 B menuList 节点形状 |
AllMenuSelectVO 的 15 个字段齐全(id/fullName/enCode/parentId/icon/hasChildren/urlAddress/pageAddress/linkTarget/children/type/propertyJson/sortCode/systemId/isData) |
| 6 | 面 B permissionList 是数组 |
[] 也算过(不能是 null) |
| 7 | 面 B 无 token → 602 |
不是 600、不是 401 |
| 8 | 面 B 无 token → 未知路由仍 404 | |
| 9 | 面 B 用户列表是 PageListVO |
data 有 pagination + list |
| 10 | pagination 三字段 |
currentPage/pageSize/total 都在 |
| 11 | pagination.total 是总条数 |
≥ list.length |
| 12 | 列表项无 password/secretkey |
逐项检查 |
| 13 | 列表项 isAdministrator 是数字 |
0 或 1,不是 true/false |
| 14 | 角色列表是 PageListVO |
同 #9 |
| 15 | 组织列表支持 AsyncList/{id} |
根节点 id=0 能取到一级组织 |
| 16 | 菜单 ModuleBySystem 可达 |
code=200 + data.list 是数组(官方是 ListVO,不是裸数组) |
| 17 | 授权写(官方 body 超集) | 用官方完整 body 发 PUT /api/permission/Authority/Data/{id} → 成功且 module 真的写进去 |
| 18 | 授权读是 POST | POST .../Data/{id}/Values → code=200 |
6.3 进度报告(关键设计)
脚本不假装全过:
- 每条断言独立记
PASS/FAIL/SKIP(未实现); - 结尾打印
面 B 覆盖 N/M(M = 18); - 退出码:
0= 全部 PASS;1= 有 FAIL;2= 用法错 / 后端不可达(前置错误)。
⇒ 在面 B 尚未实现时,它是一把诚实量进度的尺子(SKIP 计入未覆盖,不算 PASS)。
2026-10-26 当前状态:
PASS=18 FAIL=0 SKIP=0⇒ 18/18 全覆盖,退出码 0。SKIP机制保留(面 B 尚未落地的端点、或后端还没起时仍如实记 SKIP / 退出码 2)。
6.4 与面 A 尺子的关系
perm-smoke.sh |
perm-smoke-jnpf.sh |
|
|---|---|---|
| 测的面 | A(ssw) | B(官方) |
| 判别 | 无特殊头 | Vue-Version: 3 |
| 断言数 | 32 | 18 |
| 都要跑 | ✅ | ✅(面 B 落地后) |
两把契约尺子必须同时绿(perm-smoke.sh 面 A + perm-smoke-jnpf.sh 面 B;本仓另有四道静态闸门,
合计六道闸门)—— 面 A 绿证明「没把原契约改坏」,面 B 绿证明「官方形状达标」。
7. 落地顺序(面 B 的实施建议)
| 阶段 | 内容 | 产出 | 状态 |
|---|---|---|---|
| S1 | 分流机制(Vue-Version: 3 判面)+ 码表补 602 |
面 A 零影响;面 B 未登录返 602 | ✅ 已落地 |
| S2 | CurrentUser 面 B 形状(PcUserVO) |
官方前端能登录并渲染侧栏 | ✅ 已落地 |
| S3 | 分页列表引擎(PageListVO) |
官方用户/角色/组织列表能翻页 | ✅ 已落地 |
| S4 | 菜单 ModuleBySystem + f_en_code 种子 |
官方前端能拿到菜单树 | ✅ 已落地 |
| S5 | f_en_code 判权 + permissionList |
官方前端按钮显隐正确 | ✅ 已落地(按钮级除外,见 B4) |
| S6 | 授权 Values 读取 + 完整树 |
授权弹窗可用 | ✅ 已落地(树模型除外,见 B1) |
每阶段结束跑
bash scripts/perm-smoke-jnpf.sh⇒ 覆盖数从0/18逐步爬到18/18。2026-10-26:S1–S6 一次性落地完毕 ⇒
bash scripts/perm-smoke-jnpf.sh= PASS=18 FAIL=0 SKIP=0(18/18)。 面 A 零改动 ⇒bash scripts/perm-smoke.sh仍为 PASS=32 FAIL=0,cargo test= 195 passed / 0 failed。落地对照:
阶段 落在哪 S1 src/backend/src/platform/jnpf.rs(is_jnpf/require_login_jnpf)、src/backend/src/platform/envelope.rs(code::*官方码表)、src/backend/src/platform/auth.rs(require_login_any)S2 src/backend/src/platform/jnpf.rs(current_user/build_user_info/build_menu_tree/build_permission_list)S3 src/backend/src/platform/jnpf.rs(Paging/page_list/list_vo)S4 src/backend/src/platform/jnpf.rs(module_by_system)、src/backend/src/platform/seed.rs(BuiltinMenu.en_code+ 存量库 NULL 回填)S5 src/backend/src/platform/permission.rs(has_en_code_permission—— 第二套判据)S6 src/backend/src/platform/jnpf.rs(authority_values)、src/backend/src/routes.rs(POST .../Values)
8. 已知不对齐项(如实记录)
| # | 项 | 状态 | 影响 |
|---|---|---|---|
| B1 | AuthorizeDataReturnVO 的 list(权限树模型) |
未逐字对齐(面 B 只保证 ids/all 语义,list 返空数组) |
官方授权弹窗需二次适配 |
| B2 | sysConfigInfo |
返 {} 空对象 |
官方前端不读关键字段 |
| B3 | currentSystemId |
返本仓固定系统 id | 单系统场景等价 |
| B4 | 按钮级权限(btn_*) |
未实现(permissionList 的 button/column/resource/form 恒空数组) |
官方前端按钮恒显(不隐藏) |
| B5 | 数据权限方案(ModuleDataAuthorizeLink) |
不做 | 官方前端相关页面 404 |
| B6 | 导入导出(ImportData/ExportData/…) |
不做 | 官方前端相关按钮报错 |
| B7 | 官方 password 存储格式(secretkey) |
见 JNPF_SOURCE_AUDIT.md §6.3 |
迁官方时一次性换算 |
| B8 | 业务菜单的 f_en_code |
本仓自定占位(permission.demo / permission.shop.product / permission.books.book)—— 官方没有这三个模块 |
迁官方时要改成官方编码;当前占位不与官方 permission.* 冲突 |
| B9 | permissionList 的粒度 |
本仓按「每个可见菜单一条、modelId = 菜单 id」给(对齐官方前端 permissionList.find(o => o.modelId === menuId) 的用法) |
官方动态模型页的按钮仍恒显(并入 B4) |
| B10 | 组织列表 AsyncList/{id} 的分页 |
本仓按父 id 逐层取,不分页(pageSize = 本层条数) |
官方前端逐层展开可用;机构极多时需自行加 pageSize 过滤 |
🔴 本表就是官方端点台账的「偏差来源」:docs/contract.md 附录 A 的 [OFFICIAL] 区段里,
每条官方端点的 status = partial 时,其 note 列指的就是这里的一条 B#
(B1 → 两个授权端点;B2/B3/B4/B9 → CurrentUser;B10 → Organize/AsyncList/{id})。
⇒ 改了本表 ⇒ [OFFICIAL] 的 note 也要跟着改(否则两边说法不一致)。
🔴 覆盖进度由 bash scripts/check-contract.sh 的 CC10 打印(当前 8/47)—— 算出来的。
9. 变更记录
| 日期 | 变更 |
|---|---|
| 2026-10-26 | 首版。确立「面 A 不动 + 面 B 新增」的边界规则、请求头分流规则、18 条断言清单、6 阶段落地顺序、7 条已知不对齐项。 |
| 2026-10-26 | S1–S6 全部落地。新增 src/backend/src/platform/jnpf.rs(面 B 全部端点与响应形状);routes.rs 增 5 条面 B 路由(面 A 的 27 条一字未动);seed.rs 增 f_en_code 种子 + 存量库 NULL 回填;permission.rs 增 has_en_code_permission(第二套点权限判据);envelope.rs 补齐官方码表(含 602)。尺子:面 B PASS=18 FAIL=0 SKIP=0(18/18),面 A PASS=32 FAIL=0,cargo test 195/0。新增不对齐项 B8–B10。 |