记账域功能说明（最新）

本文汇总 财务/记账（Acc） 侧近期能力，涵盖 对客加工单价（档案）、商品档案、成品出库 及 通用 UI，便于产品、实施与开发对齐。若与代码不一致，以仓库实现为准。

更新日期：2026-04-24

---

1. 对客加工单价与品牌方侧业务（与工人工资独立）

业务含义：成品档案中的 对客加工单价 仍用于成本/报价参考；与品牌方/客户的 对账与凭证 请通过 成品出库 等流程在线下或出库单维度管理。工人记工工资 仍走工资结算，两者独立。

1.1 成品档案

• 路径：记账 → 商品档案 → 商品 页签，新建/编辑成品。
• 字段 对客加工单价（元/件，三位小数，带步进）：仅成品需维护时填写。
• 商品 列表展示：
  • 工序数量：该成品在档案中已维护的 生产工序 行数（后端聚合 AccGoodsProcessStep）。
  • 对客加工单价：展示为「元/件」格式（与财务金额展示一致）。

1.2 生产单详情

• 不再提供「上传结算证明 + 确认办结对客加工费」入口；历史库表字段（办结状态、证明 JSON、参考快照等）仍保留在 AccProduction 上，仅供遗留数据只读；新流程请使用 成品出库。

1.3 数据与接口（摘要）

项目	说明
商品	AccGoods.processingUnitPrice（成品）
生产主表	仍含 clientProcessSettleStatus 等字段（历史）；已移除 POST …/production/client-settle 办结接口
详情接口	POST /api/acc/production/detail：返回生产主表及明细；不再组装对客参考额/证明等扩展字段

数据库：模型变更后需执行 pnpm run zen:generate 与 pnpm run zen:push（或等价迁移）。

---

2. 成品出库

2.1 新建出库单

• 每行：选 成品 → 生产批次（仅该成品下仍有可出量的产出行）→ 库存量（只读，即该批 剩余可出库）→ 数量、销售单价。
• 选完批次后：数量默认 = 该批可出库存；数量 受 max = 可出量 约束，不可超库存。
• 过账后：扣 成品总库存、增 批次的已出库量、记 库存流水（outbound_sale）。

2.2 列表与冲红

• 列 状态：正常 / 已冲红（orderStatus）。
• 详情：OutboundDetailDialog，展示单头、客户、金额、明细（成品、关联 生产单号、数量、销售单价、销售额、成本行金额）；已冲红有提示与 冲红时间（若有）。
• 冲红（有权限时可见，与生产冲红策略一致：系统管理员 或 生产负责人 PROD_WIP_LEAD）：
  • 回退 批次的已出库量、回冲 成品库存、记流水（outbound_void，数量为正）。
  • 主表标记为已冲红，不物理删单。

2.3 接口（摘要）

接口	作用
POST /api/acc/outbound/page	分页列表
POST /api/acc/outbound/detail	详情（含行、生产单号等）
POST /api/acc/outbound/post	新建过账
POST /api/acc/outbound/void	冲红 { siteId, id }
POST /api/acc/production/available-batches	某成品下可选生产批次（含可出量）

主表含 orderStatus（normal / voided）、voidedTime、voidedById；库表需与 schema 同步。

---

3. 通用：列表与筛选

记账域列表页多使用统一分页与查询组件（如 PageQueryTable）；筛选项、导出等以各视图实现为准。前端路由与菜单文案见 frontend/src/locales/menu.*.ts 与路由注册表。