P3 — prop-acc 30 文件迁移到多域 UDAS 结构:
- 3 概念:旧 prop-acc/一次性收费/概念-*.md
→ prop-acc/concepts/adhoc-*.md (kebab-case 英文)
- 25 场景:旧 prop-acc/一次性收费/场景-*.md
→ prop-acc/scenarios/adhoc-*.md
- 子文件夹 index.md → prop-acc/maps/knowledge-map.md (域内地图)
- prop-acc/index.md 重写为域首页(embed knowledge-map)
- 删除空目录 prop-acc/一次性收费/
每个迁移文件:
- title 加域前缀 "prop-acc · "
- aliases 含原 title (带空格) + 原文件名 basename (无空格),保证既有 [[...]] 引用解析
- status: stable → 已发布 / draft → 草稿 (UDAS 中文枚举)
- last_reviewed → last_review (UDAS 字段名)
- tags 补加 UDAS 类型分类 "概念" / "场景"
- 路径式 WikiLink 清除:
* [[../预存款/index|XX]] → [[预存款]]
* [[一次性收费/index|XX]] → [[prop-acc · 一次性收费索引]]
P4 — 4 个新业务域骨架:
- community (社区管理)
- administrative (行政人事)
- patrol (巡护工单)
- resident-portal (业户门户)
每域含 index.md (域首页) + maps/knowledge-map.md (域内地图模板)。
另补 cross/index.md + cross/maps/cross-domain-map.md。
P5 — 顶层入口:
- index.md: 站点首页 (Quartz 着陆点),embed domain-map
- maps/domain-map.md: 5 业务域 + cross 的索引表
迁移后状态:
- 共 50 篇 .md (30 原 + 8 跨域 stub + 4 域 index + 4 域 map + 2 cross + 2 root)
- 残留路径式 WikiLink: 0
- 残留英文 status: 0
- 残留 last_reviewed 字段: 0
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
123 lines
3.5 KiB
Markdown
123 lines
3.5 KiB
Markdown
---
|
|
title: prop-acc · 知识地图
|
|
aliases:
|
|
- prop-acc 知识地图
|
|
- 一次性收费
|
|
- 一次性收费索引
|
|
- prop-acc · 一次性收费索引
|
|
- 一次性收费(一次性收费)
|
|
tags:
|
|
- 规范
|
|
- prop-acc
|
|
- 知识地图
|
|
audience:
|
|
- 业户
|
|
- 业务人员
|
|
status: 已发布
|
|
last_review: 2026-05-25
|
|
code_version: 2026-05-22
|
|
---
|
|
|
|
# prop-acc · 知识地图
|
|
|
|
> 物业财务域的全部文档入口。当前覆盖**一次性收费**子模块,其他子模块待补。
|
|
|
|
## 一次性收费(AdHocEvent)子模块
|
|
|
|
业户在物业**单次购买**或缴费的事项 —— 不像物业费那样按月反复出账。典型有:
|
|
|
|
- **IC 卡**(门禁卡、停车卡、电梯卡)
|
|
- **装修出入证**(给装修工人用)
|
|
- **泳票**(夏季泳池单次票)
|
|
- **充电桩电费**(电动车一次性充值)
|
|
|
|
> [!info] 系统里叫什么
|
|
> 后台数据模型名是 `AdHocEvent`(临时事件)。每发生一笔购买就建一条记录,关联一张[[概念-CollectionOrder与Receipt|收款订单和收据]]。
|
|
|
|
### 两种支付方式
|
|
|
|
> [!example] 您是怎么买的?
|
|
> - **线下 A 流**:去物业前台,职员当场收钱给您出货
|
|
> - **线上 B 流**:打开小程序,选项目下单,微信/支付宝付款
|
|
|
|
详见 [[概念-A流与B流|A 流与 B 流对比]]。
|
|
|
|
### 核心概念(3 篇)
|
|
|
|
- [[概念-A流与B流]] — 线下/线上两种购买流程对比
|
|
- [[概念-CollectionOrder与Receipt]] — 您买完后系统生成了什么
|
|
- [[概念-AdHocEvent状态机]] — 一笔购买从下单到完成中间的几种状态
|
|
|
|
### 场景手册(26 篇,**全部完成 ✅**)
|
|
|
|
#### 📦 A 流(线下前台,即收即付)
|
|
|
|
- ✅ [[场景-A流-前台购买IC卡]]
|
|
- ✅ [[场景-A流-前台购买装修出入证]]
|
|
- ✅ [[场景-A流-前台购买泳票]]
|
|
- ✅ [[场景-A流-前台办理充电桩电费充值]]
|
|
- ✅ [[场景-A流-装修公司批量采购出入证]]
|
|
|
|
#### 📱 B 流(线上小程序)
|
|
|
|
- ✅ [[场景-B流-小程序下单+微信支付]]
|
|
- ✅ [[场景-B流-小程序下单+支付宝]]
|
|
- ✅ [[场景-跨渠道补缴]] — 儿女线上下,老人前台付
|
|
|
|
#### ❌ 取消 / 退款
|
|
|
|
- ✅ [[场景-取消-业户改主意主动撤单]]
|
|
- ✅ [[场景-超时未付自动作废]]
|
|
- ✅ [[场景-已收款作废]]
|
|
- ✅ [[场景-取消-录错金额作废重做]]
|
|
|
|
#### ⚠️ 异常 / 故障
|
|
|
|
- ✅ [[场景-异常-支付完成但实物发不出]]
|
|
- ✅ [[场景-异常-微信支付回调延迟]]
|
|
- ✅ [[场景-异常-业户重复下单]]
|
|
- ✅ [[场景-异常-支付分账失败]]
|
|
- ✅ [[场景-异常-同业户跨社区Pending单]]
|
|
|
|
#### 🧾 收据 / 凭证
|
|
|
|
- ✅ [[场景-收据-现场打印纸质收据]]
|
|
- ✅ [[场景-收据-重打丢失收据]]
|
|
- ✅ [[场景-收据-小程序自助下载PDF]]
|
|
|
|
#### 📊 审计 / 对账
|
|
|
|
- ✅ [[场景-审计-月底现金对账]]
|
|
- ✅ [[场景-审计-IC卡库存与售出数对账]]
|
|
- ✅ [[场景-审计-作废事由抽查]]
|
|
|
|
#### 🔧 配置 / 准备
|
|
|
|
- ✅ [[场景-配置-新增收费项目]]
|
|
- ✅ [[场景-配置-下架收费项目并处理Pending单]]
|
|
|
|
## 跨域引用
|
|
|
|
本域引用以下共享概念:
|
|
|
|
- [[业户]] — 缴费主体
|
|
- [[门卡]] — 售卖物之一
|
|
- [[房屋单元]] — 收费归属对象
|
|
- [[预存款]] — 关联模块(待补)
|
|
|
|
## 相关代码
|
|
|
|
业务设计决策详见 `packages/prop-acc/issue.md` 的 Q1/Q2 段。
|
|
|
|
## 相关文档
|
|
|
|
- [[prop-acc · 域首页]]
|
|
- [[domain-map|跨域索引]]
|
|
|
|
---
|
|
|
|
> [!success] 一次性收费子模块:26 场景 + 3 概念 + 1 知识地图 = **30 篇完成**
|
|
>
|
|
> 写作日期:2026-05-25
|
|
> 对应代码版本:2026-05-22(详见 `packages/prop-acc/issue.md` Q1/Q2)
|