Appearance
Acc 库存增强（P0 引导 · P1 调整单 · P2 退货/次品/包装）
与 acc-inbound-unit-guide.md、acc-accounting-features.md 配套。
P0 — 录入引导（已落地）
| 项 | 位置 |
|---|---|
| 商品单位/规格 placeholder | Web GoodsSaveDialog |
| 入库说明 + 包装件数换算列 | InboundPostDialog |
| 规格解析工具 | shared/utils/acc-pack-spec.ts |
P1 — 库存调整单（已落地）
| 项 | 说明 |
|---|---|
| API | POST /acc/stock-ledger/adjust/post |
| 权限 | btn_acc_stock_adjust_write |
| 流水 | stock_adjust |
| Web | 库存流水列表 → 库存调整 |
| 小程序 | stock-ledger 顶栏 库存调整 → stock-adjust |
P2 — 入库合格/次品分行（已落地）
| 项 | 说明 |
|---|---|
| 明细 | qty 合格入主单位库存；scrapQty 次品不入库 |
| 流水 | 合格 inbound_in；次品 inbound_scrap（qtyDelta=0） |
| 金额 | 行金额 = (合格+次品)×单价 |
| Web/小程序 | 入库过账分列「合格」「次品」 |
发版前 zen:push（acc_inbound_lines.scrap_qty）。
P2 — 包装规则结构化（已落地）
| 项 | 说明 |
|---|---|
| 字段 | acc_goods.pack_rules_json：[{ "label": "袋", "qtyPerPack": 1000 }] |
| 商品维护 | Web 原料 → 包装规则（优先于规格文本解析） |
| 入库换算 | primaryQtyPerPack(spec, packRulesJson)，包装件数×首条规则 |
| 小程序 | inbound-line-form 包装件数 + 换算提示 |
| 兼容 | 仍保留 spec 展示与文本回退 |
发版前 zen:push（pack_rules_json）。
P2 — 销售部分退货（已落地）
| 项 | 说明 |
|---|---|
| API | POST /acc/outbound/return/post |
| 权限 | btn_acc_outbound_write（不需 PROD_WIP_LEAD） |
| 流水 | outbound_return / outbound_return_scrap |
| 整单作废 | POST /acc/outbound/void → outbound_void |
| Web | 出库详情 / 列表 → 部分退货 |
| 小程序 | outbound-detail → 部分退货 → outbound-return |
| 表 | acc_outbound_returns / acc_outbound_return_lines |
出库退货对照
| 场景 | 操作 | 流水 |
|---|---|---|
| 整单退回 | 出库单 冲红 | outbound_void |
| 部分退、良品回库 | 部分退货 | outbound_return |
| 部分退、次品报废 | 部分退货（次品列） | outbound_return_scrap |
发版前数据库与权限
bash
pnpm run zen:generate
pnpm run zen:push
pnpm --filter taskflow-backend run db:sync-roles-perms含：退货表、acc_inbound_lines.scrap_qty、acc_goods.pack_rules_json（若环境尚未推送）。重启服务后相关用户 重新登录。
预发手工验收（至少各 1 条）：acc-stock-staging-checklist.md · 签字摘要见 release-signoff-bundle.md §F。
更新日期：2026-05-28