docs: align Bun, routing, browser validation and MoviePilot site provenance

docs/runbook/dev.md

@@ -2,7 +2,7 @@
 
 ## 前置
 
-- Bun 1.4.3(锁定)、Docker；Linux 解析沙箱构建需要 C 编译器和 Node-API 头文件(Debian: `build-essential libnode-dev`)。不需要单独安装 Node.js / pnpm。
+- Bun 1.4.4(锁定)、Docker；Linux 解析沙箱构建需要 C 编译器和 Node-API 头文件(Debian: `build-essential libnode-dev`)。不需要单独安装 Node.js / pnpm。
 - 端口:web 5180、API 4390、PG 55433。4380 留给本机部署版(Caddy),本机 3000/5175/5176/55432 已被其他项目占用,不要改用。
 
 ## 首次启动
@@ -16,6 +16,10 @@ bun run dev                 # 同时起 server(4390)与 web(5180)
 
 单独起:`bun run dev:server`(`bun --watch`,默认 `--role all`,API + worker 同进程)、`bun run dev:web`。
 
+前端使用 Vite 8 + TanStack Router,路由表在 `apps/web/app/router.tsx`,构建入口为 `apps/web/index.html` 与 `app/entry.client.tsx`。`VITE_API_TARGET` 可覆盖开发代理目标,默认 `http://localhost:4390`;生产产物仍输出到 `apps/web/build/client`,由后端按 SPA 路由回退到 `index.html`。
+
+server 测试按 `unit`、`pg`、`serial` 分组运行。`unit` 文件并行,其余两组各自文件串行;OpenWorkflow 0.11 的并发索引迁移会等待其它 schema 的长事务快照,因此不同 schema 的数据库测试也不能并行跑。测试连接开发库,不使用部署库。
+
 ## 验证
 
 ```sh
@@ -105,6 +109,8 @@ curl -H "Authorization: Bearer umt-dev-admin-key" "localhost:4390/api/v1/events?
 
 身份重识别的幂等判断同时覆盖季集、日期、发布组和识别词命中；作品候选相同不代表解析事实相同，不能跳过事实变更后的季集重算。
 
+整理身份事项按决策 ID 使用稳定恢复幂等键,在原记录的重新规划锁内复用有效后继。人工与智能体同时确认同一作品只入队一次;并发选择不同作品时返回冲突,不能让同一来源生成两份执行计划。
+
 季集计算和识别词归 sources-identity，整理请求、文件操作与入库状态归 acquisition-organize。整理把真实失败文件和同批正常文件样本交给映射事项，模拟与写入共用同一判断；映射重算后以 `media.episode_mapping_changed` 通知整理模块，只有季集已经确定的未完成记录重新规划。恢复预检与规划复用 `planFileEpisodes`，保留原资源的发布时间等解析上下文。Agent 的调查运行、预算和授权沿用现有机制，不另外创建恢复框架；身份补齐、重新排队和实际入库完成分别按业务事实核实。
 
 维护时先验证真实的成功、失败和恢复路径,尤其是授权、文件替换、取消与外部副作用；删除空壳或无使用者的机制时同步删除其专属测试与文档。不要为了目录对称增加转发层,也不要把不同阶段的状态合并成一个枚举。
@@ -203,7 +209,7 @@ docker compose up -d --build        # 服务:app(4380)+ postgres(数据卷 umt-p
 curl localhost:4380/api/v1/health
 ```
 
-- 镜像:`oven/bun:1.4.3` 构建 web 与 `bun build --compile` 出二进制,并构建 `sandbox-policy.node`,运行时 `debian:trixie-slim` + gosu + postgresql-client + 静态 ffprobe,root 启动修 `/data` 属主后降权到 PUID(缺省 10001)。
+- 镜像:`oven/bun:1.4.4` 构建 web 与 `bun build --compile` 出二进制,并构建 `sandbox-policy.node`,运行时 `debian:trixie-slim` + gosu + postgresql-client + 静态 ffprobe,root 启动修 `/data` 属主后降权到 PUID(缺省 10001)。
 - 入口 `docker/entrypoint.sh`:迁移 → 自检 → 同时起 api、worker、worker:agent 三个进程;任一退出则停掉其余并以非 0 退出,由 `restart: unless-stopped` 拉起。
 - 主进程使用非 root 用户和只读的 `/app` 产物；外部字节解析另起子进程,由原生 seccomp 策略限制文件、网络与进程访问。镜像带静态 ffprobe；运行期写入落在 `DATA_DIR`(容器内 `/data`)。完整部署说明见 [deploy.md](deploy.md)。
 - 构建版本号:`APP_VERSION=v0.1.0 docker compose build`(写入 web 的 `version.json`)。