Files

Willie 35c0147a7b P3.5: prop-acc 启用子模块嵌套(adhoc/),应对大型业务域扩展

背景:
单纯按 UDAS 严格扁平,prop-acc/scenarios/ 装齐 7 子模块后预计 100-150
篇 .md 单一文件夹,Explorer 无法浏览、Quartz folder page 无法阅读。

扩展规则(已写入 SKILL.md 多域章节 + multi-domain.md 第 10 节):
- 单类型文件夹文件数 > 30 且能按业务子模块分组时,启用嵌套
- 路径:<domain>/<type>/<sub-feature>/<file>.md
- 文件名去 <sub-feature>- 前缀(路径已表达)
- title 三段式:<domain> · <sub-feature> · <名>
- frontmatter 新增 sub_feature 字段(便于 RAG 过滤)
- 跨子模块文档落在 <domain>/<type>/(不进子文件夹),与"跨域→cross/"对称

本次迁移:
- prop-acc/concepts/adhoc-*.md (3)  → prop-acc/concepts/adhoc/*.md
- prop-acc/scenarios/adhoc-*.md (25) → prop-acc/scenarios/adhoc/*.md
- 每个文件:title 加 adhoc 段、aliases 追加旧 prop-acc · 前缀形式(兼容)、
  新增 sub_feature: adhoc 字段

WikiLink 解析未受影响:
- 既有 [[场景-A流-...]] 等 200+ 引用通过 aliases (含旧 basename) 解析
- 新引用可用 [[adhoc · 前台购买 IC 卡]] 或 [[prop-acc · adhoc · 前台购买 IC 卡]]
- 各域 knowledge-map.md 内 WikiLink 全部仍有效

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-25 20:55:59 +08:00

4.9 KiB

Raw Blame History

title, aliases, tags, audience, status, sub_feature, last_review, code_version

title

aliases

场景:支付分账失败

业户付款成功,但物业商户号到结算账户的分账失败。属于支付平台异常,本系统侧只能等通知 + 人工干预。

[!warning] 进阶场景,本系统弱介入分账是微信/支付宝商户后台的功能,本系统侧基本看不到这一步。本文档仅作为应急参考。

什么是"分账"?

[!info] 一图看懂
业户付款 → 微信支付收钱 → 微信商户号(物业)→ 分账到物业银行账户
           ✅ 这一步是支付         ✅ 这一步是分账(本场景关心)
大多数小型物业不需要分账(钱直接从微信结算到对公账户)。需要分账的场景:

物业方 + 物业服务集团 + 项目方三家按比例分钱

上市物业集团 + 全国各分公司按地域分账

委托管理模式(开发商 vs 物业公司二八分)

典型情境

[!example] 真实情境鸿基物业管理集团旗下小区,业户用小程序付了 ¥3000 装修押金。

微信支付成功 → 钱进鸿基物业商户号。商户号配置了分账规则:

70% 给小区项目方

30% 给鸿基集团运营费

第二天集团财务发现:小区项目方收到 ¥2100 ✅,集团运营费 ¥900 没有收到 ❌。

业务人员视角

这种问题怎么发现?

业务人员不会主动发现 —— 通常是:

集团财务月底对账 → 发现少了一部分
微信商户后台邮件通知"分账失败"

[!warning] 关键系统侧的 CollectionOrder 状态依然是 Completed —— 因为业户支付的钱确实进了商户号,只是后续分账失败。系统层面无错。

处理流程

1. 登录微信支付商户后台 → 分账记录
2. 找到失败的分账记录,看失败原因:
   ├── 接收方账户冻结
   ├── 分账方金额不足(剩余金额已分完)
   └── 接收方未签约接收能力
3. 联系微信客服 / 修复配置
4. 重试分账 (通常 30 天内可重试)

本系统侧需要做什么?

几乎不用 —— 本系统已经"收到了钱"(从业户视角钱付完了)。分账是物业内部账务问题。

[!info] 但如果分账失败导致需要"全单退款给业户":

业务人员走场景-已收款作废标记订单作废

微信商户后台手动发起退款给业户

业户拿回钱,后续物业再处理内部账务

系统流程

sequenceDiagram
    participant 业户
    participant 微信支付
    participant 物业商户号
    participant 项目方账户
    participant 集团账户
    participant 系统

    业户->>微信支付: 付款 ¥3000
    微信支付->>物业商户号: ¥3000 入账
    微信支付->>系统: webhook → MarkAsPaid
    系统-->>业户: 订单 Completed,收据生成

    Note over 业户,系统: 业户视角:一切正常

    Note over 物业商户号: 系统自动触发分账
    物业商户号->>项目方账户: 分账 ¥2100 ✅
    物业商户号->>集团账户: 分账 ¥900 ❌ (接收方账户冻结)

    Note over 业务人员: 第二天集团对账才发现

常见问题

[!question] 业户会感知到分账失败吗? 不会。从业户视角,钱付完订单完成,完美无瑕。

[!question] 财务多久能发现? 取决于对账频率。建议物业至少每周对一次分账记录,而不是等月底。

[!question] 系统能监控分账状态吗? 当前没有集成。可以挂 TODO:

微信商户号开放分账状态查询 API

系统每天定时查最近 7 天的分账状态

失败的发警报到物业财务

[!question] 分账失败 30 天没解决,钱会怎样? 微信会原路退回给业户(钱回到业户原微信)。这种情况业户会突然收到一笔退款,联系不上业户解释 = 麻烦。所以分账失败 30 天前必须处理。

简化场景:不需要分账的物业

[!success] 大多数小型物业:跳过本场景单一物业公司,微信商户号直绑对公账户,无需分账配置。本场景对你们不适用。

待补

系统集成分账状态监控:挂 TODO,等真正出现分账失败客诉再做
多商户/多账户场景的会计科目对接:超出一次性收费模块范围,与凭证模块相关(待补)

4.9 KiB Raw Blame History