Appearance
P2 库存增强 — 预发手工验收（入库次品 · 部分退货）
与 acc-stock-enhancement.md、release-signoff-bundle.md 配套。
前置（运维）：
bash
pnpm run zen:generate && pnpm run zen:push # 指向预发库
pnpm --filter taskflow-backend run db:sync-roles-perms
# 重启 gateway / sys / acc；验收账号重新登录| 项 | 说明 |
|---|---|
| 账号 | 记录员过账角色（MINI_RECORDER_POST 或 PC ACC_PC_OPERATOR / 入库·出库专员） |
| 站点 | 预发测试站点 siteId |
| 数据 | 至少 1 个原料（含可选 pack_rules_json）、1 张已过账出库且仍有可退数量的销售单 |
S1 — 入库合格 + 次品（必测 1 条）
| # | 步骤 | 预期 |
|---|---|---|
| S1.1 | Web 或小程序：新建原料入库，明细填合格 8、次品 2、单价一致，保存过账 | 成功；行金额 = (8+2)×单价 |
| S1.2 | 库存流水 筛该原料 | 有 inbound_in，数量 +8 |
| S1.3 | 同页再看次品 | 有 inbound_scrap，qtyDelta=0，备注含次品数量 |
| S1.4 | 商品现存量 | 仅 +8（次品不入库） |
| S1.5 | （可选）同原料填 2 条包装规则，小程序选非首条规则 + 包装件数 | 合格数量按所选规则换算 |
脚本：backend/scripts/smoke-inbound-post.mjs（示例：IN-20260529-f5da32 合格 8 + 次品 2）· CI：e2e/acc-stock-p2-smoke.spec.ts（pnpm run test:e2e:stock-p2）
| 通过 | 验收人 | 日期 |
|---|---|---|
| □ |
S2 — 销售部分退货（必测 1 条）
| # | 步骤 | 预期 |
|---|---|---|
| S2.1 | 选一张 orderStatus=normal 的已过账出库单，记下某行已发数量 | 详情显示可退数量 |
| S2.2 | 部分退货：良品退 3、次品退 0（或 Web 弹窗等价操作） | 成功 |
| S2.3 | 库存流水 | outbound_return，qtyDelta=+3 |
| S2.4 | 再次打开同单详情 | 已退/可退数量更新；仍可继续退剩余 |
| S2.5 | （可选）仅退次品 1 | outbound_return_scrap，库存不变 |
脚本：backend/scripts/smoke-outbound-return.mjs（SMOKE_RETURN_GOOD=3 默认；次品 SMOKE_RETURN_GOOD=0 SMOKE_RETURN_SCRAP=1）· CI：e2e/acc-stock-p2-smoke.spec.ts
| 通过 | 验收人 | 日期 |
|---|---|---|
| □ |
S3 — 库存调整（发版含 P1 时顺带）
| # | 步骤 | 预期 |
|---|---|---|
| S3.1 | 库存流水 → 库存调整，盘盈 +1 | stock_adjust；现存量 +1 |
| S3.2 | 只读账号（ACC_PC_LITE）调 API 或 UI | 无调整入口 / API 403 |
脚本：backend/scripts/smoke-stock-adjust.mjs · CI：acc-stock-p2-smoke.spec.ts（S3）+ acc-stock-p2-api.spec.ts（只读 403）
| 通过 | 验收人 | 日期 |
|---|---|---|
| □ |
存档：勾选后附在 release-signoff-bundle.md F. P2 库存 或发布工单。
附录 — API 冒烟记录（预发 RDS + 本机网关 127.0.0.1:3000）
供 §F 对照；UI 手工验收仍须勾选上表。账号 tftest；站点 7260e046-d587-4aa7-ba2c-77a6c7714f8e。
| 项 | 单号 / 证据 | 命令 |
|---|---|---|
| S1 | IN-20260529-f5da32，原料 6e876639-… 高帮-后轮，库存 +8 | pnpm run smoke:acc-inbound |
| S2 良品 | RT-20260529-103d09 ← SO-20260513-e5f116，+3 | pnpm run smoke:acc-outbound-return |
| S2 次品 | RT-20260529-7e27e9，qtyDelta=0 | SMOKE_RETURN_GOOD=0 SMOKE_RETURN_SCRAP=1 + 上脚本 |
| S3 | stock_adjust +1，商品高帮-盖布 | pnpm run smoke:acc-stock-adjust |
| CI | acc-stock-p2-smoke + acc-stock-p2-api | pnpm run test:e2e:stock-p2（须 E2E_* Secrets） |
一键本地：pnpm run smoke:acc-stock-p2（须 dev:backend + backend/.env）。
GitHub Actions 须配置 Secrets，见 env-pack-strict-and-e2e.md §2；本地对照：pnpm run check:p2-e2e-secrets.