金刚系统数据与状态模型

本页说明金刚侧最重要的数据关系和状态来源。排查问题时不要只看页面展示，要沿着主表、流水、日志和任务记录一起查。

状态模型总览

状态对象	主表	状态字段/记录	日志或流水	备注
服务订单	order	order_status、order_status_name	order_logs	云平台人工派单会写订单状态和日志。
订单支付	store_payment_order、order_payments	status、payment_status	ccuser_transaction、支付回调日志	易宝回调需要幂等处理。
标准单承接	demand_square	待抢、已抢、承接门店	order_logs、历史派发日志	新标准单先查广场记录和门店管理权；历史自动派发单再查 attempt。
标准单配置	standard_order_rule_config	配置项键值	standard_order_config_snapshot	历史订单按快照复盘。
标准单通知	standard_order_notification_outbox	待发送、已发送、失败	发送结果和错误信息	员工没收到通知先查 outbox。
员工钱包	staff_wallet_account	可用、冻结、状态	staff_wallet_ledger	员工服务奖金、开发奖金和安心佣金统一进入钱包；服务奖金完成后先冻结，达到配置时长后自动转可用余额。
门店积分	store_score_account	可用、冻结、派发状态	store_score_transaction	线索和日结影响积分。
门店钱包	store_wallet_account	可用、冻结、状态	store_wallet_transaction	月度品牌费、充值、扣费走这里。
合同	contract	合同状态、服务期、主体	contract_payment、contract_change_record	变更和换人必须看操作记录。
保险	insurance_record	保单状态、退保状态	insurance_operation_record、insurance_order_log	以本地记录和第三方回调共同确认。

生产数据快照

以下为 2026-07-19 只读查询 jingangdata 的历史规模快照，不代表实时运营报表。钱包、派发和结算表中的零数据结论已经失效，只保留用于复盘当时上线阶段。

对象	记录数	判断
company	662	公司主体已经有明显历史沉淀。
store	487	门店主数据是门店端入口和资金归属核心。
internal_user	739	门店管理账号、角色和权限需要按数据范围排查。
service_staff	2925	员工端和服务人员管理是高频链路。
order	1515	订单状态已生产运行，修复前必须查日志和支付。
customer	2198	客户、地址、合同和订单强关联。
contract	1434	合同链路属于高风险生产模块。
insurance_record	1652	保险记录已有第三方状态沉淀。
store_wallet_account	479	门店钱包账户已基本覆盖门店。
store_score_account	467	门店积分账户已基本覆盖门店。
staff_wallet_account	0	员工钱包代码已具备，但真实账户尚未沉淀。
staff_wallet_ledger	0	员工钱包流水当前无沉淀。
staff_service_capability	41	员工服务能力已有少量生产配置。
staff_platform_product	219643	员工与平台产品绑定已有批量沉淀，排查候选时必须关注。
standard_staff_service_region	97	标准员工服务区域已有生产配置。
standard_staff_score_account	41	标准员工积分账户已有少量沉淀。
standard_staff_dispatch_attempt	0	当时的历史自动派发 attempt 无生产沉淀；当前新标准单已改走家政广场。
standard_order_settlement_task	0	标准单结算任务当前无生产沉淀。
standard_order_notification_outbox	0	标准单通知 outbox 当前无生产沉淀。

订单状态真实分布如下：

状态码/名称	记录数
80/已完成	826
99/已取消	311
10/已接单	135
90/已完成	79
40/已派单	59
20/派单待确认	54
50/执行中	20
60/开始服务	20
30/拒绝接单	9
20/已派单	1
80/服务结束	1

库里存在少量状态码和状态名不一致的历史记录，排查时以状态码、订单日志和服务调用链为准。

订单状态排查

现象	排查顺序
页面显示未派单	查 order.order_status 和 order_logs；新标准单继续查 demand_square、current_controller、order_waiter，历史自动派发单再查 attempt。
员工已服务但订单未完成	查员工服务记录是否提交，再查 order_logs 是否有完成状态写入失败。
订单被取消	查 order_logs 的取消来源，再看支付是否需要退款或释放钱包/积分冻结。
补价后状态不变	查 order_additional_payments 的支付状态和 payment_service.py 回调处理结果。
云平台人工派单未生效	查 yunapi 人工派单接口是否写入 order，再查 storeapi 员工端是否按新员工字段回显。

状态码口径

