Vault/uniprop-manual
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
32 Commits 1 Branch 0 Tags
9e90229cf59c327dda6621b5f81581c703163668
Commit Graph

32 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
Willie
9e90229cf5 vault backup: 2026-05-25 22:42:44 2026-05-25 22:42:44 +08:00
Willie
a98bdaf98e deposit 子模块 · 轮 2:18 场景 + 知识地图收尾 
写 18 个场景到 prop-acc/scenarios/deposit/,覆盖 7 类业务:

📥 缴纳(3):
- deposit-first-time-renovation(张阿姨首次缴 5000)
- deposit-additional-topup(陈先生追加 2000)
- deposit-on-behalf-by-company(王装修代 3 户业主缴 15000)

💰 退款(3):
- refund-full-no-damage(无损全退)
- refund-partial-after-forfeit(扣 800 退 4200)
- refund-with-payment-channel-switch(现金缴 → 银行转账退)

⚠️ 扣罚(2):
- forfeit-damage-public-area(墙面损坏扣 800)
- forfeit-violation-no-permit(未报备私自动工违约扣 3000)

🧊 冻结/解冻(2):
- freeze-during-dispute(纠纷期间冻结)
- unfreeze-after-mediation(调解后解冻)

🔒 结清(2):
- close-after-zero-balance(余额清零自动 Closed)
- close-manual-with-zero-balance(主动关空账户)

🚨 强制关账(3,Frozen + 有余额困境):
- force-close-refund(全退,鉴定无责)
- force-close-forfeit(全扣,仲裁全责)
- force-close-retain(资金保留,业户失联/装修方倒闭)

🛡️ 异常/审计(3):
- exception-deposit-on-frozen(冻结状态尝试缴款被三层守护拦截)
- audit-monthly-deposit-balance(月度三方对账:账面 == 银行专户 == 流水净值)
- audit-long-pending-accounts(超 2 年未关账户分类清理)

每篇结构:典型情境 → 业户视角 → 业务人员视角 → 系统流程(mermaid)→
流水台账 → 常见问题 → 异常分支 → 相关文档。

收尾:
- prop-acc/maps/deposit-knowledge-map.md:18 场景全部 ✅,加完成 callout
- prop-acc/maps/knowledge-map.md:deposit 行状态改 "✅ 25 篇"
- prop-acc/index.md:同步

deposit 子模块完整覆盖:6 概念 + 18 场景 + 1 知识地图 = 25 篇。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-25 22:40:19 +08:00
Willie
29938ecbe0 vault backup: 2026-05-25 22:37:41 2026-05-25 22:37:41 +08:00
Willie
68ea6dfbe9 vault backup: 2026-05-25 22:32:40 2026-05-25 22:32:40 +08:00
Willie
963d432d62 vault backup: 2026-05-25 22:27:38 2026-05-25 22:27:38 +08:00
Willie
5482164460 vault backup: 2026-05-25 22:22:37 2026-05-25 22:22:37 +08:00
Willie
d169be22a5 cleanup: 删除 2 个 Obsidian 误点 adhoc 概念产生的 0 字节孤儿 
- 概念-A流与B流.md(目标应是 prop-acc/concepts/adhoc/flow-a-vs-flow-b.md 的旧 basename alias)
- 概念-CollectionOrder与Receipt.md(目标应是 collection-order-and-receipt.md 的旧 basename alias)

复盘:Obsidian 在 Reading 视图点击未解析的 [[场景-...]] / [[概念-...]] 等
旧 basename WikiLink 时,会按 "New link format: Shortest path" 设置在
vault 根目录建空文件,而不是按 aliases 解析到既有目标。

仍未根治。建议:
- Obsidian Settings → Files & Links → New link format → "Absolute path in vault"
- 或在点击未解析链接前先 Cmd+P → "Reload app without saving" 刷新 alias 索引

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-25 22:11:18 +08:00
Willie
461de616f1 deposit 子模块 · 轮 1:6 概念 + 知识地图 + 导航更新 
写 6 个核心概念到 prop-acc/concepts/deposit/:
- deposit-account-vs-transaction:账户(余额状态)+ 流水(不可变历史)双对象模式
- account-state-machine:Active / Frozen / Closed 三状态机,canDeposit/canWithdraw 守护
- payer-types:6 种缴款人(Owner/Tenant/Contractor/Company/Supplier/Other),业户账户 vs 三方账户
- transaction-types:3 种合法流水(deposit/refund/forfeiture),已弃用 adjustment 的审计取舍
- red-receipt-design:退款扣罚走红字 CollectionOrder + Receipt(金额正负 vs 新枚举)
- deposit-vs-adhoc-vs-prepaid:三个子模块会计本质区别(收入 / 预收 / 代管)

新建子模块知识地图:
- prop-acc/maps/deposit-knowledge-map.md:6 概念入口 + 18 场景预占清单 + 跨域引用 + 代码索引

