- 新增 sspf-contract(契约类型,不含 axum)、sspf-store(db/config,不认识 HTTP)、
sspf-sdk(业务包唯一依赖)与 packs/asset 样板包(可独立编译)
- 内核 platform/{envelope,entity,menu,ids,db,config}.rs 改为 re-export,引用路径零变化
- jnpf.rs → face_b.rs,9 处标识符改名;契约字面量(jnpf-origin / jnpfKey)刻意保留
- 新增 check-arch / check-naming / mem-budget 三道闸门;rust-toolchain 锁 1.95.0
- 影响:行为零变化(240 测试 / 九闸全绿 / 空载 7 MB),Profile 从 guard 迁到 config 断开假依赖
334 lines
21 KiB
Markdown
334 lines
21 KiB
Markdown
# HANDOFF —— 交给下一个 session 的现场交接
|
||
|
||
> 更新于 2026-10-31 09:00。**开工先读这一页**(尤其 §0-bis 缺口全景),再读 `CLAUDE.md`(硬约定),
|
||
> 最后看 `.workbuddy/memory/` 最近一天的日志(踩过的坑)。
|
||
> 无人值守时不要问用户,选最保守可行的方案继续,并把决策写回本文件。
|
||
|
||
---
|
||
|
||
## 0. ⚠️ 修正上一版口径(很重要)
|
||
|
||
上一版说「跑 pnpm 必须 `dangerouslyDisableSandbox`」。**这条不完整**:真正拦住 fs 的是
|
||
`NODE_OPTIONS` 里注入的 `node-language-shim.cjs`(brokered-fs),退沙箱它仍在,末尾报
|
||
`CODEBUDDY_BROKER_OUTCOME_UNKNOWN — Broker request timed out`。**正确做法见 §2,用
|
||
`env -u NODE_OPTIONS pnpm ...`** —— 实测 2169 包 46.5s 装完。
|
||
|
||
---
|
||
|
||
## 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 10:00 批次 2 + P0 拆分首批)
|
||
|
||
**✅ 后端已拆成 workspace 多 crate,业务包可独立编译;八道闸门全绿;空载内存 7 MB。**
|
||
|
||
- 新增 `crates/sspf-contract`(契约层,无 axum)、`crates/sspf-sdk`(业务包唯一依赖)、
|
||
`packs/asset`(样板业务包,只依赖 sdk,能 `cargo test -p sspf-pack-asset` 独立跑)。
|
||
- `rust-toolchain.toml` 全仓锁 **1.95.0**(L3 动态库 ABI 一致性强依赖;本机代理限速装不上 1.99)。
|
||
- 新增两道闸门:`scripts/check-arch.sh`(AR1–AR5 + MEM1–MEM2,带 `--self-test`)、
|
||
`scripts/mem-budget.sh`(空载内存实测,用 `vmmap`,**本机沙箱禁 ps/top**)。
|
||
- 内核 `platform/{envelope,entity,menu,ids}.rs` 已改为 re-export 契约层 ⇒ 引用路径零变化。
|
||
- `cargo test --workspace` = **240 条**(不是 221/230 了,拆 crate 后数字会变,别写死)。
|
||
- 长期架构与路线看 **`PLAN.md`**(尤其判断 ⑥ 内存约束、判断 ⑦ 执行器、§4.5 动态库 ABI)。
|
||
|
||
**前端侧(未变):✅ 浏览器里真跑起来了,用户管理页可渲染、列表/新增/编辑/删除全部可用。**
|
||
|
||
- 登录 `admin/123456` → 进 `/home` → `/permission/user` 正常渲染,左侧分组树 + 右侧表格有数据,
|
||
**整页零非 200 请求**(fetch/XHR 双钩子实测 `[]`)。
|
||
- 机构管理 `/permission/organize` 也正常渲染(空状态,零报错)。
|
||
**第二波(04:00–05:00)又干了一批,现在数字是这样:**
|
||
|
||
- 契约端点 **176 条**(面 B **146** 条);`tables` 12 → **21**(新增 `base_group`、
|
||
`base_position`、`base_dictionary_type`、`base_dictionary_data`、`base_user_extra`、
|
||
`base_sign_img`、`base_standing`、`base_permission_group`、`base_action`)。
|
||
- 六闸全绿:`check-module 114` / `check-boundary 11` / `check-contract 10` /
|
||
`check-citations 4` / `perm-smoke 43` / `perm-smoke-jnpf 23`,`cargo test` **230 全过**。
|
||
- 官方端点台账覆盖 **165/172**(implemented 160 / partial 5 / absent 7)。
|
||
- 浏览器实测 5 个页面**零非 200**:用户管理、机构管理、角色管理、菜单管理、岗位。
|
||
菜单管理页能正常显示树(系统管理 → 用户/角色/机构/菜单管理)。
|
||
|
||
### 批次 2(2026-10-31 08:00–09:00)做了什么
|
||
|
||
`permission/Standing`(8) + `permission/PermissionGroup`(8) + `permission/Action`(5) = **21 条面 B 端点**,
|
||
新增官方表 `base_standing`(15 列) / `base_permission_group`(16 列) / `base_action`(15 列)。
|
||
|
||
**官方 DDL 逐字对齐**(行号已核对 `JNPF-PostgreSQL.sql`):
|
||
`base_action`:1 / `base_permission_group`:3278 / `base_standing`:4071。
|
||
|
||
🔴 **官方陷阱已照抄**:`base_action.f_enabled_mark` 是 **VARCHAR(11)**(不是 INTEGER)⇒
|
||
投影用 `COALESCE(f_enabled_mark,'0')`,**不加 integer CAST**。
|
||
|
||
🔴 **官方语义已对齐**:
|
||
- `base_standing.f_is_system`:**1=系统身份 / 2=自定义** ⇒ 新建默认写 **2**,投影归一化成 `isSystem` 0/1。
|
||
- `base_action.f_type`:**1=自定义** ⇒ 新建强制写 1(前端 `record.type == 1 ? '自定义' : '系统'`)。
|
||
- `PermissionGroupController.list` 会用 `userService.getFullNameByIds` 把 `f_permission_member`
|
||
的 **id 串换成用户名串** ⇒ 本仓用子查询 `string_agg(...)` 做同样的替换。
|
||
|
||
### 🔴 本轮踩到并解决的 4 个真 bug(都有回归测试 + 反自证)
|
||
|
||
| # | 症状 | 根因 | 修法 |
|
||
|---|---|---|---|
|
||
| ① | `GET /PermissionGroup/PermissionMember/{id}` → 500 / `data:null` | `f_id = ANY($1::text[])` ⇒ pglite-rs 把 `$1::text[]` 当成 PG 数组类型 `_text` | 改 `ANY(string_to_array($1::text, ','))`(**函数在 SQL 里做** ⇒ 参数仍是 text) |
|
||
| ② | `DELETE /PermissionGroup/{id}` → 500 `42P18` | 软删 `base_authorize` 的 SQL 带了 `$1` 但 WHERE/赋值里**没用到** ⇒ PG 拒「无法确定 $1 类型」 | 把 `f_delete_user_id = $1::text` 写进 SET(既是审计列,也用掉参数) |
|
||
| ③ | `DELETE /Standing/{id}` 后**关联残留**(静默) | 软删关联的**占位符与参数顺序错位**(SQL `$1`=item_type、`$2`=item_id,参数传 `[account, id]`) | `rel = [item_type, id, account]` + SQL 改 `$1/$2/$3` 对齐 |
|
||
| ④ | 权限组列表 `permissionMember` 返**uuid 串** | 漏了官方的 `getFullNameByIds` 替换 | 子查询 `string_agg` 换成人名串 |
|
||
|
||
回归测试:`src/backend/tests/batch2_it.rs`(**4 条**,每个钉一个 bug)。
|
||
**反自证全部做过**:逐个把修复回退 ⇒ 测试精确复现原始报错(`cannot convert between String and _text` /
|
||
`42P18` / 关联残留 n=1 / uuid 串)⇒ 恢复后 4 条全过。
|
||
|
||
### 🔴 上一版说「页面从未渲染过一次」——**这个未知已经消除**。
|
||
|
||
### 🔴 上一批(第一批)踩到并解决的 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() }`。
|
||
|
||
---
|
||
|
||
## 2. 运行中的现场(断了就按这里重启)
|
||
|
||
### 后端(端口 30000)
|
||
|
||
```bash
|
||
cd ~/Desktop/workspace/ssw-platform
|
||
RUSTC_WRAPPER=sccache cargo build --manifest-path src/backend/Cargo.toml # 改代码后
|
||
# 🔴 **尺子跑的是 release 产物** ⇒ 跑尺子前必须 `cargo build --release`
|
||
RUSTC_WRAPPER=sccache cargo build --release --manifest-path src/backend/Cargo.toml
|
||
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":21,...}
|
||
```
|
||
|
||
拿 token(面 B):
|
||
|
||
```bash
|
||
ENC=$(./target/debug/ssw-platform --enc 123456)
|
||
curl -s -X POST http://127.0.0.1:30000/api/oauth/Login \
|
||
-H 'Content-Type: application/x-www-form-urlencoded' \
|
||
-H 'Vue-Version: 3' -H 'App-Code: mainSystem' \
|
||
--data-urlencode account=admin --data-urlencode "password=$ENC"
|
||
# → data.token(lite- 前缀)。Authorization 头是**裸 token,没有 bearer 前缀**
|
||
```
|
||
|
||
### 前端(`~/Desktop/workspace/jnpf/7.0/frontend/web/jnpf-web-monorepo-framework`)
|
||
|
||
🔴 **必须 `env -u NODE_OPTIONS`**:否则被 brokered-fs shim 逐次拦截(0.15 包/s,末尾
|
||
`ERR_PNPM_CODEBUDDY_BROKER_DENY` / `CODEBUDDY_BROKER_OUTCOME_UNKNOWN`)。依赖**已经装好**,
|
||
下面第 1 步只在坏了时重跑。
|
||
|
||
```bash
|
||
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 nohup pnpm dev:main > /tmp/vite-main.log 2>&1 & # vite, 3000, /dev → 30000
|
||
```
|
||
|
||
- 成功标志:`node_modules/.modules.yaml` 存在(✅ 已存在)、vite 打印 `ready in ~7s`
|
||
- 打开 `http://localhost:3000/`(根路径 App-Code 为空 ⇒ 后端回退主系统,已支持)
|
||
- 登录:`admin` / `123456`(登录框自己加密,不要手填密文)
|
||
|
||
⚠️ **后台进程会随 turn 结束被回收**(`run_in_background` 起的东西在回复完就没了)。
|
||
🔴 **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)
|
||
|
||
```bash
|
||
cd ~/Desktop/workspace/ssw-platform
|
||
git status -sb # main...origin/main,工作区应干净
|
||
# 推送(凭据只在 xop 注入的环境里存在,脚本不落盘)
|
||
xop run --secret GU=git_local_user --secret GP=git_local_pass -- bash -c '
|
||
export GIT_ASKPASS=/tmp/askpass-ssw.sh GIT_TERMINAL_PROMPT=0
|
||
git -c http.proxy= -c https.proxy= push origin main' < /dev/null
|
||
```
|
||
|
||
- 远端:`http://127.0.0.1:13300/ssw/ssw-platform.git`(Gitea 1.26.1,私有,默认分支 main)
|
||
- `ssw` 是**用户命名空间**不是组织(`/api/v1/orgs/ssw` 返 404),建仓用 `POST /api/v1/user/repos`
|
||
- `/tmp/askpass-ssw.sh` 若不存在,重建:`case "$1" in *[Uu]sername*) echo "$GU";; *) echo "$GP";; esac`
|
||
- 🔴 xop 会把输出里等于密钥值的串打码(`ssw` → `ss****【xop禁止将密钥泄漏】`),日志别扭但无害
|
||
- 每批做完建议 `git add -A && git commit`(一晚上至少留一个可回滚点)
|
||
|
||
---
|
||
|
||
## 3. 待办(按优先级,做完一条划一条)
|
||
|
||
### ~~P0 —— 用户管理页剩余接口~~ ✅ **2026-10-31 全部做完**
|
||
|
||
| 端点 | 状态 |
|
||
|---|---|
|
||
| `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` |
|
||
|
||
**另外顺手补了 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. `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 时就用这招**
|
||
|
||
### ~~P2 —— 机构管理 `Organize` CRUD + `Selector`~~ ✅ **2026-10-31 做完**
|
||
|
||
`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 —— 菜单管理 / 角色授权~~ ✅ **2026-10-31 05:00 做完**
|
||
|
||
| 批次 | 端点 | 备注 |
|
||
|---|---|---|
|
||
| 岗位 `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)~~
|
||
✅ **批次 1 做完(实际 23 条)**——新表 `base_user_extra` / `base_sign_img`
|
||
2. ~~`permission/Standing`(6) / `PermissionGroup`(6) / `Action`(3)~~
|
||
✅ **批次 2 做完(实际 21 条)**——新表 `base_standing` / `base_permission_group` / `base_action`
|
||
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 会红。
|
||
|
||
---
|
||
|
||
## 4. 每批实现的固定动作(缺一不可)
|
||
|
||
```bash
|
||
cd ~/Desktop/workspace/ssw-platform
|
||
# 1) 实现 → 编译
|
||
RUSTC_WRAPPER=sccache cargo build --manifest-path src/backend/Cargo.toml
|
||
# 2) 重启后端(老进程先 kill)
|
||
PORT=30000 ./target/debug/ssw-platform &
|
||
# 3) 运行时验证(比静态比对权威)
|
||
python3 scripts/probe-page.py docs/fe/page-user.tsv
|
||
# 4) 单测 + 六闸
|
||
RUSTC_WRAPPER=sccache cargo test --manifest-path src/backend/Cargo.toml
|
||
# 🔴 **尺子跑的是 release 产物** ⇒ 跑尺子前必须先 build --release
|
||
RUSTC_WRAPPER=sccache cargo build --release --manifest-path src/backend/Cargo.toml
|
||
for s in check-module check-boundary check-contract check-citations; do bash scripts/$s.sh; done
|
||
bash scripts/perm-smoke.sh
|
||
ENC_BIN="$PWD/target/debug/ssw-platform" bash scripts/perm-smoke-jnpf.sh
|
||
```
|
||
|
||
新增/变更端点必须同步三处,否则闸门必红:
|
||
|
||
1. `docs/contract.md` 的 `[ENDPOINT]`(面 B 行首列写 `B`)与 `[OFFICIAL]`(`absent → implemented`)
|
||
2. `docs/contract.md` 的 `[FACE]` 计数 + `[RULER]` 里 `perm-smoke-jnpf.sh` 的断言数
|
||
3. `src/backend/src/routes.rs` 测试里的 `JNPF_REGISTERED`(按**路径**列,同路径多方法算一条)
|
||
|
||
---
|
||
|
||
## 5. 必踩的坑(都已踩过一次,别再踩)
|
||
|
||
- 🔴 **一条 `.route()` 只挂一个方法**:`check-contract-scan.py` 只解析每个 `.route()` 的第一个方法,
|
||
`get(a).post(b)` 会被判成「契约写 POST、代码是 GET」。同路径多次 `.route()` 在 axum 里是合并,不冲突。
|
||
- 🔴 **驼峰 ≠ 下划线机械转换**:`ranks` ↔ `f_rank`、`certificatesType` ↔ `f_certificates_type`。
|
||
列名只来自白名单常量(如 `USER_WRITE_FIELDS`),别用 `snake_case()` 猜。
|
||
- 🔴 `f_creator_time` 写 SQL `now()` 时**不占参数位**:`marks.push("now()")` 而非 `placeholder()`,
|
||
否则 `$n` 序号和 `columns` 错位(报 `column is of type timestamp but expression is of type text`)。
|
||
- 🔴 写路径只 `SET` **body 里出现过的键**,未出现的列必须保持原值(有断言钉住)。
|
||
- 🔴 读回**不选** `f_password` / `f_secretkey`(有断言钉住「详情无 password 键」)。
|
||
- 🔴 `{id}` 会吞掉 `Users/` 下未注册的静态 GET 子路径;matchit 静态段优先,所以那些路由
|
||
**一旦注册就自动优先匹配**,不需要改详情。
|
||
- 🔴 测试共用 `platform/test_support.rs` 的**单例 pglite**(进程内只能开一个实例),
|
||
别在测试里 `open_temp`。
|
||
- 🔴 `python` 脚本里递归取同目录 `.vue` 时用 `if seen is None:`,**不能写 `seen = seen or set()`**
|
||
(空 set 是 falsy ⇒ 每层新建 ⇒ 环形 import OOM 被 SIGKILL)。
|
||
- 🔴 jq 里 `$d|has(a) or $d|has(b)` 会被 `|` 抢结合 ⇒ 用 `[keys[]|select(.=="a" or .=="b")]|length`。
|
||
- 🔴 端口:前端 dev 3000,代理 `/dev` → **30000**,后端绝不能起在 3000。
|
||
- 🔴 **npm/pnpm 类命令一律 `env -u NODE_OPTIONS`**(见 §0);cargo 不受影响,不用加。
|
||
- 🔴 **后台进程随 turn 结束被回收**:起服务与验证必须同一 turn 内完成。
|
||
- 🔴 git 推送别把密码塞 remote URL:用 `GIT_ASKPASS` + `xop run --secret`,并加 `-c http.proxy=`。
|
||
- 🔴 `.gitignore` 已挡 `target/`(1.7G) 与 `src/backend/data/`(38M);`git add -A` 前先
|
||
`git diff --cached --name-only | wc -l` 确认没暴涨。
|
||
|
||
### 批次 2 新增的坑
|
||
|
||
- 🔴 **PG 数组参数一律不能写 `$N::text[]`**:pglite-rs 0.2.7 会把它当成 PG 数组类型 `_text`,
|
||
而本仓参数**一律按 text 绑定**(`Option<String>`)⇒ 协议错
|
||
`cannot convert between the Rust type String and the Postgres type _text`。
|
||
⇒ 改成 `= ANY(string_to_array($N::text, ','))`(**函数在 SQL 里做**)。
|
||
- 🔴 **PG 会拒「SQL 里有 $N 但没用它」**:`42P18: could not determine data type of parameter $1`。
|
||
⇒ 凡是留了 `$N` 的软删 SQL,都要把对应列写进 SET(`f_delete_user_id = $N::text`)。
|
||
- 🔴 **占位符顺序必须与参数追加顺序逐字对齐**(不是「大致对上」)⇒ 写完对着读一遍。
|
||
- 🔴 **`base_action.f_enabled_mark` 是 VARCHAR(11)**(官方 DDL 陷阱)⇒ 别按整数 CAST。
|
||
- 🔴 **`base_standing.f_is_system` 是 1=系统 / 2=自定义** ⇒ 新建写 **2**,不是 1。
|
||
- 🔴 **官方 `list` 端点常有「id 串换人名串」的后处理**(`getFullNameByIds`)⇒ 抄控制器别只抄模型。
|
||
- 🔴 **Bash 里写多层嵌套引号的 curl + python 验证脚本很容易引号不闭合**(`bash -n` 报
|
||
`unexpected EOF` 但**定位不到行**)⇒ **直接用 Python 写验证器**(`urllib` + `ProxyHandler({})`
|
||
绕过本机代理),别跟 bash 引号较劲。
|
||
- 🔴 **尺子用的是 `target/release/ssw-platform`**,不是 debug 产物 ⇒ 改完代码跑尺子前
|
||
**必须 `cargo build --release`**,否则尺子跑的是旧二进制(表现为「刚修好的端点还是 405」)。
|
||
|
||
---
|
||
|
||
## 6. 收工前(每一轮都要做)
|
||
|
||
1. 追加 `.workbuddy/memory/YYYY-MM-DD.md`:结论 / 坑 / 数字(闸门通过数)
|
||
2. 更新本文件 §1 现状、§2 现场、§3 待办(划掉做完的)
|
||
3. 若还有未完成项,**确认下一次定时任务存在**(`automation_update` list 可查),没有就新建
|