功能文档目录

根目录 README.md 是需求 V1.2 原文，不改。实现以本目录文档为准；冲突时以 00-业务规则.md + 14-库存确认契约.md 为准。

阶段

阶段 范围
P0 主数据 + 采销确认归档/财务驳回冲销 + 加工仓库 + 费用申请 + 挂单经营费用 + 开票资料 + 采购/销售发票
P1 夜间分析、账期对账导出、消息推送、回款强闭环
P2 AI 采单/语音、H5 对话问数、企微部门回写

实现顺序

00 → 14 → 01 / 02 / 03 → 04 → 05 / 06 / 07 → 08 → 09 / 10 → 11 → 12；13 为附录；15 / 16 / 17 为工作流、链路总览与业务场景。

  • 开发进销存前必读 14（含财务驳回冲销）。
  • 06 与 07 可并行。

文档一览

文档 阶段 做什么
00-业务规则.md P0 跨模块约定；归档驳回；费用/发票
16-业务链路总览.md 总览 从产品到采销的白话链路与流程图
17-业务场景.md 总览 由现行文档归纳的可能使用场景（P0–P2）
14-库存确认契约.md P0 确认与财务驳回→流水
15-审批工作流.md P0 人审人画布；费用申请等 subject；与 14 分工
01-部门与员工.md P0 部门（企微同步只读）、员工、产品成员、权限
02-省市区.md P0 省市区主数据；CSV 导入
03-产品.md P0 产品/等级字典；重量按斤
04-仓库.md P0 结存流水；仓内加工单；调拨盘点；期初/报损
05-采购.md P0 采购归档；采销关联；财务看板
06-订单.md P0 销售归档；采购批次；财务驳回
07-生产加工.md P0 仓内加工业务口径（表见 04）
08-财务.md P0 费用申请；挂单经营费用；公司主数据；开票资料；发票
09-消息.md P1 出站消息
10-数据分析.md P1 盈亏含挂单费用与费用申请；预警；对账导出
11-AI应用.md P2 采单 OCR、语音、对话
12-技术架构.md 全程 选型与分层
13-线下单据映射.md 附录 线下对照

边界速查

  • 确认即归档（采购）/ 出库即扣库存（销售）；改已入账单须财务驳回（先冲销库存回草稿）。销售审批驳回（未出库）直接回草稿。
  • 库存只经 14；结存键含必填 purchase_id 与行属性 spec_name/grade/pack（见 04）。采销独立单据，确认/驳回共用写流水服务。
  • 采销对应：一张销售单一个产品，明细可多仓、多采购批、多等级。出库仓与采购批次在 order_items；头表不设 warehouse_id / purchase_id。
  • 人审人（采购单、销售单、费用申请等）走 15-审批工作流.md；库存冲销仍见 14。销售单关键节点：开票（invoice）、收款（collect）。
  • 费用申请表 expenses（节点付款）；挂单经营费用 document_expenses MorphMany 挂采/销；开票资料多态挂客户/供应商；地址多态挂客户（多条）/供应商（一条）；发票分采购票/销售票。
  • 成本（P0）：单据金额 + 挂单经营费用 + 费用申请为实收盈亏；stocks 可存加工费/包装费/隐形分摊费件数单价作毛利预估参考，非存货成本层。
  • 线下 #6「对外销售对账单」= 简易销售；账期对账另做。

功能文档骨架

职责与边界 → 表字段 → 状态机 → 确认/驳回副作用（指 14）→ 维护/验收 → 本期/延后。