利润中心

v2.1.0 10-利润中心 ASA 状态:待评审 2026-10-21 评审版 · 由 PRD.md 自动生成,勿手改

利润中心 PRD

项内容
所属产品ASA
版本v2.1.0
页面10-利润中心
涉及功能利润中心(feature 台账由总控登记)
编制日期2026-10-20(2026-10-21 总控代改:按《会议清单 v2》回写;2026-10-22 总控代改:按《闭环问题清单》回写)
文档状态待评审
目标读者研发、测试、AI 实现助手(本文件可直接整份投喂给 AI 作为实现依据)
关联文档本目录 spec.yaml、mocks/;版本 index.md;原型 html/利润中心.html(无 V2.1 注释,只有 UI,规则来自版本级决策与用户确认)

0 前置说明

1 整体概述

1.1 背景与目标

现状:账单、返点、渠道、收付款各自在自己页面里,币种也不一样(人民币 / USD / USDT),公司没有地方看每个账户每个月到底赚了多少、这个数算没算准。

目标:

可证伪的判定:公共前置(spec.yaml 头部)下,橙子-iOS-CN 2026-09 毛利润 32,804.57 人民币(渠道统计金额按共享订单分摊为 17,000.00 USD,手续费 315.83 = 手续费(09)-62.67 + 改应付差额 378.50);苹果ASA 2026-09 渠道付款单到账后,这一行从「计算中 · 渠道未付完」变「已算完」。

1.2 本页范围

1.3 角色与权限

角色能做什么不能做什么数据范围 / 权限来源
有「利润中心」权限点的用户进入利润中心;看列表、概览、详情修改任何金额或状态全部账户,不按账户查看权限过滤、不受客户数据范围隔离(R-10-061);页面查看权限点(R-10-060)
系统计算、折算、判断状态、重算、记变化记录、给 11 提供数据回写来源单据R-10-001~R-10-024、R-10-070~R-10-072

1.4 术语定义

术语释义
利润记录一个账户一个 UTC0 自然月的一行利润(R-10-001)
利润日明细利润记录拆到每个 UTC0 自然日后的金额,用于逐日折算和给 11(R-10-012)
原币账户消耗币种(R-05-002);手续费、改应付差额的原币是收款单 / 结算单币种
业务发生日折人民币时取汇率的那一天(R-10-011)
算没算完计算中 / 已算完,按四件事自动判断(R-10-021)
共享订单自接苹果的账户系统里同一个订单号挂在多个账户下(R-10-006)
公司承担服务费税费服务费税费承担方为公司的那部分,06 记 0,本页补算并计入成本(R-10-008)
改应付差额结算单默认应付(改前应收)与审批通过的应付之差,并入本页手续费(R-10-009)
提成用当日毛利渠道统计金额与手续费按当月消耗占比拆到各天后的当日毛利,只给 11(R-10-072)

1.5 核心流程

步骤操作者系统行为产物
1系统账户当月有消耗(或渠道统计金额、手续费)→ 生成利润记录,计算中(R-10-001)利润记录
2系统从 06 / 07 / 08 / 09 取原币金额,补算公司承担服务费税费、改应付差额,共享订单分摊、手续费归月(R-10-003~R-10-009)—
3系统按业务发生日逐日折人民币,算毛利润(R-10-011~R-10-013)利润日明细
4系统来源数据变化时重算,四件事都完成 → 已算完并锁定汇率(R-10-010、R-10-021、R-10-023)状态
5系统已算完以后又变了 → 退回重算,记变化记录(R-10-024)变化记录
6有「利润中心」的用户看列表、概览、详情(R-10-030~R-10-056)—
7系统(11)读账户 × 日的提成用当日毛利、服务费与账户 × 月状态(R-10-070、R-10-072)—

2 详细需求

2.1 毛利口径(定义)

2.1.1 功能描述

定义一条利润记录什么时候有、每一项原币金额从哪来。人民币怎么折见 2.2。