状态码	常见名称	主要来源
10	已接单	历史/兼容数据。
20	派单待确认	门店负责人派给本店员工后等待确认；历史数据也可能来自旧自动派发。
30	拒绝接单	员工拒单；新标准单由抢单门店负责人重新安排。
40	已派单	员工已确认接单。
50	执行中	员工进入执行过程。
60	开始服务	员工上传服务前凭证并开始服务。
70	服务结束	兼容旧流程。
80	已完成	员工完成服务，后续可进入结算或评价。
90	已评价/已完成	历史完成态。
99	已取消	取消后不可继续履约。

员工端状态机允许 20 -> 30/40 -> 50 -> 60 -> 80，70 -> 80 只为旧流程兼容。门店端老统计中还会出现 4/5/6 的历史完成/取消/拼团口径，接手时必须先看订单 business_mode 和具体接口，不要把老统计字段当标准单状态机。

全国标准单关键数据

platform_product / platform_product_sku
  -> staff_platform_product / staff_service_capability
  -> demand_square
  -> 门店负责人抢单 / current_controller
  -> order_waiter
  -> order / order_logs
  -> standard_order_settlement_task
  -> yeepay_divide_record

环节	数据要求	失败表现
产品可承接	平台产品上架，工种有效，SKU 映射正确。	支付后没有进入家政广场。
门店可抢	负责人角色有效，账号绑定当前门店，需求仍为待抢。	抢单提示无权限或已被其他门店抢到。
员工可派	员工属于抢单门店且状态有效。	负责人无法选择或提交员工。
派发可确认	员工账号有效，订单已写入服务人员关系。	员工端待接单列表没有订单。
结算可到账	订单完成后写入员工钱包冻结流水，达到配置时长自动转可用余额。	服务完成后未生成冻结流水或到期未解冻。

标准单承接与结算规则要点

规则	说明
入广场来源	CLIENT、STORE_QR 的已支付全国标准单；员工开发码订单仍属于 STORE_QR 并保留员工归因。
入广场任务	继续使用历史任务名 standard_staff_dispatch_pending，实际动作改为幂等发布到 demand_square。
抢单角色	仅公司负责人和门店负责人，且只能使用当前账号所属门店。
派员工范围	只能选择抢单门店的有效员工；员工端没有广场抢单入口。
历史派发	已存在有效通知或已接单记录的历史订单不重复进入广场，原 attempt 和日志保留审计。
服务奖金比例	当前 SERVICE_BONUS_RATE = 0.70，历史订单以支付时快照为准。
服务奖金冻结	当前 SETTLEMENT_GRACE_MINUTES = 240，即服务完成后默认冻结 4 小时；以支付时配置快照为准。
开发奖金	员工和门店开发奖金当前均为 0.05，开发奖金冻结时长由 DEVELOPMENT_FREEZE_HOURS 配置，默认 2 小时。
平台收款	YEEPAY_ORDER_MERCHANT_NO 已配置，正式文档不写商户号明文；排查时在受控环境查配置表或云平台配置中心。
历史轮排	standard_staff_dispatch_cursor 只用于复盘旧员工池派发；新标准单不再进入该轮排。
员工拒绝	订单继续归抢单门店管理，由负责人重新选择本门店员工。

员工能力和区域

数据	判断
service_staff.status、is_delete	员工是否有效。
staff_service_capability	员工是否具备服务产品或工种能力。
standard_staff_service_region	标准员工可服务区域，供店长派工和运营核对。
employee_schedule*、staff_rest_date	员工是否有档期冲突或休息。
standard_staff_schedule_lock	是否被并发订单锁定。
staff_platform_product	是否绑定平台标准产品。

钱包、积分和结算

员工钱包

员工钱包用于员工开发奖金、安心支付佣金、提现和收入记录。全国标准单服务奖金任务会在钱包页面聚合展示进度，但资金成功后直接进入员工易宝商户，不增加钱包可提现余额。排查时看：

表	作用
staff_wallet_account	员工账户余额、冻结金额、状态。
staff_wallet_ledger	每一笔收入、支出、冻结、解冻、提现流水。
staff_withdrawal_application	提现申请、审核、打款状态。

关键原则：

1. 结算任务必须幂等，不能重复给同一订单生成收入。
2. 提现前必须确认可用余额足够。
3. 打款失败要保留失败原因和可补偿入口。

