主题
管理后台 — 财务管理
上级文档：管理后台 Web
模块概述
财务管理模块为财务角色提供门店分润配置、成本管理、期间报表导出能力。财务侧数据基于核心系统的原始订单流水计算，不替代专业账套，导出文件格式需对齐目标财务系统的导入模板。
页面路由
| 路由 | 页面 | 说明 |
|---|---|---|
/finance/profit-sharing | 分润配置 | 门店分润规则设置 |
/finance/settlement-accounts | 结算账户 | 门店/总部/飞创账户余额与流水 |
/finance/virtual-debt | 虚拟欠款对账 | 抖音/美团等非连连渠道欠款登记与核对 |
/finance/costs | 成本配置 | 门店固定成本与分摊规则 |
/finance/reports | 财务报表 | 期间报表生成与导出 |
结算账户与虚拟欠款
账户视图
| 账户类型 | 说明 | 主要来源 |
|---|---|---|
| 门店账户 | 门店应收和退款回流 | 微信支付分账、核销订单结算、退款冲销 |
| 总部账户 | 品牌授权费账户（连连） | 微信支付结算、虚拟欠款登记、退款冲销 |
| 飞创账户 | 技术服务费账户（连连） | 微信支付结算、虚拟欠款登记、退款冲销 |
| 虚拟欠款账户 | 非连连渠道应收应付登记 | 抖音核销、美团核销及退款反向登记 |
核心能力
- 按订单查看三方账户流水与计算参数快照
- 区分实收流水与虚拟欠款流水
- 对抖音/美团渠道输出待清结算余额
- 支持按门店、渠道、期间导出对账单
平台账期配置
| 平台 | 账期配置示例 | 说明 |
|---|---|---|
| 连连（微信支付） | T+1 / 周结 | 按连连打款规则执行 |
| 抖音 | 周结 / 月结 | 以抖音账单与打款通知为准 |
| 美团 | 周结 / 月结 | 以美团账单与打款通知为准 |
每个订单只会归属一个平台，账期按订单所属平台计算，不做跨平台混算。
分润配置
业务背景
连锁健身房的收入需要在门店、总部、投资人等多方之间按规则分配。分润配置定义各门店的收入分成比例与参与主体。
分润规则数据模型
ProfitSharingRule {
id String # 规则 ID
storeId String # 适用门店 ID（null=默认规则）
name String # 规则名称
effectiveFrom DateTime # 生效日期
effectiveTo DateTime? # 失效日期（null=长期有效）
participants Array # 分润参与方
createdAt DateTime
updatedAt DateTime
}
ProfitSharingParticipant {
role String # 主体角色：store / hq / investor
name String # 主体名称
percentage Decimal # 分润比例（%），所有参与者之和 = 100%
accountInfo String? # 收款账户信息（仅展示用）
}分润规则列表
| 列名 | 字段 | 说明 |
|---|---|---|
| 规则名称 | name | 如「朝阳门店标准分润」 |
| 适用门店 | storeId | 默认规则 或门店名称 |
| 生效期间 | effectiveFrom ~ effectiveTo | — |
| 参与方 | participants | 门店 60% / 总部 30% / 投资人 10% |
| 状态 | — | 生效中 / 已过期 / 未生效 |
新建/编辑分润规则
┌─────────────────────────────────────────────────────────────────┐
│ ← 返回 编辑分润规则 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 规则名称 * [朝阳门店标准分润 ] │
│ 适用门店 * [朝阳门店 ▼] │
│ 生效日期 * [2026-01-01] 失效日期 [ ] (选填) │
│ │
│ ── 分润参与方 ────────────────────────────────────────────── │
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ 主体角色 名称 分润比例 操作 │ │
│ │ ────────── ────────────── ──────── ──── │ │
│ │ [门店 ▼] [朝阳门店 ] [60 ] % [删除] │ │
│ │ [总部 ▼] [健身总部 ] [30 ] % [删除] │ │
│ │ [投资人▼] [张三 ] [10 ] % [删除] │ │
│ │ │ │
│ │ 合计：100% ✅ │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ [+ 添加参与方] │
│ │
│ ⚠️ 修改分润规则不影响已生成的历史报表，仅对新期间生效。 │
│ │
│ [取消] [保存] │
└─────────────────────────────────────────────────────────────────┘表单校验
- 参与方比例之和必须 = 100%
- 同一规则内不能有重复的参与方
- 新规则的生效日期不能早于已有未过期规则的生效日期（避免重叠冲突）
成本配置
成本分类
| 成本类型 | 说明 | [建议值] 频率 |
|---|---|---|
| 固定成本 | 门店房租、物业费、水电费 | 按月录入 |
| 人力成本 | 店员工资、社保（如有） | 按月录入 |
| 设备折旧 | 健身器材、工控机等设备折旧 | 按月自动计算 |
| 维护费用 | 设备维修、保洁等 | 按实际录入 |
| 营销费用 | 广告投放成本 | 按月汇总 |
| 其他成本 | 不可归类到上述的支出 | 按实际录入 |
成本录入页面
┌─────────────────────────────────────────────────────────────────┐
│ 成本配置 门店：[朝阳门店 ▼] 月份：[2026-03 ▼] │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌─ 固定成本 ────────────────────────────────────────────────┐ │
│ │ 房租 [¥ 15,000 ] 元/月 │ │
│ │ 物业费 [¥ 2,000 ] 元/月 │ │
│ │ 水电费 [¥ 3,500 ] 元/月 │ │
│ └───────────────────────────────────────────────────────────┘ │
│ │
│ ┌─ 人力成本 ────────────────────────────────────────────────┐ │
│ │ 店员工资 [¥ 8,000 ] 元/月 │ │
│ │ 社保 [¥ 2,400 ] 元/月 │ │
│ └───────────────────────────────────────────────────────────┘ │
│ │
│ ┌─ 设备折旧 ────────────────────────────────────────────────┐ │
│ │ 器械折旧 [¥ 2,000 ] 元/月 (自动计算，可调整) │ │
│ │ 工控机折旧 [¥ 300 ] 元/月 │ │
│ └───────────────────────────────────────────────────────────┘ │
│ │
│ ┌─ 营销费用 ────────────────────────────────────────────────┐ │
│ │ 广告投放 [¥ 5,000 ] 元/月 │ │
│ └───────────────────────────────────────────────────────────┘ │
│ │
│ 本月总成本：¥ 39,400 │
│ │
│ [保存] │
└─────────────────────────────────────────────────────────────────┘成本自动计算规则
| 成本项 | 计算逻辑 |
|---|---|
| 其他成本 | 仅手动录入 |
财务报表
期间损益表
| 报表项 | 字段 | 说明 |
|---|---|---|
| 会计期间 | — | 如「2026 年 3 月」 |
| 门店 | — | 门店名称或「全部门店汇总」 |
日统计口径（必须区分）
| 指标 | 统计依据 | 统计时间 |
|---|---|---|
| 日收入金额 | 订单实际金额（支付/核销成功） | 按订单 paidAt 归属自然日 |
| 日实际打款金额 | 平台当日实际打款金额 | 按平台打款入账时间归属自然日 |
日收入用于经营分析，日打款用于结算对账；两者允许不一致。
报表结构
┌─────────────────────────────────────────────────────────┐
│ 门店损益表 — 2026 年 3 月 │
│ 门店：朝阳门店 │
├───────────────────────┬──────────────┬──────────────────┤
│ 项目 │ 金额（元） │ 占比 │
├───────────────────────┼──────────────┼──────────────────┤
│ 一、营业收入 │ │ │
│ 月卡销售 │ ¥ 29,700 │ 52.3% │
│ 季卡销售 │ ¥ 12,460 │ 21.9% │
│ 次卡销售 │ ¥ 8,900 │ 15.7% │
│ 体验卡销售 │ ¥ 3,960 │ 7.0% │
│ 外部券码核销 │ ¥ 770 │ 1.4% │
│ 退款（-） │ -¥ 890 │ -1.6% │
│ 营业收入合计 │ ¥ 54,900 │ 100% │
├───────────────────────┼──────────────┼──────────────────┤
│ 二、营业成本 │ │ │
│ 固定成本 │ ¥ 20,500 │ │
│ 人力成本 │ ¥ 10,400 │ │
│ 设备折旧 │ ¥ 2,300 │ │
│ 营销费用 │ ¥ 6,200 │ │
│ 营业成本合计 │ ¥ 39,400 │ │
├───────────────────────┼──────────────┼──────────────────┤
│ 三、营业利润 │ ¥ 15,500 │ 利润率 28.2% │
├───────────────────────┼──────────────┼──────────────────┤
│ 四、分润 │ │ │
│ 门店分成 (60%) │ ¥ 9,300 │ │
│ 总部分成 (30%) │ ¥ 4,650 │ │
│ 投资人分成 (10%) │ ¥ 1,550 │ │
└───────────────────────┴──────────────┴──────────────────┘报表生成与导出
交互流程
- 选择会计期间（年月）
- 选择门店（全部 / 指定门店）
- 点击「生成报表」
- 展示预览（见上方损益表格式）
- 确认后导出
导出格式
| 格式 | 用途 | [建议值] |
|---|---|---|
| xlsx | 导入财务软件（如金蝶、用友） | ✅ |
| csv | 备用格式 | ✅ |
| 存档/打印 | 可选 |
导出字段规范
[建议值] 导出 Excel 需包含以下列，以便对接金蝶/用友等财务系统：
| 列名 | 字段 key | 说明 |
|---|---|---|
| 会计期间 | period | YYYY-MM 格式 |
| 门店编码 | storeCode | 与财务系统门店主数据对齐 |
| 门店名称 | storeName | — |
| 科目代码 | accountCode | 对接财务系统科目编码（待与财务确认） |
| 科目名称 | accountName | 如「主营业务收入-月卡」 |
| 借方金额 | debitAmount | 成本/费用 |
| 贷方金额 | creditAmount | 收入 |
| 币种 | currency | CNY |
| 备注 | remark | 补充说明 |
明细钻取
财务报表中的每个数字都应支持向下钻取，点击后跳转到对应的原始数据列表。
| 报表项 | 钻取目标 |
|---|---|
| 月卡销售金额 | 订单列表（筛选：产品类型=月卡 + 指定期间） |
| 退款金额 | 订单列表（筛选：状态=已退款 + 指定期间） |
| 门店分润 | 分润明细表（展示计算过程） |
权限控制
| 功能 | owner | finance | ops | manager | support | 说明 |
|---|---|---|---|---|---|---|
| 查看分润配置 | ✅ | ✅ | ❌ | ❌ | ❌ | — |
| 编辑分润配置 | ✅ | ✅ | ❌ | ❌ | ❌ | — |
| 查看成本配置 | ✅ | ✅ | ❌ | ✅（本店） | ❌ | manager 仅查看本店成本 |
| 编辑成本配置 | ✅ | ✅ | ❌ | ❌ | ❌ | — |
| 查看财务报表 | ✅ | ✅ | ❌ | ❌ | ❌ | — |
| 导出财务报表 | ✅ | ✅ | ❌ | ❌ | ❌ | — |
用户故事
US-FINANCE-01：财务配置门店分润规则
作为财务人员，我想为每个门店设置分润比例，明确门店、总部、投资人之间的收入分成。
验收标准：
- [ ] 可为每个门店创建独立的分润规则
- [ ] 可设置规则的生效/失效日期
- [ ] 参与方比例之和必须 = 100%
- [ ] 可设置默认规则（适用于未单独配置的门店）
- [ ] 修改规则不影响已生成的历史报表
US-FINANCE-02：财务生成并导出月度报表
作为财务人员，我想按月生成门店损益表，导出为 Excel 格式，以便导入财务系统。
验收标准：
- [ ] 可选择会计期间和门店
- [ ] 报表包含收入、成本、利润、分润四大板块
- [ ] 支持导出 xlsx 格式
- [ ] 导出字段含科目代码，可与财务系统对齐
- [ ] 每个数字可点击钻取到明细数据
US-FINANCE-03：财务录入门店月度成本
作为财务人员，我想录入每个门店的月度固定成本和人力成本。
验收标准：
- [ ] 按门店+月份录入
- [ ] 优惠券成本自动汇总
- [ ] 设备折旧自动计算（基于设备采购价和折旧年限）
- [ ] 保存后可在报表中展示
API 接口规划
# 分润规则列表
GET /api/v1/admin/finance/profit-sharing-rules
Query: { storeId? }
Response: { items: ProfitSharingRule[] }
# 创建/编辑分润规则
POST /api/v1/admin/finance/profit-sharing-rules
PUT /api/v1/admin/finance/profit-sharing-rules/:id
Body: ProfitSharingRuleDTO
Response: ProfitSharingRule
# 成本配置
GET /api/v1/admin/finance/costs
Query: { storeId, year, month }
Response: CostConfig
PUT /api/v1/admin/finance/costs
Body: CostConfigDTO
Response: CostConfig
# 生成财务报表
POST /api/v1/admin/finance/reports
Body: { period: 'YYYY-MM', storeId? }
Response: FinancialReport { revenue, payout, costs, profit, profitSharing }
# 获取日维度收入/打款统计
GET /api/v1/admin/finance/daily-summary
Query: { date, storeId?, platform? }
Response: { incomeAmount, payoutAmount, currency }
# 导出财务报表
POST /api/v1/admin/finance/reports/export
Body: { period: 'YYYY-MM', storeId?, format: 'xlsx'|'csv' }
Response: { downloadUrl: string } | { taskId: string }