2.1.2 核心字段(利润记录)

字段名key类型必填枚举/取值默认值规则说明
账户account_id关联对象是02 账户——
结算期periodstring(7)是yyyy-mm(UTC0),≥ 上线月—R-10-001
原币currencyenum是人民币 / USD / USDT—账户消耗币种
消耗 / 服务费 / 税费consumption / fee / taxdecimal(2) 人民币是——R-10-003
服务费税费fee_taxdecimal(2) 人民币是——客户承担部分,只展示(R-10-002)
公司承担服务费税费company_fee_taxdecimal(2) 人民币是≥ 00.00计入成本(R-10-008)
客户返点 / 客情费用rebate / care_feedecimal(2) 人民币是≥ 0—R-10-004
渠道统计金额channel_amountdecimal(2) 人民币否没有数据为空—R-10-005、R-10-006
渠道返点channel_rebatedecimal(2) 人民币否系统抓取为空—只展示(R-10-002)
手续费(09)handling_fee_09decimal(2) 人民币是可为负0.00R-10-007
改应付差额adjust_diffdecimal(2) 人民币是可为负0.00R-10-009
手续费handling_feedecimal(2) 人民币是可为负0.00= 上两项之和(R-10-007)
毛利润gross_profitdecimal(2) 人民币否缺汇率为空—R-10-002、R-10-015
状态statusenum是计算中 / 已算完计算中2.3
还差missing列表否客户未收完 / 返点或客情未结完 / 渠道未付完 / 缺少汇率—R-10-022
汇率已锁定fx_locked布尔是是 / 否否R-10-010
计算时间updated_atdatetime(Asia/Shanghai,秒)是系统—详情展示

利润日明细、利润变化记录的字段见 spec.yaml entities。

2.1.3 业务规则

2.1.4 异常与边界

场景现象系统行为用户看到
渠道数据还没到08 为「-」毛利按渠道 0 算,状态计算中(R-10-005)渠道统计金额「-」,毛利润旁「未含渠道成本」,「渠道未付完」
系统抓取、本期无订单08 行已完成,账户为「-」视为付完、按 0 计(R-10-005、R-10-021)「-」,不标「未含渠道成本」
共享订单同一订单挂 C、D按消耗占比分摊(R-10-006)本页 C + D = 08 第一层,与 08 账户行不同
结算单改过应付默认 249,603.94 → 249,000.00差额 603.94 按账户拆进手续费(R-10-009)详情两行「手续费(09)」「改应付差额」
应付为 0 的结算单返点 / 余额抵满或人工改 0审批通过即已结算,没有手续费(09);人工改 0 的差额进手续费(R-10-009)客户收完 ✓
服务费税费公司承担06 记 0本页补算计入成本(R-10-008)「公司承担服务费税费」有值
账单已锁定后消耗修正06 不变按快照(R-10-003、R-10-006)利润不变;详情顶部提示(R-10-050)
只有手续费的月份预付充值到账,该月无消耗照样出行(R-10-001)毛利润为负
上线前月份—不出行(R-10-001)结算期下拉没有这些月

2.2 人民币折算(定义)

2.2.1 功能描述

所有金额按业务发生日的日汇率折人民币(D-00-74);按日保留 2 位后再汇总(D-00-35)。页面只展示人民币,原币和汇率只在详情里辅助展示(D-00-36)。

2.2.2 业务规则

2.2.3 异常与边界

场景触发系统行为用户看到
当天没有汇率汇率表缺当天向前取最近一天(R-10-010)详情按日明细显示所用汇率
完全取不到汇率上线后第一次取到汇率之前R-10-015「-」,概览提示未计入;还差「缺少汇率」
已算完后汇率被修订技术补录 / 修订历史汇率已锁定的记录不重算(R-10-010)金额、状态不变,无变化记录
实际金额改了07 进单时改金额按系统逐日占比拆(R-10-012)尾差在最后一天
原币是人民币—汇率 1—

