Vault/uniprop-manual
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

nav: 导航页全部改用 Markdown 相对链接(Gitea / GitHub 可点击)

Browse Source 
问题:UDAS 主线规则强制 WikiLink,但 WikiLink 在 Gitea / GitHub Web
渲染为纯文本不可点 —— 团队在那两处浏览必须"翻文件目录"才能进文档。

规则更新(已写入 SKILL.md WikiLink 章节):
- 知识内容(concepts / scenarios / procedures / decisions / faq / glossary):
  继续用 [[...]] WikiLink(驱动 Graph View、位置无关)
- 导航页(任何 index.md、所有 maps/*.md):改用 [文本](相对路径.md)
  Markdown 链接 —— 三平台(Obsidian / Quartz / Gitea)都可点
- ![[...]] embed 可保留,但导航页必须同时配 [查看 X](path/to/X.md) 降级链接

本次改动:
- 顶层 index.md:6 域入口表 + embed + 降级链接
- maps/domain-map.md:6 域表(双链:域首页 + 域知识地图)
- cross/index.md:8 共享概念表 + embed + 降级链接
- cross/maps/cross-domain-map.md:8 概念表 + 编排场景预告
- prop-acc/index.md:7 子模块进度表(链 adhoc 深度图)+ embed + 降级 + 跨域链
- 4 新域 index.md + maps/knowledge-map.md(community/administrative/patrol/
  resident-portal):统一模板,子模块行占位,跨域共享 8 链

prop-acc 知识地图拆分:
- 原 maps/knowledge-map.md 内容(adhoc 子模块的 25 场景 + 3 概念)
  git mv → maps/adhoc-knowledge-map.md(子模块深度图)
- 新建 maps/knowledge-map.md(prop-acc 域总图,7 子模块表)
- 配合 SKILL.md 多域子模块规则 S-5:子模块数 > 3 或单子模块文档 > 20 时
  另建子模块深度图

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Willie
2026-05-25 21:46:28 +08:00
parent c08aa47dbd
commit 83b4e0277c
14 changed files with 333 additions and 173 deletions
Download Patch File Download Diff File Expand all files Collapse all files

32
administrative/index.md
View File

@@ -17,11 +17,37 @@ last_review: 2026-05-25
员工档案、入离职、组织、考勤、角色授权 员工档案、入离职、组织、考勤、角色授权
## 域内地图 ## 子模块进度
> 子模块清单待定。预计启用子模块嵌套(单个 type 文件夹超 30 文件时按 UDAS 规则)。
| 子模块 | 一句话 | 深度地图 | 状态 |
|---|---|---|---|
| _(待规划)_ | _(待补)_ | _(待建)_ | 🚧 |
## 域内总图
![[knowledge-map]] ![[knowledge-map]]
[查看完整域知识地图(Gitea / GitHub 可点)](maps/knowledge-map.md)
## 跨域引用
本域常用以下跨域共享概念:
- [业户](../cross/concepts/resident.md)
- [员工](../cross/concepts/staff.md)
- [组织结构](../cross/concepts/org-hierarchy.md)
- [房屋单元](../cross/concepts/housing-unit.md)
- [工单](../cross/concepts/work-order.md)
- [门卡 / IC 卡](../cross/concepts/access-card.md)
- [通知](../cross/concepts/notification.md)
- [角色与权限](../cross/concepts/role-permission.md)
(按本域实际引用关系增删)
## 相关文档 ## 相关文档
- [[administrative · 知识地图]] - [administrative 域知识地图](maps/knowledge-map.md)
- [[domain-map|跨域索引]] - [顶层域索引](../maps/domain-map.md)
- [跨域协作地图](../cross/maps/cross-domain-map.md)

43
administrative/maps/knowledge-map.md
View File

@@ -12,42 +12,41 @@ owner: 待指定
last_review: 2026-05-25 last_review: 2026-05-25
--- ---
# administrative · 知识地图 # administrative · 域知识地图
> 行政人事 域的全部文档入口。待补充。 > 行政人事 域的全部子模块入口。待补充。
## 核心概念 ## 子模块
(待添加) | 子模块 | 中文 | 一句话 | 深度地图 | 状态 |
|---|---|---|---|---|
| _(待规划)_ | _(待规划)_ | _(待补)_ | _(待建)_ | 🚧 |
## 功能模块 子模块文件命名规则(参考 UDAS):英文 kebab-case,与代码 module 名对齐。
(待添加) ## 跨子模块概念
## 操作流程 (本域内多个子模块共享的概念,落在 `concepts/` 顶层,不在任何子模块文件夹里)
(待添加)
## 使用场景
(待添加) (待添加)
## 跨域引用 ## 跨域引用
本域常用以下跨域共享概念: 本域引用以下共享概念:
- [[业户]] - [业户](../../cross/concepts/resident.md)
- [[员工]] - [员工](../../cross/concepts/staff.md)
- [[组织结构]] - [组织结构](../../cross/concepts/org-hierarchy.md)
- [[房屋单元]] - [房屋单元](../../cross/concepts/housing-unit.md)
- [[工单]] - [工单](../../cross/concepts/work-order.md)
- [[门卡]] - [门卡](../../cross/concepts/access-card.md)
- [[通知]] - [通知](../../cross/concepts/notification.md)
- [[角色与权限]] - [角色与权限](../../cross/concepts/role-permission.md)
(按本域实际引用关系增删) (按本域实际引用关系增删)
## 相关文档 ## 相关文档
- [[administrative · 行政人事(域首页)|administrative 域首页]] - [administrative 域首页](../index.md)
- [[domain-map|跨域索引]] - [跨域协作地图](../../cross/maps/cross-domain-map.md)
- [顶层域索引](../../maps/domain-map.md)

32
community/index.md
View File

@@ -17,11 +17,37 @@ last_review: 2026-05-25
社区管家、活动、投诉、业主群 社区管家、活动、投诉、业主群
## 域内地图 ## 子模块进度
> 子模块清单待定。预计启用子模块嵌套(单个 type 文件夹超 30 文件时按 UDAS 规则)。
| 子模块 | 一句话 | 深度地图 | 状态 |
|---|---|---|---|
| _(待规划)_ | _(待补)_ | _(待建)_ | 🚧 |
## 域内总图
![[knowledge-map]] ![[knowledge-map]]
[查看完整域知识地图(Gitea / GitHub 可点)](maps/knowledge-map.md)
## 跨域引用
本域常用以下跨域共享概念:
- [业户](../cross/concepts/resident.md)
- [员工](../cross/concepts/staff.md)
- [组织结构](../cross/concepts/org-hierarchy.md)
- [房屋单元](../cross/concepts/housing-unit.md)
- [工单](../cross/concepts/work-order.md)
- [门卡 / IC 卡](../cross/concepts/access-card.md)
- [通知](../cross/concepts/notification.md)
- [角色与权限](../cross/concepts/role-permission.md)
(按本域实际引用关系增删)
## 相关文档 ## 相关文档
- [[community · 知识地图]] - [community 域知识地图](maps/knowledge-map.md)
- [[domain-map|跨域索引]] - [顶层域索引](../maps/domain-map.md)
- [跨域协作地图](../cross/maps/cross-domain-map.md)

43
community/maps/knowledge-map.md
View File

@@ -12,42 +12,41 @@ owner: 待指定
last_review: 2026-05-25 last_review: 2026-05-25
--- ---
# community · 知识地图 # community · 域知识地图
> 社区管理 域的全部文档入口。待补充。 > 社区管理 域的全部子模块入口。待补充。
## 核心概念 ## 子模块
(待添加) | 子模块 | 中文 | 一句话 | 深度地图 | 状态 |
|---|---|---|---|---|
| _(待规划)_ | _(待规划)_ | _(待补)_ | _(待建)_ | 🚧 |
## 功能模块 子模块文件命名规则(参考 UDAS):英文 kebab-case,与代码 module 名对齐。
(待添加) ## 跨子模块概念
## 操作流程 (本域内多个子模块共享的概念,落在 `concepts/` 顶层,不在任何子模块文件夹里)
(待添加)
## 使用场景
(待添加) (待添加)
## 跨域引用 ## 跨域引用
本域常用以下跨域共享概念: 本域引用以下共享概念:
- [[业户]] - [业户](../../cross/concepts/resident.md)
- [[员工]] - [员工](../../cross/concepts/staff.md)
- [[组织结构]] - [组织结构](../../cross/concepts/org-hierarchy.md)
- [[房屋单元]] - [房屋单元](../../cross/concepts/housing-unit.md)
- [[工单]] - [工单](../../cross/concepts/work-order.md)
- [[门卡]] - [门卡](../../cross/concepts/access-card.md)
- [[通知]] - [通知](../../cross/concepts/notification.md)
- [[角色与权限]] - [角色与权限](../../cross/concepts/role-permission.md)
(按本域实际引用关系增删) (按本域实际引用关系增删)
## 相关文档 ## 相关文档
- [[community · 社区管理(域首页)|community 域首页]] - [community 域首页](../index.md)
- [[domain-map|跨域索引]] - [跨域协作地图](../../cross/maps/cross-domain-map.md)
- [顶层域索引](../../maps/domain-map.md)

29
cross/index.md
View File

@@ -20,24 +20,27 @@ last_review: 2026-05-25
- **跨域编排场景**(`cross/scenarios/`) —— 涉及 2+ 域的业务流程(如"新业户入住"、"新员工入职") - **跨域编排场景**(`cross/scenarios/`) —— 涉及 2+ 域的业务流程(如"新业户入住"、"新员工入职")
- **跨域架构决策**(`cross/decisions/`) —— 影响多域的 ADR - **跨域架构决策**(`cross/decisions/`) —— 影响多域的 ADR
## 跨域共享概念 ## 8 个跨域共享概念(stub 已就位)
当前已就位 8 个 stub,内容待补: | 概念 | 文件 | 跨几个域 |
|---|---|---|
- [[业户]] — 跨 4 域(prop-acc / community / patrol / resident-portal) | 业户 (Resident) | [resident.md](concepts/resident.md) | 4(prop-acc / community / patrol / resident-portal) |
- [[员工]] — 跨 4 域(administrative / prop-acc / patrol / community) | 员工 (Staff) | [staff.md](concepts/staff.md) | 4(administrative / prop-acc / patrol / community) |
- [[组织结构]] — 全 5 域 | 组织结构 | [org-hierarchy.md](concepts/org-hierarchy.md) | 全 5 域 |
- [[房屋单元]] — 跨 4 域 | 房屋单元 | [housing-unit.md](concepts/housing-unit.md) | 4 |
- [[工单]] — 跨 3 域(patrol / community / resident-portal) | 工单 | [work-order.md](concepts/work-order.md) | 3 |
- [[门卡]] — 跨 3 域(prop-acc / resident-portal / patrol) | 门卡 / IC 卡 | [access-card.md](concepts/access-card.md) | 3 |
- [[通知]] — 全 5 域(基础设施) | 通知 | [notification.md](concepts/notification.md) | 全 5 域(基础设施) |
- [[角色与权限]] — 全 5 域(基础设施) | 角色与权限 | [role-permission.md](concepts/role-permission.md) | 全 5 域(基础设施) |
## 跨域地图 ## 跨域地图
![[cross-domain-map]] ![[cross-domain-map]]
[查看跨域协作地图(Gitea / GitHub 可点)](maps/cross-domain-map.md)
## 相关文档 ## 相关文档
- [[cross-domain-map|跨域协作地图]] - [跨域协作地图](maps/cross-domain-map.md)
- [[domain-map|业务域索引]] - [业务域索引](../maps/domain-map.md)
- [知识库首页](../index.md)

27
cross/maps/cross-domain-map.md
View File

@@ -14,20 +14,20 @@ last_review: 2026-05-25
# 跨域协作地图 # 跨域协作地图
> 跨业务域共享的概念、编排场景、决策的索引。本图按"对象 → 引用域"组织。 > 跨业务域共享的概念、编排场景、决策的索引。按"对象 → 引用域"组织。
## 共享对象(8 个跨域概念) ## 共享对象(8 个跨域概念)
| 概念 | 主域 | 引用域 | | 概念 | 主域 | 引用域 | 文件 |
|---|---|---| |---|---|---|---|
| [[业户]] | resident-portal | prop-acc, community, patrol | | 业户 | resident-portal | prop-acc, community, patrol | [resident.md](../concepts/resident.md) |
| [[员工]] | administrative | prop-acc, patrol, community | | 员工 | administrative | prop-acc, patrol, community | [staff.md](../concepts/staff.md) |
| [[组织结构]] | (基础设施) | 全 5 域 | | 组织结构 | (基础设施) | 全 5 域 | [org-hierarchy.md](../concepts/org-hierarchy.md) |
| [[房屋单元]] | community | prop-acc, resident-portal, patrol | | 房屋单元 | community | prop-acc, resident-portal, patrol | [housing-unit.md](../concepts/housing-unit.md) |
| [[工单]] | patrol | community, resident-portal | | 工单 | patrol | community, resident-portal | [work-order.md](../concepts/work-order.md) |
| [[门卡]] | prop-acc | resident-portal, patrol | | 门卡 | prop-acc | resident-portal, patrol | [access-card.md](../concepts/access-card.md) |
| [[通知]] | (基础设施) | 全 5 域 | | 通知 | (基础设施) | 全 5 域 | [notification.md](../concepts/notification.md) |
| [[角色与权限]] | administrative | 全 5 域 | | 角色与权限 | administrative | 全 5 域 | [role-permission.md](../concepts/role-permission.md) |
## 跨域编排场景(待添加) ## 跨域编排场景(待添加)
@@ -53,5 +53,6 @@ last_review: 2026-05-25
## 相关文档 ## 相关文档
- [[cross · 跨域协作(中心)]] - [cross 跨域协作中心](../index.md)
- [[domain-map|业务域索引]] - [业务域索引](../../maps/domain-map.md)
- [知识库首页](../../index.md)

35
index.md
View File

@@ -12,25 +12,38 @@ last_review: 2026-05-25
# Uniprop 知识库 # Uniprop 知识库
物业管理 SaaS 平台的多业务域知识库。 物业管理 SaaS 平台的多业务域知识库。按 UDAS v1.0(多域 + 子模块扩展)架构组织 —— 每个业务域独立一套 10 标准目录,跨域协作集中在 `cross/`。
按 [UDAS v1.0(多域扩展)](https://github.com/anthropics/) 架构组织 —— 每个业务域独立一套 10 标准目录,跨域协作集中在 `cross/`。 ## 业务域入口
## 业务域 | 域 | 中文 | 入口 | 状态 |
|---|---|---|---|
| prop-acc | 物业财务 | [prop-acc 域首页](prop-acc/index.md) | 一次性收费已完成 |
| community | 社区管理 | [community 域首页](community/index.md) | 🚧 |
| administrative | 行政人事 | [administrative 域首页](administrative/index.md) | 🚧 |
| patrol | 巡护工单 | [patrol 域首页](patrol/index.md) | 🚧 |
| resident-portal | 业户门户 | [resident-portal 域首页](resident-portal/index.md) | 🚧 |
| cross | 跨域协作 | [cross 协作中心](cross/index.md) | 8 个共享概念 stub |
## 顶层导航
- [业务域索引](maps/domain-map.md) — 6 域详情
- [跨域协作地图](cross/maps/cross-domain-map.md) — 共享概念 + 跨域编排
## Obsidian 内联视图
![[domain-map]] ![[domain-map]]
## 跨域协作 [查看完整域索引(Gitea / GitHub 可点)](maps/domain-map.md)
- [[cross-domain-map|跨域协作地图]] — 共享概念 + 跨域编排场景
- [[cross · 跨域协作(中心)|cross 协作中心]] — 8 个跨域共享概念入口
## 编辑约定 ## 编辑约定
- **新建文档**:先确定归属域(单域内容 → 该域;跨 2+ 域内容 → `cross/`),再选类型目录(concepts / scenarios / 等) - **新建文档**:先确定归属域(单域内容 → 该域;跨 2+ 域内容 → `cross/`),再选类型目录(concepts / scenarios / 等),最后判定是否启用子模块嵌套
- **文件命名**:英文 kebab-case,不带版本/日期后缀 - **文件命名**:英文 kebab-case,不带版本/日期后缀
- **frontmatter**:必含 `title`(域前缀 `<domain> · <名>`) / `tags` / `status`(中文枚举) - **frontmatter**:必含 `title`(域前缀 `<domain> · <名>`)、`tags`、`status`(中文枚举)
- **WikiLinks**:纯名称,禁止路径式 - **WikiLinks**:仅用于知识内容互引(concepts / scenarios / procedures / ...)
- **导航页**(任何 `index.md` / `maps/*.md`):用 Markdown 相对链接,确保 Gitea / GitHub 可点
- **跨域文档**:frontmatter 必须有 `involves: [域名]` - **跨域文档**:frontmatter 必须有 `involves: [域名]`
- **子模块文档**:frontmatter 必须有 `sub_feature: <name>`
详细规范见仓库 `README.md`(待补)或参考 UDAS 文档。 详细规范见仓库 `README.md`(待补)或 UDAS skill 文档。

31
maps/domain-map.md
View File

@@ -14,29 +14,20 @@ last_review: 2026-05-25
# 业务域索引 # 业务域索引
Uniprop 平台的全部业务域入口。每个域有自己独立的 10 类标准目录。 Uniprop 平台的全部业务域入口。每个域有自己独立的 10 类标准目录;大域(子模块 > 1 时)启用子模块嵌套。
## 域列表 ## 域列表
| 域 | 中文 | 入口 | 主要负责 | 状态 | | 域 | 中文 | 域首页 | 域知识地图 | 主要负责 | 状态 |
|---|---|---|---|---| |---|---|---|---|---|---|
| prop-acc | 物业财务 | [[prop-acc · 物业财务(域首页)\|prop-acc]] | 收费、票据、对账、账单、预存款 | 一次性收费子模块已完成 | | prop-acc | 物业财务 | [入口](../prop-acc/index.md) | [地图](../prop-acc/maps/knowledge-map.md) | 收费、票据、对账、账单、预存款 | adhoc 子模块已完成 |
| community | 社区管理 | [[community · 社区管理(域首页)\|community]] | 社区管家、活动、投诉、业主群 | 🚧 待补 | | community | 社区管理 | [入口](../community/index.md) | [地图](../community/maps/knowledge-map.md) | 社区管家、活动、投诉、业主群 | 🚧 待补 |
| administrative | 行政人事 | [[administrative · 行政人事(域首页)\|administrative]] | 员工档案、入离职、组织、考勤、角色授权 | 🚧 待补 | | administrative | 行政人事 | [入口](../administrative/index.md) | [地图](../administrative/maps/knowledge-map.md) | 员工档案、入离职、组织、考勤、角色授权 | 🚧 待补 |
| patrol | 巡护工单 | [[patrol · 巡护工单(域首页)\|patrol]] | 巡护任务、工单派发与处理、报修、值班 | 🚧 待补 | | patrol | 巡护工单 | [入口](../patrol/index.md) | [地图](../patrol/maps/knowledge-map.md) | 巡护任务、工单派发与处理、报修、值班 | 🚧 待补 |
| resident-portal | 业户门户 | [[resident-portal · 业户门户(域首页)\|resident-portal]] | 业户账号、自助服务、小程序、消息中心 | 🚧 待补 | | resident-portal | 业户门户 | [入口](../resident-portal/index.md) | [地图](../resident-portal/maps/knowledge-map.md) | 业户账号、自助服务、小程序、消息中心 | 🚧 待补 |
| cross | 跨域协作 | [[cross · 跨域协作(中心)\|cross]] | 8 个共享概念 + 跨域编排场景 | stub 已就位 | | cross | 跨域协作 | [入口](../cross/index.md) | [地图](../cross/maps/cross-domain-map.md) | 8 个共享概念 + 跨域编排场景 | stub 已就位 |
## 域内地图入口(快速跳转)
- [[prop-acc · 知识地图]]
- [[community · 知识地图]]
- [[administrative · 知识地图]]
- [[patrol · 知识地图]]
- [[resident-portal · 知识地图]]
- [[cross-domain-map|跨域协作地图]]
## 相关文档 ## 相关文档
- [[Uniprop 知识库]] - [知识库首页](../index.md)
- [[cross · 跨域协作(中心)]] - [跨域协作地图](../cross/maps/cross-domain-map.md)

32
patrol/index.md
View File

@@ -17,11 +17,37 @@ last_review: 2026-05-25
巡护任务、工单派发与处理、报修、值班 巡护任务、工单派发与处理、报修、值班
## 域内地图 ## 子模块进度
> 子模块清单待定。预计启用子模块嵌套(单个 type 文件夹超 30 文件时按 UDAS 规则)。
| 子模块 | 一句话 | 深度地图 | 状态 |
|---|---|---|---|
| _(待规划)_ | _(待补)_ | _(待建)_ | 🚧 |
## 域内总图
![[knowledge-map]] ![[knowledge-map]]
[查看完整域知识地图(Gitea / GitHub 可点)](maps/knowledge-map.md)
## 跨域引用
本域常用以下跨域共享概念:
- [业户](../cross/concepts/resident.md)
- [员工](../cross/concepts/staff.md)
- [组织结构](../cross/concepts/org-hierarchy.md)
- [房屋单元](../cross/concepts/housing-unit.md)
- [工单](../cross/concepts/work-order.md)
- [门卡 / IC 卡](../cross/concepts/access-card.md)
- [通知](../cross/concepts/notification.md)
- [角色与权限](../cross/concepts/role-permission.md)
(按本域实际引用关系增删)
## 相关文档 ## 相关文档
- [[patrol · 知识地图]] - [patrol 域知识地图](maps/knowledge-map.md)
- [[domain-map|跨域索引]] - [顶层域索引](../maps/domain-map.md)
- [跨域协作地图](../cross/maps/cross-domain-map.md)

43
patrol/maps/knowledge-map.md
View File

@@ -12,42 +12,41 @@ owner: 待指定
last_review: 2026-05-25 last_review: 2026-05-25
--- ---
# patrol · 知识地图 # patrol · 域知识地图
> 巡护工单 域的全部文档入口。待补充。 > 巡护工单 域的全部子模块入口。待补充。
## 核心概念 ## 子模块
(待添加) | 子模块 | 中文 | 一句话 | 深度地图 | 状态 |
|---|---|---|---|---|
| _(待规划)_ | _(待规划)_ | _(待补)_ | _(待建)_ | 🚧 |
## 功能模块 子模块文件命名规则(参考 UDAS):英文 kebab-case,与代码 module 名对齐。
(待添加) ## 跨子模块概念
## 操作流程 (本域内多个子模块共享的概念,落在 `concepts/` 顶层,不在任何子模块文件夹里)
(待添加)
## 使用场景
(待添加) (待添加)
## 跨域引用 ## 跨域引用
本域常用以下跨域共享概念: 本域引用以下共享概念:
- [[业户]] - [业户](../../cross/concepts/resident.md)
- [[员工]] - [员工](../../cross/concepts/staff.md)
- [[组织结构]] - [组织结构](../../cross/concepts/org-hierarchy.md)
- [[房屋单元]] - [房屋单元](../../cross/concepts/housing-unit.md)
- [[工单]] - [工单](../../cross/concepts/work-order.md)
- [[门卡]] - [门卡](../../cross/concepts/access-card.md)
- [[通知]] - [通知](../../cross/concepts/notification.md)
- [[角色与权限]] - [角色与权限](../../cross/concepts/role-permission.md)
(按本域实际引用关系增删) (按本域实际引用关系增删)
## 相关文档 ## 相关文档
- [[patrol · 巡护工单(域首页)|patrol 域首页]] - [patrol 域首页](../index.md)
- [[domain-map|跨域索引]] - [跨域协作地图](../../cross/maps/cross-domain-map.md)
- [顶层域索引](../../maps/domain-map.md)

36
prop-acc/index.md
View File

@@ -19,26 +19,28 @@ last_review: 2026-05-25
物业财务系统,管业户的各种收费、押金、预存款,自动出账单、收款、生成收据。 物业财务系统,管业户的各种收费、押金、预存款,自动出账单、收款、生成收据。
## 域内地图 ## 七大子模块进度
| 子模块 | 一句话 | 深度地图 | 状态 |
|---|---|---|---|
| **一次性收费** | IC 卡、装修证、泳票等单次购买 | [adhoc 知识地图](maps/adhoc-knowledge-map.md) | ✅ 28 篇 |
| **保证金** | 装修押金等代管资金,完工后退还 | _待补_ | 🚧 |
| **预存款** | 业户预存,自动抵扣月度账单 | _待补_ | 🚧 |
| **计量表** | 水表/电表/燃气表,抄表生成账单 | _待补_ | 🚧 |
| **账单** | 周期性账单 + 计量账单 | _待补_ | 🚧 |
| **收款订单** | 一次收款的支付方式、银行账户记录 | _待补_ | 🚧 |
| **收据** | 成功收款后生成的凭证 | _待补_ | 🚧 |
## 域内总图
![[knowledge-map]] ![[knowledge-map]]
## 七大子模块进度 [查看完整域知识地图(Gitea / GitHub 可点)](maps/knowledge-map.md)
| 子模块 | 一句话 | 状态 |
|---|---|---|
| **一次性收费** | IC 卡、装修证、泳票等单次购买 | ✅ 已完成(见域内地图) |
| **保证金** | 装修押金等代管资金,完工后退还 | _待补_ |
| **预存款** | 业户预存,自动抵扣月度账单 | _待补_ |
| **计量表** | 水表/电表/燃气表,抄表生成账单 | _待补_ |
| **账单** | 周期性账单 + 计量账单 | _待补_ |
| **收款订单** | 一次收款的支付方式、银行账户记录 | _待补_ |
| **收据** | 成功收款后生成的凭证 | _待补_ |
## 你是谁? ## 你是谁?
> [!tip] 业户(物业的客户) > [!tip] 业户(物业的客户)
> 关心"我怎么买/缴/取/退",看[[概念-A流与B流|A 流与 B 流]]最直观。 > 关心"我怎么买/缴/取/退",看 [flow-a-vs-flow-b](concepts/adhoc/flow-a-vs-flow-b.md) 最直观。
> [!tip] 业务人员(物业职员、财务) > [!tip] 业务人员(物业职员、财务)
> 关心"前台怎么操作、出问题怎么救",每个场景都有"业务人员视角"段落。 > 关心"前台怎么操作、出问题怎么救",每个场景都有"业务人员视角"段落。
@@ -47,10 +49,12 @@ last_review: 2026-05-25
- **业户口语**:称"您",场景里描述真实生活情境 - **业户口语**:称"您",场景里描述真实生活情境
- **mermaid 流程图**:每个场景配一张,直观看完整链路 - **mermaid 流程图**:每个场景配一张,直观看完整链路
- **WikiLinks**:`[[XX]]` 是 vault 内部跳转,点击直达 - **WikiLinks**:`[[XX]]` 是 vault 内部跳转(仅 Obsidian / Quartz 渲染);Gitea / GitHub 看导航请走表格里的 Markdown 链接
- **callouts**:`tip` / `warning` / `example` 标注重点 - **callouts**:`tip` / `warning` / `example` 标注重点
## 相关文档 ## 相关文档
- [[prop-acc · 知识地图]] - [prop-acc · 域知识地图](maps/knowledge-map.md)
- [[domain-map|跨域索引]] - [adhoc 子模块知识地图](maps/adhoc-knowledge-map.md)
- [顶层域索引](../maps/domain-map.md)
- [跨域协作地图](../cross/maps/cross-domain-map.md)

48
prop-acc/maps/knowledge-map.md Normal file
View File

@@ -0,0 +1,48 @@
---
title: prop-acc · 知识地图
aliases:
- prop-acc 知识地图
- 物业财务知识地图
tags:
- 规范
- prop-acc
- 知识地图
status: 已发布
last_review: 2026-05-25
---
# prop-acc · 域知识地图
物业财务域的全部子模块入口。每个子模块对应一张深度地图。
## 7 子模块
| 子模块 | 中文 | 一句话 | 深度地图 | 状态 |
|---|---|---|---|---|
| adhoc | 一次性收费 | IC 卡、装修证、泳票等单次购买 | [adhoc 知识地图](adhoc-knowledge-map.md) | ✅ 25 场景 + 3 概念 |
| prepaid | 预存款 | 业户预存,自动抵扣月度账单 | _待补_ | 🚧 |
| deposit | 保证金 | 装修押金等代管资金,完工后退还 | _待补_ | 🚧 |
| meter | 计量表 | 水表/电表/燃气表,抄表生成账单 | _待补_ | 🚧 |
| billing | 账单 | 周期性账单 + 计量账单 | _待补_ | 🚧 |
| payment-order | 收款订单 | 一次收款的支付方式、银行账户记录 | _待补_ | 🚧 |
| receipt | 收据 | 成功收款后生成的凭证 | _待补_ | 🚧 |
## 跨子模块概念
(本域内多个子模块共享的概念,落在 `concepts/` 顶层,不在任何子模块文件夹里)
(待添加)
## 跨域引用
本域引用以下共享概念:
- [业户](../../cross/concepts/resident.md)
- [门卡 / IC 卡](../../cross/concepts/access-card.md)
- [房屋单元](../../cross/concepts/housing-unit.md)
## 相关文档
- [prop-acc 域首页](../index.md)
- [跨域协作地图](../../cross/maps/cross-domain-map.md)
- [顶层域索引](../../maps/domain-map.md)

32
resident-portal/index.md
View File

@@ -17,11 +17,37 @@ last_review: 2026-05-25
业户账号、自助服务、小程序、消息中心 业户账号、自助服务、小程序、消息中心
## 域内地图 ## 子模块进度
> 子模块清单待定。预计启用子模块嵌套(单个 type 文件夹超 30 文件时按 UDAS 规则)。
| 子模块 | 一句话 | 深度地图 | 状态 |
|---|---|---|---|
| _(待规划)_ | _(待补)_ | _(待建)_ | 🚧 |
## 域内总图
![[knowledge-map]] ![[knowledge-map]]
[查看完整域知识地图(Gitea / GitHub 可点)](maps/knowledge-map.md)
## 跨域引用
本域常用以下跨域共享概念:
- [业户](../cross/concepts/resident.md)
- [员工](../cross/concepts/staff.md)
- [组织结构](../cross/concepts/org-hierarchy.md)
- [房屋单元](../cross/concepts/housing-unit.md)
- [工单](../cross/concepts/work-order.md)
- [门卡 / IC 卡](../cross/concepts/access-card.md)
- [通知](../cross/concepts/notification.md)
- [角色与权限](../cross/concepts/role-permission.md)
(按本域实际引用关系增删)
## 相关文档 ## 相关文档
- [[resident-portal · 知识地图]] - [resident-portal 域知识地图](maps/knowledge-map.md)
- [[domain-map|跨域索引]] - [顶层域索引](../maps/domain-map.md)
- [跨域协作地图](../cross/maps/cross-domain-map.md)

43
resident-portal/maps/knowledge-map.md
View File

@@ -12,42 +12,41 @@ owner: 待指定
last_review: 2026-05-25 last_review: 2026-05-25
--- ---
# resident-portal · 知识地图 # resident-portal · 域知识地图
> 业户门户 域的全部文档入口。待补充。 > 业户门户 域的全部子模块入口。待补充。
## 核心概念 ## 子模块
(待添加) | 子模块 | 中文 | 一句话 | 深度地图 | 状态 |
|---|---|---|---|---|
| _(待规划)_ | _(待规划)_ | _(待补)_ | _(待建)_ | 🚧 |
## 功能模块 子模块文件命名规则(参考 UDAS):英文 kebab-case,与代码 module 名对齐。
(待添加) ## 跨子模块概念
## 操作流程 (本域内多个子模块共享的概念,落在 `concepts/` 顶层,不在任何子模块文件夹里)
(待添加)
## 使用场景
(待添加) (待添加)
## 跨域引用 ## 跨域引用
本域常用以下跨域共享概念: 本域引用以下共享概念:
- [[业户]] - [业户](../../cross/concepts/resident.md)
- [[员工]] - [员工](../../cross/concepts/staff.md)
- [[组织结构]] - [组织结构](../../cross/concepts/org-hierarchy.md)
- [[房屋单元]] - [房屋单元](../../cross/concepts/housing-unit.md)
- [[工单]] - [工单](../../cross/concepts/work-order.md)
- [[门卡]] - [门卡](../../cross/concepts/access-card.md)
- [[通知]] - [通知](../../cross/concepts/notification.md)
- [[角色与权限]] - [角色与权限](../../cross/concepts/role-permission.md)
(按本域实际引用关系增删) (按本域实际引用关系增删)
## 相关文档 ## 相关文档
- [[resident-portal · 业户门户(域首页)|resident-portal 域首页]] - [resident-portal 域首页](../index.md)
- [[domain-map|跨域索引]] - [跨域协作地图](../../cross/maps/cross-domain-map.md)
- [顶层域索引](../../maps/domain-map.md)