当前员工钱包页面会聚合标准单结算任务、开发奖金任务、安心支付钱包流水、历史只读收入和易宝入网状态。staff_wallet_account 为空时，不代表员工收入页面一定为空；标准单任务和历史 order_waiter 收入可能只读展示，不进入可提现余额。

员工提现状态：

状态	含义
PENDING	已申请，等待审核或处理。
APPROVED	已审核通过，等待打款。
PROCESSING	打款处理中。
COMPLETED	已完成。
FAILED / REJECTED	失败或驳回，需要看失败原因和回退流水。

同一员工存在 PENDING、APPROVED、PROCESSING 中任一提现时，不能再次提交提现。

门店积分

门店积分用于线索、排名、扣分、日结和派发开关判断。

表	作用
store_score_account	门店当前积分和派发状态。
store_score_transaction	积分变动流水。
store_score_category、store_score_item	积分规则。
store_score_settlement_batch	日结批次结果。

dispatch_status = ACTIVE 才表示门店可以进入线索派发；PAUSED 通常说明余额、品牌费、人工暂停或规则限制导致暂停。

门店钱包

门店钱包用于门店资金余额、月度品牌费、充值、扣款和功能开关。

表	作用
store_wallet_account	门店钱包余额和冻结金额。
store_wallet_transaction	钱包流水，要求幂等键。
store_wallet_feature_config	功能开关。
store_wallet_suspense	悬挂或异常资金。

月度品牌费扣款会同时影响钱包流水和门店派发状态；余额不足时可能暂停门店派发，补足后需要恢复。

门店钱包写入动作必须走服务层：

动作	结果
credit	可用余额增加，写收入流水。
debit	可用余额减少，余额不足直接拒绝。
freeze	可用余额减少、冻结增加。
unfreeze	冻结减少、可用增加。
confirm_frozen_expense	冻结减少，确认扣费。

每个动作都要求 idempotency_key，资金修复不能直接改余额字段。

合同和保险状态

环节	主表	排查重点
合同主流程	contract	合同状态、客户、门店、阿姨、服务期。
合同支付	contract_payment、store_payment_order	支付订单号、金额、回调状态。
合同补充	contract_supply	补充协议、离职日期、导出状态。
换人/续签	contract_change_record、contract_resign_log	谁发起、何时生效、是否同步保险。
合同保险	contract_insurance	合同和保险记录是否一致。
保险投保	insurance_record	保单号、状态、起止日期、产品。
保险退保	insurance_surrender_document	材料状态、文档地址、提交状态。

保险状态不能只看页面提示。第三方处理结果、回调、操作记录和本地保单状态必须一起确认。

第三方依赖

依赖	用途	本地证据
微信小程序	登录、订阅消息、员工端入口。	openid、模板消息、员工登录记录。
易宝	商户入网、支付、分账、提现相关能力。	yeepay_*、store_payment_order、支付回调日志。
支付宝安心生活	订单抓取、同步和状态回调。	alipay_anxin_*、安心生活自动抓单任务。
大地保险	家政责任险、退保材料和接口。	insurance_record、insurance_operation_record、退保文档。
人保	人保投保能力。	picc_insurance_service.py 和对应保险记录。
OBS/远程文档服务	合同、退保 Word/PDF、图片资源。	文件表、文档地址、上传结果。

写文档和改代码时的约束

1. 状态类文档必须写清主表和日志表。
2. 钱包、积分、支付、合同、保险不能只写页面操作，必须说明资金和状态来源。
3. 小程序端发布受微信审核节奏影响，后端上线要兼容旧小程序。
4. 需要后台补偿的逻辑统一落到任务或脚本，不依赖云函数响应结束后的后台任务。
5. 小羽佳订单协同旧链路不继续扩展文档。

员工服务奖金钱包结算（2026-09-11）

标准单员工点击完成订单后，服务奖金不再等待易宝分账：

1. 服务奖金按订单完成时的配置比例计算，立即写入员工钱包“冻结金额”，明细状态显示“冻结中”。
2. 冻结时长读取订单配置快照，当前默认 SETTLEMENT_GRACE_MINUTES = 240（4 小时）。
3. 结算计划任务到期后，将冻结金额转为钱包可提现余额，明细状态显示“已到余额”。
4. 钱包流水使用订单结算任务幂等键，重复执行不会重复增加余额。
5. 历史易宝分账未成功且未存在服务奖金钱包流水的任务，可在到期后自动迁移到钱包；已成功易宝分账的任务不迁移。