2.3 算没算完(定义)

2.3.1 功能描述

每条利润记录自动判断「计算中 / 已算完」;数据变了自动退回重算;已算完的记录变化要留痕(D-00-63~D-00-66)。

2.3.2 业务规则

2.3.3 状态与流转(本页定义:利润记录)

当前状态触发动作操作者目标状态前置条件
无该账户该月满足出行条件系统计算中R-10-001
计算中四件事都完成系统已算完R-10-021;首次已算完时锁定汇率(R-10-010)
已算完来源数据变化后重算,四件事有一件不再完成系统计算中R-10-023,记变化记录 R-10-024;汇率修订不触发

逆向:没有人工确认或退回(D-00-64);退回只由数据变化触发。08 付款后金额变化时 08 行状态不变(D-08-08),这类账户同样算付完(R-10-021③),重算后马上回到已算完,只留一条变化记录;被修正文件清成「-」的账户退回计算中,直到 08 再给出数值。

2.3.4 异常与边界

场景触发系统行为用户看到
付款单只确认了汇款09 待完成不算渠道付完(R-09-072)「渠道未付完」
已算完后订单数据变了08 行仍已完成重算,仍已算完,记一条(R-10-024)毛利变化;详情变化记录
修正文件让账户变「-」08 整批替换退回计算中(R-10-023)「渠道未付完」
计提项从无返点变待结算消耗修正(R-07-014)退回计算中「返点或客情未结完」
客户一直不付09 不作废(D-09-02)一直计算中「客户未收完」
08 行总计为 0.00结算期结束视为已完成(R-10-021③)渠道付完 ✓
08 行总计 < 008 不能发起渠道付款,行保持待完成(R-08-056)一直计算中(R-10-021③)「渠道未付完」;11 提成一直「-」(index §2.9)

2.4 利润列表

2.4.1 功能描述

页面顶部搜索与筛选,中间数据概览,下面是利润记录列表,每行一个账户一个月,行操作「详情」。

2.4.2 业务规则

2.4.3 异常与边界

场景现象系统行为用户看到
空态没有任何利润记录—「暂无数据」
筛选无结果——「没有符合条件的利润记录」
列表加载失败接口报错 / 超时沿用现有列表的加载失败处理现有失败提示与重试
缺汇率的行R-10-015金额「-」毛利润「-」,还差「缺少汇率」
渠道未到的行R-10-005按 0 计毛利润旁「未含渠道成本」
账户名称很长—超长省略,悬浮显示全称(沿用)—
无权限没有「利润中心」R-10-060、R-13-005菜单不显示;直接访问时内容区「无权限访问」,地址不变
权限加载失败权限 / 菜单接口失败(非登录失效)R-13-006,不跳登录「加载失败,请刷新」与「重新加载」
示意 1利润中心列表(数据概览、计算中还差项、渠道「-」、缺汇率)mocks/01-利润列表.html
示意 2利润中心列表(空态)mocks/02-空态.html

2.5 数据概览

2.5.1 业务规则

2.6 详情

2.6.1 功能描述

点行操作「详情」,右侧打开抽屉,看这一行的原币、汇率、来源、按日明细、手续费、共享订单分摊、完成情况和变化记录。只读。

2.6.2 业务规则

2.6.3 异常与边界

场景现象系统行为用户看到
缺汇率R-10-015对应格「-」顶部「未取到 USDT→人民币 汇率」;完成情况「汇率齐全」✗
没有手续费 / 没有共享订单——「本月没有手续费」/ 不显示分摊块
点来源审批单号但无查看资格R-12-043新页打开审批详情唯一地址,由 12 处理(R-10-051)审批详情页「无权限查看」
抽屉打开期间数据重算—不自动刷新,重新打开看最新(计算时间可对照)计算时间
详情加载失败—沿用现有失败处理现有失败提示与重试
示意 3利润详情抽屉(汇总、按日明细、手续费、共享订单分摊、完成情况)mocks/03-详情抽屉.html

