XINYUAN · PRODUCT REQUIREMENTS

心源四本账透明中枢
产品需求文档

给经营者、投资者、DRC 投资者、员工各自「该看、能看、想下钻到底」的实时账目视图,用 透明 × 边界 交付安全感。
v1.0 · 定稿待开发 2026-11-09 对齐底座:自治理工作台

0 · 一句话定位

这是大愿「还生命一个微笑,让每个角色回到本自具足」在财务数据上的投影——不是一张报表,是一个让每个角色都能「安心」的透明中枢。

1 · 背景

  • 从三本账到四本账:现金流 / 劳动业绩 / 卡金负债,升维为「+ 费用账」。费用账补的是银豹算不到的期间费用(房租、水电、伙食、人工、杂费)。
  • 账不清,提成定价都是拍脑袋:银豹只能算到毛利,费用取不出来;净利润算不清之前,提成方案与定价都先悬着。
  • 安全感是第一需求:经营者和投资者真正要的不是「一张漂亮的报表」,而是「任意一天、任意一段,随时能翻回去对账,一分不差」的确定性。

2 · 产品目标(北极星)

北极星公式
安全感 = 透明 × 边界

透明:该看的数据一路下钻到订单级,银豹授权能拿到的全部给看,一分不藏。
边界:不该看的不看,且每个角色清楚「我的权限边界在哪」——边界不是隐瞒,是慈悲的分寸,也是防人性恶的护栏。

3 · 价值观与设计原则(四条铁律)

铁律 01
真诚 = 修行第一步
每个数字标注数据来源(银豹 API / 心源自建),不装神。
铁律 02
透明 × 边界
最小权限原则;权限矩阵清晰,防越权、防监守自盗。
铁律 03
实时
数据基于当下实时计算,不是昨天的截图。
铁律 04
情绪价值 = 慈悲
没时间看摘要卡片,有时间看完整 HTML 详情,给两种选择。

4 · 角色与权限矩阵

角色看到什么下钻深度附加权边界动机
经营者
刘永睿
全部四本账+净利润订单级全部总负责人,全量
投资者
赵升强
四本账+现金流/业绩明细订单级监控权+订单响铃出资人知情权
DRC 投资者DRC 专项:营业额+分成+回本进度到分成账单每日分成推送只关心回本与分成,不被无关数据淹没
员工 / 技师自己的业绩 / 提成自己的订单无只看自己,不看全局

设计动机:不同维度的边界带来不同维度的安全感,同时防止人性之恶——让每个人只接触职责范围内该接触的数据。

5 · 四本账数据模型

5.1 四本账定义

账本质计量数据源
① 现金流真实收进来的钱(收付实现制)元银豹销售单+充值记录
② 劳动业绩已消耗 / 已确认的服务价值(权责发生制)元银豹划卡消费
③ 卡金负债客人没花完的钱(你欠客人的)元+次银豹余额+剩余次数
④ 费用账门店花出去的钱(期间费用)元心源自建(企微录入)

5.2 卡金负债细分(三种量纲,不混加)

  • 储值卡负债(钱型 · 按余额,可退现金)——最刚性。
  • 次卡负债(服务型 · 按剩余次数 × 单价,退未履行服务)——普通次卡 / 套餐次卡 / 多服务次卡 / 疗程卡。
  • 时效卡负债(时效型 · 按剩余天数摊销)——月卡 / 季卡 / 年卡。
  • 澄清:充值赠送是营销成本(非负债);会员欠款是资产(非负债)。

5.3 两个守恒闭环

闭环 A · 资金守恒
现金流 + 历史卡金转入 + 营业外 = 劳动业绩 + 卡金负债
闭环 B · 利润核算
净利润 = 营业额 − 商品成本(染膏耗材)− 期间费用(费用账)

6 · 时间维度(产品骨架 = 时间轴)

维度显示安全感
日报今日四本账+净利润+守恒每天确定
周报7 天合计+趋势曲线周期确定
月报1 号~月底合计+月度趋势(自然月)月度确定
自定义区间任意起止日合计随时对账

顶部「日 / 周 / 月 / 区间」切换,左右箭头翻页可回看任意一天,「回到今天」一键锚点。回看 = 翻「当日快照」,不是临时重算(快、准、可追溯)。

7 · 下钻三层(每个数字点到「底」)

总览(四本账+净利润)
├ 现金流 → 充值 / 买卡 / 散客 → 每一笔(时间+会员+金额+支付方式+收银员)
├ 劳动业绩 → 划卡明细 → 每一笔(时间+会员+项目+技师+金额)
├ 卡金负债 → 储值余额 / 次卡剩余 → 每一个会员的余额、剩余次数
└ 费用账 → 房租 / 水电 / 伙食 / 人工 / 杂费 → 每一笔(日期+科目+金额+支付方式)

