方案：账务报表与钱包
方案 · 代理销售账务核算 / 报表 / 钱包（完整）
日期：2026-07-30
原则：金额一律用「分」入库；界面用「元」；一切可追溯；算错即资金损失，禁止静默 0。
一、数量与价格逻辑总表（已落地政策）
1. 门店现款出货 A/B/C（单次箱数取最高满足档）
| 档 | 默认起订 | 默认出货 | 利润（相对整箱零售） |
|---|---|---|---|
| A | ≥1 | 77 元/箱 | 单箱约 19 / 单瓶约 0.8 |
| B | ≥5 | 67 | 单箱约 29 / 单瓶约 1.2 |
| C | ≥10 | 60 | 单箱约 36 / 单瓶约 1.5 |
- 新店首单：可选强制 B 档，或直接填「首次拿货价」（填了优先）。
- 利润 =（零售价×箱规 − 出货价），不手填。
2. 下级代理拿货 A/B/C
| 档 | 默认 | 说明 |
|---|---|---|
| A | 可关 | 箱数/价默认 0 |
| B | ≥10 箱 / 60 元 | |
| C | ≥30 箱 / 54 元 |
未命中回退「级别进货价」。镇代基础拿货默认 60（≠门店 A）。
3. 拓店奖（首次成交 · 单店）
| 类型 | 模式 | 默认 |
|---|---|---|
| 自己配车 | 不限/可月结 | 20 元/家 |
| 自己配车 | 铺货≥3 箱现金 | 30 元/家 |
| 公司配车 | 上两档各减 | 5 元/家 |
结算：次月 1–5 回款，6 号起可发上月。
4. 业务经理
| 项 | 默认 | 说明 |
|---|---|---|
| 下属拓店抽成 | 0 | 可设，如 10 元/店 |
| 本人拓店奖 | 开 | 与业务员同政策 |
| 月销量 A/B/C | 0 | 示例 500→1 / 1000→1.5 / 2000→2 元/箱 |
| 下级保证金 | 0 | 可后配 |
统计范围：经理本人店 + 直接下属店，当月已付已签收箱数。
5. 级别关系（市 / 县平级）
| 级别 | 直接下级 |
|---|---|
| 省代 | 市代、县代（平级） |
| 市代 | 仅镇代（不再挂县） |
| 县代 | 仅镇代 |
| 镇代 | 无下级代理 |
每一级可看：本级员工 + 本级辖区下级代理/门店；互不越权看对方平级辖区。
二、单据金额字段（必须记全）
拓店单 as_store_lead
| 字段 | 含义 |
|---|---|
first_cases | 订货箱数 |
first_amount_fen | 订货金额（分） |
paid_fen | 已收款（分） |
debt_fen | 欠款（分）= max(0, 订货金额−已收) |
进货/调拨单 as_order
| 字段 | 含义 |
|---|---|
cases / price_fen / amount_fen | 箱数、单价、总额 |
cost_fen | 本级成本合计（分） |
profit_fen | 本级毛利合计（分） |
paid_fen | 已收（分） |
debt_fen | 欠款（分） |
pay_status | 0 未清 / 1 已清（debt=0 且付清） |
ship_status | 0 待发 / 1 配送 / 2 已签收 |
收货/出库时自动重算：单价→总额→成本→毛利→已收/欠款；禁止总额为 0 却出库。
三、报表口径
| 报表 | 口径 |
|---|---|
| 日报 | 自然日：订单数、发货箱、收款、欠款、毛利、拓店数、提成 |
| 月报 | 自然月（或自定义区间）同上 |
| 年报 | 自然年同上 |
| 人员 | 业务员/经理：发货箱、金额、毛利、拓店、提成 |
| 地区 | 下级代理树（省看市+县；市/县看镇） |
业务员不可看全区销量；经理看自己+直接下属；代理老板看本代理树。
四、钱包
| 主体 | 账户 |
|---|---|
| 代理 | as_agent.wallet_fen + 流水 as_wallet_log |
| 员工（业务员/经理） | as_staff.wallet_fen（发放同步会员余额）+ 流水 |
流水类型：拓店奖、经理抽成、经理销量、返利、调账、提现预留。
只增流水、可对账；禁止无单改余额。
五、操作闭环（帮助对应）
- 政策设定（A/B/C、拓店奖、经理档）
- 拓店采集（订货箱、金额、收款、欠款）→ 三级审核 → 建店+首单
- 现款确认 / 登记收款 → 出库签收 → 自动毛利+拓店奖账本
- 次月结算发放 → 钱包
- 日/月/年报核对
详见：docs/教程-代理销售账务报表与钱包.md、docs/帮助中心-代理销售操作说明.md。
六、实施清单
- [x] 政策数量逻辑（门店/代理 ABC、拓店奖、经理月销量 ABC、保证金默认 0）
- [x] 市县平级：省可建市或县；市不再挂县
- [x] 拓店 paid/debt 字段与列表详情
- [x] 订单 cost/profit/paid/debt 出库自动算
- [x] 报表扩展毛利/收款/欠款
- [x] 钱包页与流水
- [x] 帮助/教程挂 manifest 并 build