2.7 权限

2.8 对外接口

3 验收标准

公共前置见 spec.yaml 文件头:上线月 2026-09;今天 2026-10-26;日汇率 9-10 7.1000、9-15 7.1100、9-20 7.1200、9-30 7.1300(1 USD = x 人民币);橙子 C 9-10 消耗 8,000.00、9-20 消耗 12,000.00(服务费税费客户承担),D 9-15 消耗 12,000.00(服务费税费公司承担,税率 6.00%);06 账单已结算,SK-B 默认应付 249,603.94 改为 249,000.00、实收 249,100.00,09 手续费 C -62.67、D -37.33;07 C 返点、客情已结算,D 返点待结算;苹果ASA 2026-09 渠道未付款。

3.1 毛利口径与折算

3.2 算没算完

3.3 列表与概览

3.4 详情、权限与接口

4 变更影响面

被影响对象影响方式处理动作负责人
06 账单本页读账户行、状态、结算单默认应付与审批通过的应付;改应付差额并入本页手续费(D-10-02 改,2026-10-21)06 需能给出每张结算单的默认应付(改前应收)与审批通过应付、各账户行应收;返点抵扣 / 余额抵扣 / 上期预付欠费 / 结转额行要能与账户行收入区分06 / 技术
07 返点本页读计提项金额与完成口径无需改 07—
08 渠道本页读渠道统计金额与变化通知;共享订单在本页分摊;付完判定按 R-08-091(含无订单、0.00 行);详情要 08 账户已付快照值;行状态变化(R-08-054、R-08-056)触发本页重算(R-10-023)08 R-08-091 按 D-00-65、D-00-80 改写后本页引用即可;08 R-08-024 补「行状态变化(R-08-054、R-08-056)也要通知 10」(闭环清单 B01,08 改)08
09 收付款手续费归月、付款差额不进毛利;09 手续费 ≠ 10 手续费(差改应付差额)是有意的无需改 09—
11 提成读本页账户 × 日数据(含提成用当日毛利 R-10-072)与月状态(R-10-070)11 R-11-010、R-11-012 已改引用11(已同步)
13 权限「利润中心」页面查看权限点(R-10-060,D-00-78)汇总13
版本级D-00-34(公式)、D-00-65(四件事)、D-00-66(汇率锁定例外)、D-00-74(日汇率)、D-00-80、D-00-81index 子任务改写总控
存量上线前月份不出行;上线月 = 第一个在系统里付渠道款的结算期,06 / 07 / 08 / 10 / 11 共用(D-10-08、D-10-26,index S-18)上线前定具体月份用户 / 总控

假设:

5 非功能与埋点

6 开放问题

编号问题卡谁 / 影响哪条需谁回答期望结论时间
Q-10-01【已关闭 2026-10-21 → D-00-74、R-10-010】日汇率数据源、USDT 覆盖、精度—技术(已答 T12)—
Q-10-02【已关闭 2026-10-21 → D-10-08、R-10-001】上线前月份、上线月是哪个月—用户(已定 D60)—
Q-10-03【已关闭 2026-10-21 → D-10-22、R-10-035】销售 / 优化师取当前值还是按归属—用户(已定 D92-10)—
Q-10-04【已关闭 2026-10-21】D-10-09~D-10-18 代定项已确认—用户—
Q-10-05财务确认:① 公司承担的服务费税费计入成本(会议清单 D17 的前提);② 自接苹果的「税费」是我方要缴的销项税还是代收,要缴的话是否同额计入成本R-10-008;不阻塞(确认前按 R-10-008)财务(经总控)上线前

7 附录

7.1 已定决策

