From 83b4e0277ca75368ca14794bd7aa8bd15a347097 Mon Sep 17 00:00:00 2001 From: Willie Date: Mon, 25 May 2026 21:46:28 +0800 Subject: [PATCH] =?UTF-8?q?nav:=20=E5=AF=BC=E8=88=AA=E9=A1=B5=E5=85=A8?= =?UTF-8?q?=E9=83=A8=E6=94=B9=E7=94=A8=20Markdown=20=E7=9B=B8=E5=AF=B9?= =?UTF-8?q?=E9=93=BE=E6=8E=A5(Gitea=20/=20GitHub=20=E5=8F=AF=E7=82=B9?= =?UTF-8?q?=E5=87=BB)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 问题: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) --- administrative/index.md | 32 ++++++++++++++++-- administrative/maps/knowledge-map.md | 43 ++++++++++++------------ community/index.md | 32 ++++++++++++++++-- community/maps/knowledge-map.md | 43 ++++++++++++------------ cross/index.md | 29 ++++++++-------- cross/maps/cross-domain-map.md | 27 +++++++-------- index.md | 35 +++++++++++++------ maps/domain-map.md | 31 ++++++----------- patrol/index.md | 32 ++++++++++++++++-- patrol/maps/knowledge-map.md | 43 ++++++++++++------------ prop-acc/index.md | 36 +++++++++++--------- prop-acc/maps/knowledge-map.md | 48 +++++++++++++++++++++++++++ resident-portal/index.md | 32 ++++++++++++++++-- resident-portal/maps/knowledge-map.md | 43 ++++++++++++------------ 14 files changed, 333 insertions(+), 173 deletions(-) create mode 100644 prop-acc/maps/knowledge-map.md diff --git a/administrative/index.md b/administrative/index.md index e9e6b68..7b609a8 100644 --- a/administrative/index.md +++ b/administrative/index.md @@ -17,11 +17,37 @@ last_review: 2026-05-25 员工档案、入离职、组织、考勤、角色授权 -## 域内地图 +## 子模块进度 + +> 子模块清单待定。预计启用子模块嵌套(单个 type 文件夹超 30 文件时按 UDAS 规则)。 + +| 子模块 | 一句话 | 深度地图 | 状态 | +|---|---|---|---| +| _(待规划)_ | _(待补)_ | _(待建)_ | 🚧 | + +## 域内总图 ![[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 · 知识地图]] -- [[domain-map|跨域索引]] +- [administrative 域知识地图](maps/knowledge-map.md) +- [顶层域索引](../maps/domain-map.md) +- [跨域协作地图](../cross/maps/cross-domain-map.md) diff --git a/administrative/maps/knowledge-map.md b/administrative/maps/knowledge-map.md index b15c383..c68d77b 100644 --- a/administrative/maps/knowledge-map.md +++ b/administrative/maps/knowledge-map.md @@ -12,42 +12,41 @@ owner: 待指定 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 域首页]] -- [[domain-map|跨域索引]] +- [administrative 域首页](../index.md) +- [跨域协作地图](../../cross/maps/cross-domain-map.md) +- [顶层域索引](../../maps/domain-map.md) diff --git a/community/index.md b/community/index.md index 46b16f0..fee3c73 100644 --- a/community/index.md +++ b/community/index.md @@ -17,11 +17,37 @@ last_review: 2026-05-25 社区管家、活动、投诉、业主群 -## 域内地图 +## 子模块进度 + +> 子模块清单待定。预计启用子模块嵌套(单个 type 文件夹超 30 文件时按 UDAS 规则)。 + +| 子模块 | 一句话 | 深度地图 | 状态 | +|---|---|---|---| +| _(待规划)_ | _(待补)_ | _(待建)_ | 🚧 | + +## 域内总图 ![[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 · 知识地图]] -- [[domain-map|跨域索引]] +- [community 域知识地图](maps/knowledge-map.md) +- [顶层域索引](../maps/domain-map.md) +- [跨域协作地图](../cross/maps/cross-domain-map.md) diff --git a/community/maps/knowledge-map.md b/community/maps/knowledge-map.md index 20c5235..42834e6 100644 --- a/community/maps/knowledge-map.md +++ b/community/maps/knowledge-map.md @@ -12,42 +12,41 @@ owner: 待指定 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 域首页]] -- [[domain-map|跨域索引]] +- [community 域首页](../index.md) +- [跨域协作地图](../../cross/maps/cross-domain-map.md) +- [顶层域索引](../../maps/domain-map.md) diff --git a/cross/index.md b/cross/index.md index 98dc475..59c2cec 100644 --- a/cross/index.md +++ b/cross/index.md @@ -20,24 +20,27 @@ last_review: 2026-05-25 - **跨域编排场景**(`cross/scenarios/`) —— 涉及 2+ 域的业务流程(如"新业户入住"、"新员工入职") - **跨域架构决策**(`cross/decisions/`) —— 影响多域的 ADR -## 跨域共享概念 +## 8 个跨域共享概念(stub 已就位) -当前已就位 8 个 stub,内容待补: - -- [[业户]] — 跨 4 域(prop-acc / community / patrol / resident-portal) -- [[员工]] — 跨 4 域(administrative / prop-acc / patrol / community) -- [[组织结构]] — 全 5 域 -- [[房屋单元]] — 跨 4 域 -- [[工单]] — 跨 3 域(patrol / community / resident-portal) -- [[门卡]] — 跨 3 域(prop-acc / resident-portal / patrol) -- [[通知]] — 全 5 域(基础设施) -- [[角色与权限]] — 全 5 域(基础设施) +| 概念 | 文件 | 跨几个域 | +|---|---|---| +| 业户 (Resident) | [resident.md](concepts/resident.md) | 4(prop-acc / community / patrol / resident-portal) | +| 员工 (Staff) | [staff.md](concepts/staff.md) | 4(administrative / prop-acc / patrol / community) | +| 组织结构 | [org-hierarchy.md](concepts/org-hierarchy.md) | 全 5 域 | +| 房屋单元 | [housing-unit.md](concepts/housing-unit.md) | 4 | +| 工单 | [work-order.md](concepts/work-order.md) | 3 | +| 门卡 / IC 卡 | [access-card.md](concepts/access-card.md) | 3 | +| 通知 | [notification.md](concepts/notification.md) | 全 5 域(基础设施) | +| 角色与权限 | [role-permission.md](concepts/role-permission.md) | 全 5 域(基础设施) | ## 跨域地图 ![[cross-domain-map]] +[查看跨域协作地图(Gitea / GitHub 可点)](maps/cross-domain-map.md) + ## 相关文档 -- [[cross-domain-map|跨域协作地图]] -- [[domain-map|业务域索引]] +- [跨域协作地图](maps/cross-domain-map.md) +- [业务域索引](../maps/domain-map.md) +- [知识库首页](../index.md) diff --git a/cross/maps/cross-domain-map.md b/cross/maps/cross-domain-map.md index c93eba2..feb070b 100644 --- a/cross/maps/cross-domain-map.md +++ b/cross/maps/cross-domain-map.md @@ -14,20 +14,20 @@ last_review: 2026-05-25 # 跨域协作地图 -> 跨业务域共享的概念、编排场景、决策的索引。本图按"对象 → 引用域"组织。 +> 跨业务域共享的概念、编排场景、决策的索引。按"对象 → 引用域"组织。 ## 共享对象(8 个跨域概念) -| 概念 | 主域 | 引用域 | -|---|---|---| -| [[业户]] | resident-portal | prop-acc, community, patrol | -| [[员工]] | administrative | prop-acc, patrol, community | -| [[组织结构]] | (基础设施) | 全 5 域 | -| [[房屋单元]] | community | prop-acc, resident-portal, patrol | -| [[工单]] | patrol | community, resident-portal | -| [[门卡]] | prop-acc | resident-portal, patrol | -| [[通知]] | (基础设施) | 全 5 域 | -| [[角色与权限]] | administrative | 全 5 域 | +| 概念 | 主域 | 引用域 | 文件 | +|---|---|---|---| +| 业户 | resident-portal | prop-acc, community, patrol | [resident.md](../concepts/resident.md) | +| 员工 | administrative | prop-acc, patrol, community | [staff.md](../concepts/staff.md) | +| 组织结构 | (基础设施) | 全 5 域 | [org-hierarchy.md](../concepts/org-hierarchy.md) | +| 房屋单元 | community | prop-acc, resident-portal, patrol | [housing-unit.md](../concepts/housing-unit.md) | +| 工单 | patrol | community, resident-portal | [work-order.md](../concepts/work-order.md) | +| 门卡 | prop-acc | resident-portal, patrol | [access-card.md](../concepts/access-card.md) | +| 通知 | (基础设施) | 全 5 域 | [notification.md](../concepts/notification.md) | +| 角色与权限 | administrative | 全 5 域 | [role-permission.md](../concepts/role-permission.md) | ## 跨域编排场景(待添加) @@ -53,5 +53,6 @@ last_review: 2026-05-25 ## 相关文档 -- [[cross · 跨域协作(中心)]] -- [[domain-map|业务域索引]] +- [cross 跨域协作中心](../index.md) +- [业务域索引](../../maps/domain-map.md) +- [知识库首页](../../index.md) diff --git a/index.md b/index.md index 9443b8e..e286189 100644 --- a/index.md +++ b/index.md @@ -12,25 +12,38 @@ last_review: 2026-05-25 # 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]] -## 跨域协作 - -- [[cross-domain-map|跨域协作地图]] — 共享概念 + 跨域编排场景 -- [[cross · 跨域协作(中心)|cross 协作中心]] — 8 个跨域共享概念入口 +[查看完整域索引(Gitea / GitHub 可点)](maps/domain-map.md) ## 编辑约定 -- **新建文档**:先确定归属域(单域内容 → 该域;跨 2+ 域内容 → `cross/`),再选类型目录(concepts / scenarios / 等) +- **新建文档**:先确定归属域(单域内容 → 该域;跨 2+ 域内容 → `cross/`),再选类型目录(concepts / scenarios / 等),最后判定是否启用子模块嵌套 - **文件命名**:英文 kebab-case,不带版本/日期后缀 -- **frontmatter**:必含 `title`(域前缀 ` · <名>`) / `tags` / `status`(中文枚举) -- **WikiLinks**:纯名称,禁止路径式 +- **frontmatter**:必含 `title`(域前缀 ` · <名>`)、`tags`、`status`(中文枚举) +- **WikiLinks**:仅用于知识内容互引(concepts / scenarios / procedures / ...) +- **导航页**(任何 `index.md` / `maps/*.md`):用 Markdown 相对链接,确保 Gitea / GitHub 可点 - **跨域文档**:frontmatter 必须有 `involves: [域名]` +- **子模块文档**:frontmatter 必须有 `sub_feature: ` -详细规范见仓库 `README.md`(待补)或参考 UDAS 文档。 +详细规范见仓库 `README.md`(待补)或 UDAS skill 文档。 diff --git a/maps/domain-map.md b/maps/domain-map.md index 5b87b3f..bd52941 100644 --- a/maps/domain-map.md +++ b/maps/domain-map.md @@ -14,29 +14,20 @@ last_review: 2026-05-25 # 业务域索引 -Uniprop 平台的全部业务域入口。每个域有自己独立的 10 类标准目录。 +Uniprop 平台的全部业务域入口。每个域有自己独立的 10 类标准目录;大域(子模块 > 1 时)启用子模块嵌套。 ## 域列表 -| 域 | 中文 | 入口 | 主要负责 | 状态 | -|---|---|---|---|---| -| prop-acc | 物业财务 | [[prop-acc · 物业财务(域首页)\|prop-acc]] | 收费、票据、对账、账单、预存款 | 一次性收费子模块已完成 | -| community | 社区管理 | [[community · 社区管理(域首页)\|community]] | 社区管家、活动、投诉、业主群 | 🚧 待补 | -| administrative | 行政人事 | [[administrative · 行政人事(域首页)\|administrative]] | 员工档案、入离职、组织、考勤、角色授权 | 🚧 待补 | -| patrol | 巡护工单 | [[patrol · 巡护工单(域首页)\|patrol]] | 巡护任务、工单派发与处理、报修、值班 | 🚧 待补 | -| resident-portal | 业户门户 | [[resident-portal · 业户门户(域首页)\|resident-portal]] | 业户账号、自助服务、小程序、消息中心 | 🚧 待补 | -| cross | 跨域协作 | [[cross · 跨域协作(中心)\|cross]] | 8 个共享概念 + 跨域编排场景 | stub 已就位 | - -## 域内地图入口(快速跳转) - -- [[prop-acc · 知识地图]] -- [[community · 知识地图]] -- [[administrative · 知识地图]] -- [[patrol · 知识地图]] -- [[resident-portal · 知识地图]] -- [[cross-domain-map|跨域协作地图]] +| 域 | 中文 | 域首页 | 域知识地图 | 主要负责 | 状态 | +|---|---|---|---|---|---| +| prop-acc | 物业财务 | [入口](../prop-acc/index.md) | [地图](../prop-acc/maps/knowledge-map.md) | 收费、票据、对账、账单、预存款 | adhoc 子模块已完成 | +| community | 社区管理 | [入口](../community/index.md) | [地图](../community/maps/knowledge-map.md) | 社区管家、活动、投诉、业主群 | 🚧 待补 | +| administrative | 行政人事 | [入口](../administrative/index.md) | [地图](../administrative/maps/knowledge-map.md) | 员工档案、入离职、组织、考勤、角色授权 | 🚧 待补 | +| patrol | 巡护工单 | [入口](../patrol/index.md) | [地图](../patrol/maps/knowledge-map.md) | 巡护任务、工单派发与处理、报修、值班 | 🚧 待补 | +| resident-portal | 业户门户 | [入口](../resident-portal/index.md) | [地图](../resident-portal/maps/knowledge-map.md) | 业户账号、自助服务、小程序、消息中心 | 🚧 待补 | +| cross | 跨域协作 | [入口](../cross/index.md) | [地图](../cross/maps/cross-domain-map.md) | 8 个共享概念 + 跨域编排场景 | stub 已就位 | ## 相关文档 -- [[Uniprop 知识库]] -- [[cross · 跨域协作(中心)]] +- [知识库首页](../index.md) +- [跨域协作地图](../cross/maps/cross-domain-map.md) diff --git a/patrol/index.md b/patrol/index.md index acaa06e..4bd8cae 100644 --- a/patrol/index.md +++ b/patrol/index.md @@ -17,11 +17,37 @@ last_review: 2026-05-25 巡护任务、工单派发与处理、报修、值班 -## 域内地图 +## 子模块进度 + +> 子模块清单待定。预计启用子模块嵌套(单个 type 文件夹超 30 文件时按 UDAS 规则)。 + +| 子模块 | 一句话 | 深度地图 | 状态 | +|---|---|---|---| +| _(待规划)_ | _(待补)_ | _(待建)_ | 🚧 | + +## 域内总图 ![[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 · 知识地图]] -- [[domain-map|跨域索引]] +- [patrol 域知识地图](maps/knowledge-map.md) +- [顶层域索引](../maps/domain-map.md) +- [跨域协作地图](../cross/maps/cross-domain-map.md) diff --git a/patrol/maps/knowledge-map.md b/patrol/maps/knowledge-map.md index 7c4fa9a..3d4dbbb 100644 --- a/patrol/maps/knowledge-map.md +++ b/patrol/maps/knowledge-map.md @@ -12,42 +12,41 @@ owner: 待指定 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 域首页]] -- [[domain-map|跨域索引]] +- [patrol 域首页](../index.md) +- [跨域协作地图](../../cross/maps/cross-domain-map.md) +- [顶层域索引](../../maps/domain-map.md) diff --git a/prop-acc/index.md b/prop-acc/index.md index d824e07..2d3e27f 100644 --- a/prop-acc/index.md +++ b/prop-acc/index.md @@ -19,26 +19,28 @@ last_review: 2026-05-25 物业财务系统,管业户的各种收费、押金、预存款,自动出账单、收款、生成收据。 -## 域内地图 +## 七大子模块进度 + +| 子模块 | 一句话 | 深度地图 | 状态 | +|---|---|---|---| +| **一次性收费** | IC 卡、装修证、泳票等单次购买 | [adhoc 知识地图](maps/adhoc-knowledge-map.md) | ✅ 28 篇 | +| **保证金** | 装修押金等代管资金,完工后退还 | _待补_ | 🚧 | +| **预存款** | 业户预存,自动抵扣月度账单 | _待补_ | 🚧 | +| **计量表** | 水表/电表/燃气表,抄表生成账单 | _待补_ | 🚧 | +| **账单** | 周期性账单 + 计量账单 | _待补_ | 🚧 | +| **收款订单** | 一次收款的支付方式、银行账户记录 | _待补_ | 🚧 | +| **收据** | 成功收款后生成的凭证 | _待补_ | 🚧 | + +## 域内总图 ![[knowledge-map]] -## 七大子模块进度 - -| 子模块 | 一句话 | 状态 | -|---|---|---| -| **一次性收费** | IC 卡、装修证、泳票等单次购买 | ✅ 已完成(见域内地图) | -| **保证金** | 装修押金等代管资金,完工后退还 | _待补_ | -| **预存款** | 业户预存,自动抵扣月度账单 | _待补_ | -| **计量表** | 水表/电表/燃气表,抄表生成账单 | _待补_ | -| **账单** | 周期性账单 + 计量账单 | _待补_ | -| **收款订单** | 一次收款的支付方式、银行账户记录 | _待补_ | -| **收据** | 成功收款后生成的凭证 | _待补_ | +[查看完整域知识地图(Gitea / GitHub 可点)](maps/knowledge-map.md) ## 你是谁? > [!tip] 业户(物业的客户) -> 关心"我怎么买/缴/取/退",看[[概念-A流与B流|A 流与 B 流]]最直观。 +> 关心"我怎么买/缴/取/退",看 [flow-a-vs-flow-b](concepts/adhoc/flow-a-vs-flow-b.md) 最直观。 > [!tip] 业务人员(物业职员、财务) > 关心"前台怎么操作、出问题怎么救",每个场景都有"业务人员视角"段落。 @@ -47,10 +49,12 @@ last_review: 2026-05-25 - **业户口语**:称"您",场景里描述真实生活情境 - **mermaid 流程图**:每个场景配一张,直观看完整链路 -- **WikiLinks**:`[[XX]]` 是 vault 内部跳转,点击直达 +- **WikiLinks**:`[[XX]]` 是 vault 内部跳转(仅 Obsidian / Quartz 渲染);Gitea / GitHub 看导航请走表格里的 Markdown 链接 - **callouts**:`tip` / `warning` / `example` 标注重点 ## 相关文档 -- [[prop-acc · 知识地图]] -- [[domain-map|跨域索引]] +- [prop-acc · 域知识地图](maps/knowledge-map.md) +- [adhoc 子模块知识地图](maps/adhoc-knowledge-map.md) +- [顶层域索引](../maps/domain-map.md) +- [跨域协作地图](../cross/maps/cross-domain-map.md) diff --git a/prop-acc/maps/knowledge-map.md b/prop-acc/maps/knowledge-map.md new file mode 100644 index 0000000..e91a6d4 --- /dev/null +++ b/prop-acc/maps/knowledge-map.md @@ -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) diff --git a/resident-portal/index.md b/resident-portal/index.md index d4f3587..e92ede4 100644 --- a/resident-portal/index.md +++ b/resident-portal/index.md @@ -17,11 +17,37 @@ last_review: 2026-05-25 业户账号、自助服务、小程序、消息中心 -## 域内地图 +## 子模块进度 + +> 子模块清单待定。预计启用子模块嵌套(单个 type 文件夹超 30 文件时按 UDAS 规则)。 + +| 子模块 | 一句话 | 深度地图 | 状态 | +|---|---|---|---| +| _(待规划)_ | _(待补)_ | _(待建)_ | 🚧 | + +## 域内总图 ![[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 · 知识地图]] -- [[domain-map|跨域索引]] +- [resident-portal 域知识地图](maps/knowledge-map.md) +- [顶层域索引](../maps/domain-map.md) +- [跨域协作地图](../cross/maps/cross-domain-map.md) diff --git a/resident-portal/maps/knowledge-map.md b/resident-portal/maps/knowledge-map.md index 3d2374f..c443481 100644 --- a/resident-portal/maps/knowledge-map.md +++ b/resident-portal/maps/knowledge-map.md @@ -12,42 +12,41 @@ owner: 待指定 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 域首页]] -- [[domain-map|跨域索引]] +- [resident-portal 域首页](../index.md) +- [跨域协作地图](../../cross/maps/cross-domain-map.md) +- [顶层域索引](../../maps/domain-map.md)