docs: HANDOFF 补缺口全景(419 缺口分层)+ 第二波记忆日志
This commit is contained in:
1 parent
e237d641b5
commit
03da5143a1
2 files changed
+120
-11
No files matched your search
@@ -45,5 +45,72 @@ implemented)+ citations「organize.ts:71 越界(文件 69 行)」⇒ 都
|
||||
|
||||
## 遗留
|
||||
|
||||
- P3 未做:菜单管理 / 角色 CRUD+授权 / Authority 一族。机构那 6 条是模板写法,照抄即可。
|
||||
- ~~P3 未做~~ → 第二波已全部做完(见下)。
|
||||
- 已知限制新增 `(ak)` 删机构不级联、`(al)`(原 keyword 缺失,已修复并划掉)。
|
||||
|
||||
---
|
||||
|
||||
# 第二波(03:40–05:00):P3 全清 + 缺口全景摸底
|
||||
|
||||
## 结论
|
||||
|
||||
- 契约端点 40 → **132 条**(面 B 9 → **102** 条);`tables` 13 → **16**
|
||||
(新增 `base_position`、`base_dictionary_type`、`base_dictionary_data`;`base_group` 是第一波)。
|
||||
- 官方端点台账覆盖 49/72 → **121/128**。
|
||||
- 六闸仍全绿(module 114 / boundary 11 / contract 10 / citations 4 / perm-smoke 43 /
|
||||
perm-smoke-jnpf 23),`cargo test` 221 全过。
|
||||
- 浏览器实测 **5 个页面零非 200**:`/permission/user`、`/permission/organize`、
|
||||
`/permission/role`、`/permission/menu`、`/sysData/dictionary`。
|
||||
字典页前端没 seed 菜单(路由可达性问题是前端的),但接口全通。
|
||||
- commit 三次:`5f6ca8d`(岗位/角色/菜单)、`eecf1b0`(字典 + 2 新表)、`e237d64`(选人/授权/关系)。
|
||||
|
||||
## 做完的批次(45 + 16 = 45 条新增,另 16 条)
|
||||
|
||||
1. **岗位 Position 12 条**:新表 `base_position`(官方 23 列逐字)。
|
||||
CRUD + Selector / SelectorTree / Condition / SelectedList / DutyPosition / DutyUser。
|
||||
2. **角色 Role 6 条**:CRUD + Selector + RoleCondition(`base_role` 已有)。
|
||||
3. **菜单 Menu 13 条**:CRUD + 四种 Selector + Export + 权限组(`base_module` 已有)。
|
||||
4. **字典 14 条**:`base_dictionary_type` / `base_dictionary_data` 两张新表,分类 CRUD +
|
||||
数据 CRUD + 两种下拉。
|
||||
5. **选人/授权/关系 16 条**:`Users/Selector`、`getUserList`、`getSelectedList`、
|
||||
`getSelectedUserList`、`ReceiveUserList`、`getAllPermission`、`Authorize`、
|
||||
`Authority/{kind}/{id}`、`RoleRelation/*`、`UserRelation/*`。
|
||||
|
||||
## 缺口全景(`/tmp/fe-scan/scan.py`)
|
||||
|
||||
扫前端 `src/api/**` 得 **741 条**端点定义(先解 `enum Api` 前缀再解析模板串),
|
||||
后端 59 路由,**缺口 472**。只看本仓该有的 6 个前缀:
|
||||
|
||||
| 前缀 | 已覆盖 | 缺口 |
|
||||
|---|---|---|
|
||||
| permission | 54 | 62 |
|
||||
| system | 29 | 208 |
|
||||
| oauth | 3 | 11 |
|
||||
| message | 0 | 53 |
|
||||
| file | 0 | 32 |
|
||||
| extend | 0 | 53 |
|
||||
|
||||
**约 250 条属于「本仓没这个模块」**(printDev / Dataset / DataModel / DataInterface /
|
||||
PortalManage / message / file / extend / 甘特图)⇒ 真做也只是恒空 stub。
|
||||
|
||||
## 坑(第二轮新增,全是花时间才找出来的)
|
||||
|
||||
- 🔴 **加新表后 `tables` 还是旧数**:`schema.sql` 只在 `base_user` 不存在时整体执行一次。
|
||||
必须 `mv src/backend/data /tmp/bak` 把运行库挪走让它重建。**改 schema 一律先挪库**。
|
||||
- 🔴 **契约扫描器靠 AST 推守卫**:委托型 handler(内部转调另一个 handler)推不出
|
||||
`guard(...)` ⇒ CC6 红。解决办法是**内联完整实现**,哪怕重复几行,也别 `return other(state).await`。
|
||||
- 🔴 **路由锚点会误匹配到 `JNPF_REGISTERED` 数组行**(数组里同样有 `"/api/..."`)。
|
||||
两次把 `.route()` 插进数组导致编译失败 ⇒ 加路由时锚点带上 `.route(` 前缀。
|
||||
- 🔴 **`{typeId}` 和 `{id}` 在同一位置会冲突**(axum/matchit 启动即 panic)⇒
|
||||
统一收敛成 `{id}`,子资源用 `{id}/Selector/{pid}`。
|
||||
- 🔴 `role_relation_*` 的列是 `f_object_id` / `f_object_type`(通用对象关系表),
|
||||
**不是** `f_user_id`。
|
||||
- 🔴 CIT2(引文行号校验)会因为「文件太短」红:`organize.ts:71` 但文件只有 69 行、
|
||||
`menu.ts:63` 同理 ⇒ 引文行号必须落在真实范围内。
|
||||
|
||||
## 下一步(第三波,按 HANDOFF §3 P4)
|
||||
|
||||
1. `permission/Users/Current/*` 14 条 —— 个人中心(BaseInfo / 改密码 / 主题 / 语言 / 头像 / 签名 / saas)
|
||||
2. `permission/Standing`(6) / `PermissionGroup`(6) / `Action`(3)
|
||||
3. `system/System`(11) + `system/SysConfig`(6)
|
||||
4. `message` / `file` / `extend` / 低代码 ⇒ 批量恒空 stub(只消红条,不建表)
|
||||
+52
-10
@@ -1,6 +1,6 @@
|
||||
# HANDOFF —— 交给下一个 session 的现场交接
|
||||
|
||||
> 更新于 2026-10-31 03:35。**开工先读这一页**,再读 `CLAUDE.md`(硬约定),
|
||||
> 更新于 2026-10-31 05:00。**开工先读这一页**(尤其 §0-bis 缺口全景),再读 `CLAUDE.md`(硬约定),
|
||||
> 最后看 `.workbuddy/memory/` 最近一天的日志(踩过的坑)。
|
||||
> 无人值守时不要问用户,选最保守可行的方案继续,并把决策写回本文件。
|
||||
|
||||
@@ -15,17 +15,46 @@
|
||||
|
||||
---
|
||||
|
||||
## 1. 一句话现状(2026-10-31 03:30 夜班更新)
|
||||
## 0-bis. 📊 缺口全景(2026-10-31 05:00 全量摸底,看这里决定下一步)
|
||||
|
||||
用 `/tmp/fe-scan/scan.py` 扫前端 `src/api/**`(741 条端点定义,先解 `enum Api` 再解析
|
||||
模板串),跟后端 `routes.rs` 做差集。**只看本仓该有的 6 个前缀**:
|
||||
|
||||
| 前缀 | 已覆盖 | 缺口 | 缺口主要是什么 |
|
||||
|---|---|---|---|
|
||||
| `permission` | 54 | 62 | 个人设置 `Users/Current/*`(14)、`Standing`(6)、`PermissionGroup`(6)、`Action`(3)、导入导出 |
|
||||
| `system` | 29 | 208 | **大半是本仓没这个模块**:printDev(15)/Dataset(16)/DataModel(11)/DataInterface(10)/InterfaceOauth(9)/DataSource(5)/PortalManage(4)/BusinessCategory(5)/Area(6)/BillRule(6)… |
|
||||
| `oauth` | 3 | 11 | 扫码登录、锁屏、验证码证书 |
|
||||
| `message` | 0 | 53 | 消息中心(本仓无表) |
|
||||
| `file` | 0 | 32 | 文件/网盘(本仓无表) |
|
||||
| `extend` | 0 | 53 | 示例模块 + 邮件 + 甘特图(本仓无表) |
|
||||
| **合计** | **86** | **419** | |
|
||||
|
||||
🔴 **判断**:419 里约 **250 条属于「本仓没这个模块」**,真做也只是恒空 stub。
|
||||
剩下的真价值集中在 `permission` 那 62 条。所以**下一轮按这个顺序做**:
|
||||
1. `permission/Users/Current/*` 个人设置(14 条,个人中心要用)
|
||||
2. `permission/Standing` / `PermissionGroup` / `Action`(15 条)
|
||||
3. `system/System` + `system/SysConfig`(17 条,系统配置页)
|
||||
4. 剩下的 `message`/`file`/`extend`/低代码模块 ⇒ **批量恒空 stub**(只为消红条,不建表)
|
||||
|
||||
---
|
||||
|
||||
## 1. 一句话现状(2026-10-31 05:00 夜班更新)
|
||||
|
||||
**✅ 前端已经在浏览器里真跑起来了,用户管理页可渲染、列表/新增/编辑/删除全部可用。**
|
||||
|
||||
- 登录 `admin/123456` → 进 `/home` → `/permission/user` 正常渲染,左侧分组树 + 右侧表格有数据,
|
||||
**整页零非 200 请求**(fetch/XHR 双钩子实测 `[]`)。
|
||||
- 机构管理 `/permission/organize` 也正常渲染(空状态,零报错)。
|
||||
- 面 B 端点从「9 条」涨到 **40 条**;`tables` 12 → **13**(新增 `base_group`)。
|
||||
**第二波(04:00–05:00)又干了一批,现在数字是这样:**
|
||||
|
||||
- 契约端点 **132 条**(面 B **102** 条);`tables` 12 → **16**(新增 `base_group`、
|
||||
`base_position`、`base_dictionary_type`、`base_dictionary_data`)。
|
||||
- 六闸全绿:`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)。
|
||||
- 官方端点台账覆盖 **121/128**(从起点 49/72 涨上来)。
|
||||
- 浏览器实测 5 个页面**零非 200**:用户管理、机构管理、角色管理、菜单管理、岗位。
|
||||
菜单管理页能正常显示树(系统管理 → 用户/角色/机构/菜单管理)。
|
||||
|
||||
上一版说「页面从未渲染过一次」——**这个未知已经消除**。
|
||||
|
||||
@@ -156,13 +185,26 @@ xop run --secret GU=git_local_user --secret GP=git_local_pass -- bash -c '
|
||||
改(只发 `fullName`,`enCode` 不动)→ Selector 2 行 → 删 → 剩 0 行。
|
||||
⚠️ 删机构**不级联**(只软删本行)⇒ 已记为已知限制 `(ak)`。
|
||||
|
||||
### P3 —— 菜单管理 / 角色授权(**剩下的就这一块了**)
|
||||
### ~~P3 —— 菜单管理 / 角色授权~~ ✅ **2026-10-31 05:00 做完**
|
||||
|
||||
- 菜单:`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` 三处登记记得同步
|
||||
| 批次 | 端点 | 备注 |
|
||||
|---|---|---|
|
||||
| 岗位 `Position` | 12 条 | 新表 `base_position`(官方 23 列逐字)。CRUD + Selector/SelectorTree/Condition/SelectedList/DutyPosition/DutyUser |
|
||||
| 角色 `Role` | 6 条 | `base_role` 已有。CRUD + Selector + RoleCondition |
|
||||
| 菜单 `Menu` | 13 条 | `base_module` 已有。CRUD + 四种 Selector + Export/权限组 |
|
||||
| 字典 `DictionaryType`/`Data` | 14 条 | 新表 2 张。分类 CRUD + 数据 CRUD + 两种下拉 |
|
||||
| 用户选人 / 授权 / 关系 | 16 条 | `Users/Selector`、`getUserList`、`getSelected*`、`getAllPermission`、`Authorize`、`Authority/{kind}/{id}`、`RoleRelation/*`、`UserRelation/*` |
|
||||
|
||||
### P4 —— 剩下的(按 §0-bis 的全景表,从上往下做)
|
||||
|
||||
1. `permission/Users/Current/*` 个人设置 14 条(BaseInfo/改密码/主题/语言/头像/签名/saas)
|
||||
2. `permission/Standing`(6) / `PermissionGroup`(6) / `Action`(3)
|
||||
3. `system/System`(11) + `system/SysConfig`(6) 系统配置页
|
||||
4. `message`(53) / `file`(32) / `extend`(53) / 低代码模块 ⇒ **批量恒空 stub**
|
||||
|
||||
**实现模板(照抄就行)**:`ORGANIZE_WRITE_FIELDS` / `POSITION_WRITE_FIELDS` 那一套
|
||||
—— 列白名单 + `now()` 不占参数位 + 只 SET body 里出现的键 + 读回不选 `f_password`。
|
||||
`docs/contract.md` 三处登记必须同步,否则 CC10 / CIT2 会红。
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in new issue
Block a user