编号决策点结论状态
D-10-01服务费税费与公司承担服务费税费06 的服务费税费(客户承担)只展示;公司承担服务费税费计入成本2026-10-21 用户定,会议清单 D17(前提财务确认,Q-10-05)
D-10-02结算单应付改动差额并入手续费:10 手续费 = 改前应收 − 实收,展示拆「手续费(09)」「改应付差额」两行2026-10-21 用户定,会议清单 D16
D-10-03共享订单按消耗占比分摊,尾差给消耗最大的已定(用户)
D-10-04手续费归月结算单支付 → 账单月;账户充值 → 收款完成月(UTC0)已定(用户)
D-10-05付款差额不进毛利;汇兑损益不单列已定(用户)
D-10-06汇率取哪天六项按日;渠道两项取结算期最后一天;手续费取完成日已定(用户)
D-10-07数据范围「利润中心」权限点,看全部已定(用户)
D-10-08上线前月份不出行;上线月 = 第一个在系统里付渠道款的结算期已定(用户);上线月定义 2026-10-21 会议清单 D60;共用范围见 D-10-26
D-10-09~D-10-18粒度、列、筛选、概览、状态边界、逐日拆分、缺数据、详情、排序、给 11见 spec.yaml decisions由我代定,用户已确认(2026-10-21 Q-10-04 关闭,算已定)
D-10-1911 截 0 的对象给 11 的当日毛利里,渠道统计金额与手续费按当月各日消耗占比拆到各天2026-10-21 用户定,会议清单 D15
D-10-20已算完看不看汇率加第四件事「汇率齐全」2026-10-21 用户定,会议清单 D61
D-10-21关账不做通用关账;已算完时锁定汇率;锁定后才出现的业务日按重算当时的日汇率取,下次判为已算完时一起锁定2026-10-21 用户定,会议清单 D110;锁定后新业务日 2026-10-22 用户与技术确认,闭环清单 B15
D-10-22销售 / 优化师口径维持当前值,列头标「(当前)」,注明与 11 不同2026-10-21 用户定,会议清单 D92-10
D-10-23渠道「-」与无订单账户「未含渠道成本」与概览提示;系统抓取无订单视为付完2026-10-21 会议清单 D108、D12-无订单账户;显示方式由我代定
D-10-24账单锁定后的消耗修正分摊消耗取快照;详情顶部提示2026-10-21 会议清单 D109
D-10-25详情来源08 审批单号可点;已付快照灰字2026-10-21 会议清单 D62、D12-来源展示
D-10-26上线月对齐与没有账户行兜底06 出账单、07 计提、08、10、11 从同一个上线月(index S-18)起算,共用一个配置;结算期 ≥ 上线月、该账户该月有消耗却没有 06 账户行时按「客户未收完」处理,不判已算完2026-10-22 用户与技术确认,闭环清单 A01
D-10-27重算触发补完成条件变化08 行状态变化、0.00 行结算期结束后视为已完成、没有账户行次月 2 日视为客户收完,三者都触发重算,原因记「完成条件变化」2026-10-22 用户与技术确认,闭环清单 B01

7.2 原型对照

原型本页处理
利润中心.html:1955–1966「货币展示」人民币 / 美元不做,只展示人民币(R-10-036)
利润中心.html:1974、3505 隐藏的「汇率配置」按钮与弹窗(结算期 / 对美汇率)不做,用日汇率(R-10-010)
利润中心.html:1911–1943 销售、优化师选项「待结算 / 已结算」残留,改为启用用户 + 已禁用用户(R-10-033)
利润中心.html:2335、2642 信息展示「审批」「草稿」两个隐藏状态残留,不做(R-10-036)
利润中心.html:2054–2323 主表列沿用,加「公司承担服务费税费」与操作「详情」(R-10-031)
利润中心.html:3338–3492 数据概览(毛利润等带「$」)沿用 9 项 + 公司承担服务费税费,只人民币,加算完计数(R-10-040、R-10-041)
原型没有详情、没有状态说明新增详情抽屉与还差项(R-10-022、R-10-050)