# HANDOFF —— 交给下一个 session 的现场交接 > 更新于 2026-10-30 22:15。**开工先读这一页**,再读 `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 装完。 --- ## 1. 一句话现状 Rust 后端(axum + pglite)已能跑,**面 A**(ssw/react 形状)与**面 B**(官方 JNPF 形状, `Vue-Version: 3`)双契约并存;面 B 的 `Users` 一族 9 条已实现。 **前端依赖已装完**(2169 包 + postinstall stub 全 Done),`pnpm dev:main` 实测 vite 7.3.1 6.8 秒就绪、3000 端口在听、`/` 返 200 —— **但页面从未在浏览器里渲染过一次**, 这是当前唯一的大未知,也是第一优先级。 --- ## 2. 运行中的现场(断了就按这里重启) ### 后端(端口 30000) ```bash cd ~/Desktop/workspace/ssw-platform RUSTC_WRAPPER=sccache cargo build --manifest-path src/backend/Cargo.toml # 改代码后 PORT=30000 ./target/debug/ssw-platform & # 后台起 curl -s http://127.0.0.1:30000/api/health # 期望 {"ok":true,"tables":12,...} ``` 拿 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 pnpm dev:main # vite, 3000, /dev → 30000 ``` - 成功标志:`node_modules/.modules.yaml` 存在(✅ 已存在)、vite 打印 `ready in ~7s` - 打开 `http://localhost:3000/`(根路径 App-Code 为空 ⇒ 后端回退主系统,已支持) - 登录:`admin` / `123456`(登录框自己加密,不要手填密文) ⚠️ **后台进程会随 turn 结束被回收**(`run_in_background` 起的东西在回复完就没了)。 所以「起后端 / 起 vite → 验证页面」必须**在同一个 turn 里连续做完**;不要指望上一轮留下的进程。 ### 代码仓库(本机 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 —— 用户管理页剩余接口(`scripts/probe-page.py` 实测的 8 条缺路由) | 端点 | 备注 | |---|---| | `GET /api/permission/Group` | 左侧用户分组树;**需要新表 `base_user_group`** | | `GET|POST|PUT|DELETE /api/permission/Group/{id}` | 分组 CRUD | | `POST /api/permission/Group/{id}/Actions/AddUser` / `DeleteUser` | 分组加/移成员 | | `POST /api/permission/Users/{id}/SetPosition` + `POST /api/permission/Users/SetPositionBatch` | 设岗位(后者当前 405 ⇒ 同路径要补 POST) | | `GET /api/permission/Users/{id}/SelectorByUserPosId` | 按岗位选人 | | `GET /api/system/System/getDevUser` | 开发账号下拉 | | `DELETE /api/permission/socials/{id}` | 第三方账号解绑 | | `POST /api/permission/Users/workHandover` | 离职交接(写接口,探针默认跳过) | ### P1 —— 让页面真跑起来(比补接口更重要,先验证再补) 依赖已装好,直接从这里开始: 1. 同一 turn 内:起后端 → `env -u NODE_OPTIONS pnpm dev:main` → 等 `ready` → 再操作浏览器 2. 浏览器:`aix` 需要 xstudio 内核(`curl --noproxy '*' -sf http://127.0.0.1:19999/health`); **内核没跑时先起**:`bash /Users/xs/Documents/x/xstudio/source/scripts/xstudio-up.sh`; 还不行就退回 `--chrome` 后端(注意换 `--session`)。`aix snapshot` 拿 `@eN` 再点,别猜 selector 3. 登录后进「用户管理」,把控制台/网络里的 4xx、5xx 按顺序修:先修 500/404 的路由, 再修字段形状(前端拿不到字段会报 undefined,不会报 4xx) 4. 做成可复现步骤写回本文件(哪个 URL、登录后点哪里、期望看到什么) ### P2 —— 机构管理 `Organize` CRUD + `Selector` 几乎所有权限页面的公共前置。参照 `platform/sys.rs` 里面 A 的 `org_*` 实现。 ### P3 —— 菜单管理 / 角色授权(时间够再做) --- ## 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 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` 确认没暴涨。 --- ## 6. 收工前(每一轮都要做) 1. 追加 `.workbuddy/memory/YYYY-MM-DD.md`:结论 / 坑 / 数字(闸门通过数) 2. 更新本文件 §1 现状、§2 现场、§3 待办(划掉做完的) 3. 若还有未完成项,**确认下一次定时任务存在**(`automation_update` list 可查),没有就新建