更新导航:
- prop-acc/index.md:七大子模块表保证金行,链 deposit 知识地图,状态 🟡
- prop-acc/maps/knowledge-map.md:域总图同步

下一轮:18 个场景文档(deposit/scenarios/),按本知识地图骨架填充。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-25 22:09:51 +08:00
Willie
341bbb77d6 vault backup: 2026-05-25 22:07:35 2026-05-25 22:07:35 +08:00
Willie
39c15cf443 vault backup: 2026-05-25 21:57:33 2026-05-25 21:57:33 +08:00
Willie
8418498a31 vault backup: 2026-05-25 21:52:29 2026-05-25 21:52:29 +08:00
Willie
6fcf9e7df2 cleanup: 删除 Obsidian 误点产生的 3 个 0 字节孤儿文件 
Obsidian 在 Reading 模式点击未解析的 [[...]] WikiLink 时,会按
"New link format: shortest path" 设置默认在 vault 根目录创建空文件,
而不是按 aliases 解析到既有目标文件。

本次清理:
- 业户.md(0 字节,目标应是 cross/concepts/resident.md 的 alias)
- prop-acc · 知识地图.md(0 字节,目标应是 prop-acc/maps/knowledge-map.md)
- prop-acc · 物业财务(域首页).md(0 字节,目标应是 prop-acc/index.md 的 alias)

避免再次出现:
- Obsidian: Settings → Files & Links → "New link format" 改 "Absolute path
  in vault";或开 "Use [[Wikilinks]]"+"Default location for new notes:
  Same folder as current file" 让点击的红链至少建在当前文件夹
- 或在点击前先用 Cmd+P → "Reload app without saving" 刷新 alias 索引

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-25 21:48:06 +08:00
Willie
94839e4ab8 vault backup: 2026-05-25 21:47:30 2026-05-25 21:47:30 +08:00
Willie
83b4e0277c nav: 导航页全部改用 Markdown 相对链接(Gitea / GitHub 可点击) 
问题: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>
 2026-05-25 21:46:28 +08:00
Willie
c08aa47dbd vault backup: 2026-05-25 21:42:29 2026-05-25 21:42:29 +08:00
Willie
44518fe1e2 vault backup: 2026-05-25 21:36:48 2026-05-25 21:36:48 +08:00
Willie
018e4d07e3 vault backup: 2026-05-25 20:57:17 2026-05-25 20:57:17 +08:00
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
Willie
e9ed756fc4 vault backup: 2026-05-25 20:46:53 2026-05-25 20:46:53 +08:00
Willie
b7c0cd6e0c P3+P4+P5: prop-acc 迁移到多域 UDAS,新建 4 域骨架与顶层入口 
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>
 2026-05-25 20:44:43 +08:00
Willie
0032f32b7a P1+P2: 建立多域 UDAS 骨架与跨域共享概念 stub 
P1 — 创建 61 个标准目录:
- 5 业务域(prop-acc / community / administrative / patrol / resident-portal)
  各 10 标准子目录(concepts/features/procedures/scenarios/reference/
  faq/glossary/decisions/maps/assets)
- cross/ 跨域协作(同 10 标准子目录)
- 顶层 maps/

空目录暂不入 git,P3+P4+P5 填充后才被追踪。

P2 — cross/concepts/ 8 个跨域共享概念 stub(占位,带 frontmatter):
- resident(业户)
- staff(员工)
- org-hierarchy(组织结构)
- housing-unit(房屋单元)
- work-order(工单)
- access-card(门卡 / IC 卡)
- notification(通知)
- role-permission(角色与权限)

每个 stub 含 title、aliases、tags、status、referenced_by,
确保新域文档第一行起 WikiLink `[[业户]]` 即可解析。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-25 20:35:32 +08:00
Willie
11b4ef4c55 vault backup: 2026-05-25 19:30:40 2026-05-25 19:30:40 +08:00
Willie
484d2e2e50 vault backup: 2026-05-25 14:04:39 2026-05-25 14:04:39 +08:00
Willie
0e53ade17c vault backup: 2026-05-25 13:59:37 2026-05-25 13:59:37 +08:00
Willie
b8d6c1501f vault backup: 2026-05-25 13:54:35 2026-05-25 13:54:35 +08:00
Willie
144dea0d57 vault backup: 2026-05-25 13:49:34 2026-05-25 13:49:34 +08:00
Willie
0f4882b83f vault backup: 2026-05-25 13:44:33 2026-05-25 13:44:33 +08:00
Willie
9f688120cd vault backup: 2026-05-25 13:39:33 2026-05-25 13:39:33 +08:00
Willie
1c070e313c vault backup: 2026-05-25 13:34:33 2026-05-25 13:34:33 +08:00
Willie
395d24bc87 vault backup: 2026-05-25 13:29:32 2026-05-25 13:29:32 +08:00
Willie
bd00a94612 vault backup: 2026-05-25 13:24:32 2026-05-25 13:24:32 +08:00
Willie
7f726a3f5d first commit 2026-05-25 13:18:00 +08:00