diff --git a/.workbuddy/memory/2026-10-31.md b/.workbuddy/memory/2026-10-31.md index 6d8d284..98dc491 100644 --- a/.workbuddy/memory/2026-10-31.md +++ b/.workbuddy/memory/2026-10-31.md @@ -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(只消红条,不建表) diff --git a/HANDOFF.md b/HANDOFF.md index a694428..5c01de3 100644 --- a/HANDOFF.md +++ b/HANDOFF.md @@ -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 会红。 ---