现金流、业绩、负债三本由银豹 API 支撑到订单级;费用账下钻到每笔费用记录(心源自建)。每一层可点击展开,逐级穿透,直到无可再钻。

8 · DRC 合约视图(钱生钱投资者专属)

DRC 投资者不看全部四本账,只看一件事:「我投的钱回本了吗,今天分了多少」。

8.1 合约参数(待定稿)

参数值
回本比例 r18%(回本前按营业额分成)
回本减半 r24%(回本后减半)
封顶倍数 k1.8 倍(分成总额封顶)
日切T+1
总比例穿透≤ 50%

8.2 视图内容

  • 今日营业额(分成基数)→ 实时
  • 今日分成 = 营业额 × 当前档位比例(8% / 4%)
  • 回本进度条:本金 → 已回本 → 剩余
  • 档位里程碑:8% → 4%(回本减半)→ 1.8 倍(封顶)

关键:DRC 数据 = 银豹营业额(数据源)+ 心源 DRC 合约引擎(计算层)。银豹里没有 DRC 概念,计算层由心源自建。

9 · 五感安全感矩阵(眼耳口鼻身)

眼 · 看
门店实时监控+数据可视化
外采 · 第三方监控授权
耳 · 听
每笔订单收款响铃(语音播报)
外采 · 银豹官方 App
口 · 说 / 问
下钻追问明细、对账
自建 · 四本账中枢
鼻 · 嗅
异常预警(负债异常 / 亏损 / 大额异常)
自建 · 四本账中枢
身 · 触达
每日日报 / 分成推送
自建 · 企微消息

用户明确:订单响铃无需心源开发——银豹官方 App 关联员工手机,银豹支付接口收款时原生语音播报。监控由第三方软件授权给投资方。心源自建的只有「口、鼻、身」三感(数据、预警、触达),「眼、耳」是外采整合。

10 · 数据源与能力边界(真诚的第一步)

能力银豹 API真相
订单实时推送(Webhook)✅银豹原生支持,订单产生即推
订单级明细(时间 / 会员 / 金额 / 支付 / 收银员)✅销售单据 API
会员余额、充值记录、次卡剩余✅会员 / 预付卡 API
门店物理监控❌第三方监控软件授权
费用账❌心源自建(企微录入)
DRC 合约分成❌心源自建计算层

把边界说清,才是修行——如实告诉每个角色「哪些数据来自银豹、哪些来自心源、哪些来自第三方」,透明才不是装出来的。

11 · 技术架构(实时底座)

银豹订单 Webhook / 查询 API —— 订单产生即推,查询拉明细
▼
心源云端(自治理工作台)
四本账计算引擎 · DRC 合约引擎 · 当日快照落库
▼
HTML 详情页(企微鉴权 · 手机优先 · 可下钻回看)+ 企微推送(日报 / 分成 / 预警)
  • 实时性:订单 Webhook 触发计算,点开看到的都是「当下这一刻」。
  • 鉴权:HTML 链接走企微网页授权,仅企业成员可看(隐私方案 C)。
  • 回看:每日快照落库,任意日期翻快照。

12 · 版式设计(手机优先)

  • 灵魂是时间轴:顶部「日 / 周 / 月 / 区间」是主角,不是日报表。
  • 净利润永远置顶放大:经营者和投资者真正看的一行,深绿底一眼到位。
  • 卡金负债永远常驻:它是「客人信任的度量」,不藏、不缩。
  • 守恒验证是安全感的锚:每屏底部固定「资金守恒 ✓ 分毫不差」。
  • 数据来源可追溯:脚注标注「银豹 API + 心源费用账」,不装神。
  • 周 / 月报 = 同一骨架换数据:版式不变,数据与趋势柱随维度切换。

13 · 迭代里程碑

版本范围
1.0四本账总览+下钻三层+日报+守恒验证+企微鉴权
1.1周报 / 月报(自然月)+自定义区间+历史回看
1.2DRC 合约视图+分成推送
2.0角色权限矩阵全量落地+异常预警(鼻)+监控 / 响铃外采整合

14 · 待确认问题

  • 1银豹订单 Webhook 的具体接入方式与字段(接入时实测)。
  • 2监控第三方选型(萤石云 / 海康威视 / 其他)与授权机制。
  • 3DRC 合约参数最终定稿(本金、r1/r2、封顶倍数 k、穿透上限)。
  • 4银豹官方收款 App 的确切名称与「关联员工手机」配置路径。
  • 5企微网页授权(OAuth)的接入范围(仅经营者和投资者,还是全成员)。
  • 6费用账字段定版(日期 / 科目 / 金额 / 支付方式 / 备注)与企微录入入口形态。