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

63 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
Willie
7d07ffa758 vault backup: 2026-05-26 01:23:19 2026-05-26 01:23:19 +08:00
Willie
42c135a5cf billing 子模块 · 轮 2:16 场景 + 知识地图收尾 
写 16 个场景到 prop-acc/scenarios/billing/,覆盖 5 类业务:

📝 账单创建(3):
- create-periodic-property-fee(月度物业费 300 户批量,SkipExisting 默认策略)
- create-meter-bill-auto(抄表自动生成计量账单,与 meter pipeline 衔接)
- create-single-bill-manual(电梯维修分摊 / 罚款 / 跨期补开 三典型情境)

💰 收款(3):
- collect-payment-single(单张收款,Modal + 数据示例 + 部分付场景)
- collect-payment-batch(同业户多账单一次收款,1 个 CO + N 个 COBill)
- collect-via-prepaid-auto(billing × prepaid 跨模块联动,fund_source=prepaid)

✂️ 账单调整(3):
- split-bill(房东/租户分摊场景,SplitBillAction 全转/部分拆模式)
- suspend-bill(纠纷/失联 SuspendBillAction,与 Unpaid/Partial 状态守护)
- resume-bill(智能恢复 Unpaid / Partial,suspend_history 数组设计)

🗑️ 删除 / 作废(3):
- delete-bill-unpaid(物理删 canBeDeleted=Unpaid+无付款,activitylog 留 bill_no)
- void-paid-bill(Partial 作废可用 + Paid 作废需手工/tinker 流程的局限)
- bulk-delete-batch-mistake(智能批删 Modal 三档分类 + 完整 activitylog 实战)

🛡️ 异常 / 审计(4):
- exception-partial-payment(Partial 状态完整生命周期 + 多次补付流水)
- exception-overdue-bills(OverdueBillsListWidget + 分级催收 +
  滞纳金合规 + 服务限制合规边界)
- audit-monthly-billing-vs-collection(收款率核心指标 + SQL 报表 +
  与会计科目映射)
- audit-activitylog-trace(spatie activitylog 实战查询 +
  与 meta JSON 对比 + 跨模块审计 + 法务用途)

每篇结构:典型情境 → 业户/业务/财务/审计视角 → 系统流程(mermaid) →
SQL 报表 / 数据示例 → 常见问题 → 异常分支 → 相关文档(WikiLinks)。

billing 独特设计在场景中持续强调:
- 6 状态机的状态流转(Unpaid → Partial → Paid;Suspended ↔ Unpaid;Void 终态)
- 多对多关联(CollectionOrderBill 中间表 + allocated_amount 语义)
- 删 vs 作废双轨制(双层守护 + 业务场景区分)
- 智能批删 Modal(预检查三档分类 + 必填原因 + 单条 activitylog 含 affected_bill_nos)
- spatie activitylog 审计(properties JSON 跨模块查询)
- 跨子模块联动(meter → billing,prepaid → billing,billing → CollectionOrder)

收尾:
- prop-acc/maps/billing-knowledge-map.md:16 场景全部 ✅
- prop-acc/maps/knowledge-map.md:billing 行状态改 "✅ 23 篇"
- prop-acc/index.md:同步

billing 子模块完整覆盖:6 概念 + 16 场景 + 1 知识地图 = 23 篇。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-26 01:21:32 +08:00
Willie
7cdf0ec9a4 vault backup: 2026-05-26 01:18:18 2026-05-26 01:18:18 +08:00
Willie
669d3b4400 vault backup: 2026-05-26 01:13:17 2026-05-26 01:13:17 +08:00
Willie
1bc1884255 vault backup: 2026-05-26 01:08:16 2026-05-26 01:08:16 +08:00
Willie
d3a786ba76 vault backup: 2026-05-26 01:03:15 2026-05-26 01:03:15 +08:00
Willie
82de3396bb vault backup: 2026-05-26 00:58:14 2026-05-26 00:58:14 +08:00
Willie
085de29cc8 billing 子模块 · 轮 1:6 概念 + 知识地图 + 导航更新 
写 6 个核心概念到 prop-acc/concepts/billing/:
- bill-six-state-machine:6 状态(Unpaid/Partial/Paid/Suspended/Processing/Void),
  prop-acc 最复杂状态机;canBePaid/canBeDeleted/canBeVoided 守护方法详解
- bill-types-and-sources:周期/计量/临时 三类账单 + sourceable polymorphism
  (MeterReading / 周期任务 / null 三种 source 类型)
- bill-vs-collection-order:Bill(应收)vs CollectionOrder(已收),
  CollectionOrderBill 多对多关联 + allocated_amount 字段语义;
  与 adhoc 的 1:1 关系对比
- periodic-bill-generation:GeneratePeriodicBillsAction 完整流程 +
  BillingMergeStrategy 三种策略(SkipExisting / Merge / Replace)
- delete-vs-void-dual-track:双轨制设计哲学,物理删(Unpaid 无付款)vs
  作废(留状态留审计);issue.md Q6 第一轮修复历史
- smart-bulk-delete-design:智能批量删除 Modal 设计(预检查三档分类 +
  必填原因 + 单条 activitylog 含 affected_bill_nos 数组);
  bill.bulkDelete 独立高敏权限

新建子模块知识地图:
- prop-acc/maps/billing-knowledge-map.md:6 概念入口 + 16 场景预占 +
  跨子模块对比(billing 与 deposit/prepaid/meter 的 6 维度差异)+ 代码索引

更新导航:
- prop-acc/maps/knowledge-map.md:域总图 billing 行链 billing 知识地图,状态 🟡
- prop-acc/index.md:同步

billing 是 prop-acc 的"收款中枢" -- 上游对接 meter/周期任务/手工,
下游对接 CollectionOrder/Receipt,侧链对接 prepaid 抵扣。

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

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-26 00:48:58 +08:00
Willie
5934191115 vault backup: 2026-05-26 00:48:12 2026-05-26 00:48:12 +08:00
Willie
81c09219ea vault backup: 2026-05-26 00:43:11 2026-05-26 00:43:11 +08:00
Willie
7b0e92f5b9 vault backup: 2026-05-26 00:33:10 2026-05-26 00:33:10 +08:00
Willie
92f3c6698e meter 子模块 · 轮 2:14 场景 + 知识地图收尾 
写 14 个场景到 prop-acc/scenarios/meter/,覆盖 4 类业务:

📦 表管理(4):
- init-new-community-batch(新社区批量建表 + 初始读数 Excel 导入,
  走 MeterInitializationImporter + BaseImporter chunk rollback)
- register-single-meter(单独新增一张表,陈先生厨房分户表)
- replace-broken-meter(换表场景,旧表 5000 → 新表 -R1 后缀 + initial 5000 继承,
  ReplaceMeterAction 完整流程)
- decommission-without-replacement(退役不换表,3 种典型情境:
  房屋拆除 / 商铺撤店 / 法定年限到)

📊 抄表(4):
- read-single-meter-manual(后台单录,李师傅集抄掉线补抄)
- read-batch-via-excel-import(MeterReadingsImporter + 模板下载流程 +
  双义列名 silent corruption 已知风险)
- read-via-iot-remote-source(集抄系统对接,API + 防重放 + 与 deposit/prepaid 集成)
- read-with-photo-proof(物理表头照片,业户争议时关键凭证)

💰 账单生成(3):
- generate-bill-tiered-pricing(progressive 累进算法完整算例 35 吨水的三段计算,
  对比 full-tier 简陋实现)
- generate-bill-with-multiplier(工业表 multiplier=10 算例 + 抄表员录入注意事项)
- generate-bill-min-max-cap(漏水 max 封顶 + 零用量 min 兜底 + 正常范围三情境)

🛡️ 异常/审计(3):
- exception-high-consumption(HighConsumptionReadingsListWidget 预警 +
  分级处置 + 完整排查流程)
- exception-readings-locked-after-bill(双锁机制下的修正流程,当前手工 +
  未来 VoidBillAction 设计目标态,issue.md Q5 待补)
- audit-meters-needing-reading(MetersNeedingReadingListWidget +
  月度完成率 99% 目标 + 月度报告模板)

每篇结构:典型情境 → 业户/抄表员/业务人员视角 → 系统流程(mermaid)→
对比表 / 算例 → 常见问题 → 异常分支 → 相关文档(WikiLinks)。

meter 模块特性在场景中持续强调:
- 物理硬件维度(非抽象账户)
- 不直接产 Receipt(走 Bill 中转)
- 三层业务分层(Calculator + Service + Action)
- 双锁机制(创建即不可改 + 有 Bill 更严)
- 抄表来源 + 拍照存证 + 集抄对接
- progressive 累进 vs full-tier 简陋实现的设计正确性
- 倍率 + 阶梯 + min/max 三层叠加算法

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

meter 子模块完整覆盖:6 概念 + 14 场景 + 1 知识地图 = 21 篇。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-26 00:31:08 +08:00
Willie
6bdaa31017 vault backup: 2026-05-26 00:28:09 2026-05-26 00:28:09 +08:00
Willie
495caa2780 vault backup: 2026-05-26 00:23:07 2026-05-26 00:23:07 +08:00
Willie
896265cad6 vault backup: 2026-05-26 00:18:06 2026-05-26 00:18:06 +08:00
Willie
7987adb131 vault backup: 2026-05-26 00:13:05 2026-05-26 00:13:05 +08:00
Willie
293a2d2685 vault backup: 2026-05-25 23:58:02 2026-05-25 23:58:02 +08:00
Willie
898d3a93a7 meter 子模块 · 轮 1:6 概念 + 知识地图 + 导航更新 
写 6 个核心概念到 prop-acc/concepts/meter/:
- meter-vs-meter-reading:物理表配置 + 不可变读数流水双对象;与"账户+流水"模式
  对比(主对象有 balance vs 物理硬件配置;直接产 Receipt vs 通过 Bill 中转)
- replacement-chain:replaced_meter_id + 自动 -R1 后缀 + 初始读数继承;
  nextReplacementCode() 算法 + 整链追溯 + ReplaceMeterAction 流程
- multiplier-and-tiered-pricing:倍率(decimal(10,4),工业表 10x/100x)+
  阶梯计价(progressive 累进算法,非 full-tier 简陋实现)+ min/max 封顶
- bill-generation-pipeline:三层分层 Calculator(纯算)→ Service(查费率+找业主+建账)
  → Action(入口);多调用方共用业务层;prop-acc 后续模块的样板
- reading-source-and-photo-proof:MeterReadingSource 2 种(manual/remote)+
  photo_url 拍照存证;业户对账单争议时的凭证依据
- decommission-and-locking:MeterDecommissionReason 5 种 + Reading 双锁机制
  (创建即不可改;有 bill_id 更不可改/删);issue.md Q5 第二轮修复历史

新建子模块知识地图:
- prop-acc/maps/meter-knowledge-map.md:6 概念入口 + 14 场景预占清单 +
  跨子模块对比(meter 与 deposit/prepaid 的核心差异)+ 代码索引

更新导航:
- prop-acc/maps/knowledge-map.md:域总图 meter 行链 meter 知识地图,状态 🟡
- prop-acc/index.md:同步

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

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-25 23:56:41 +08:00
Willie
a7ac2d50b9 vault backup: 2026-05-25 23:53:01 2026-05-25 23:53:01 +08:00
Willie
d67494595e vault backup: 2026-05-25 23:48:00 2026-05-25 23:48:00 +08:00
Willie
28ac7656a5 prepaid 子模块 · 轮 2:16 场景 + 知识地图收尾 
写 16 个场景到 prop-acc/scenarios/prepaid/,覆盖 6 类业务:

📥 充值(3):
- deposit-first-time(张阿姨首次充 5000)
- deposit-additional-topup(已有账户追加充值)
- deposit-via-miniapp-pending(小程序在线充值设计意图,待补)

🧹 消费 Consume(4,最核心):
- consume-monthly-property-bill(手动抵扣月物业费)
- consume-multiple-bills-priority(多账单按 due_at 优先级抵扣)
- consume-meter-bill(抵扣计量账单 - 水电费)
- consume-batch-auto-monthly(月初批量自动抵扣 job 设计 + 业务流程,待补)

💰 退款(2):
- refund-full-resident-moveout(业户搬走全额退余,**不自动关账**)
- refund-partial-after-consume(部分退余,余额非零保持 Active)

🧊 冻结/解冻(2):
- freeze-suspected-fraud(疑似欺诈 / 风控冻结)
- unfreeze-after-verification(核实后解冻 = ReactivateAccountAction)

🔒 结清(2):
- close-resident-moveout(业户搬走主动关账,**需手动**与 deposit 不同)
- close-with-zero-balance-decision(余额清零不自动关,业户决定)

🛡️ 异常/审计(3):
- exception-cross-community-consume(跨社区消费三层防御,模型层抛 InvalidArgumentException)
- exception-refund-on-frozen(冻结状态退款三层守护,模型层最严 canOperate)
- audit-low-balance-and-overdue(低余额业户预警 + 逾期账单排查,
  关联 LowBalancePrepaidListWidget + DepositPrepaidDashboard)

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

prepaid 与 deposit 的核心差异在场景中持续强调:
- 一户一账约束(deposit 不允许跨账户操作的设计)
- 零余额不自动关账(consume / refund 后状态保持 Active)
- 消费走 CollectionType=Bill(账单视角,fund_source=prepaid)
- 没有 ForceClose(纠纷罕见,简化设计)
- 缴款人只能是业户本人(deposit 支持装修公司代缴)

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

prepaid 子模块完整覆盖:6 概念 + 16 场景 + 1 知识地图 = 23 篇。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-25 23:39:05 +08:00
Willie
e759ec39ae vault backup: 2026-05-25 23:37:58 2026-05-25 23:37:58 +08:00
Willie
344bd552d1 vault backup: 2026-05-25 23:32:57 2026-05-25 23:32:57 +08:00
Willie
ae134c321d vault backup: 2026-05-25 23:27:56 2026-05-25 23:27:56 +08:00
Willie
f407569771 vault backup: 2026-05-25 23:22:55 2026-05-25 23:22:55 +08:00
Willie
ee7abbfc45 vault backup: 2026-05-25 23:17:54 2026-05-25 23:17:54 +08:00
Willie
867fd3dd24 vault backup: 2026-05-25 23:07:52 2026-05-25 23:07:53 +08:00
Willie
c9b92c6c1b prepaid 子模块 · 轮 1:6 概念 + 知识地图 + 导航更新 
写 6 个核心概念到 prop-acc/concepts/prepaid/:
- prepaid-account-vs-transaction:账户+流水双对象,与 deposit 同构但多两条独有约束(一户一账、零余额不自动关账)
- account-state-machine:Active / Frozen / Closed,canOperate 统一守护,与 deposit 差异(零余额行为、无 ForceClose)
- one-account-per-resident:unique(community_id, profile_id) + 跨社区防御(prepaid 独有)
- transaction-types:4 种流水(deposit / consume / refund / adjustment),consume 是最高频
- consume-via-bill-collection-type:Consume 走 CollectionType=Bill 而非 Prepaid 的独特设计,资金来源标 meta.fund_source
- auto-deduction-design:月初批量自动抵扣 scheduled job 的设计意图(代码待补,issue.md Q4 已记录)

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

更新导航:
- prop-acc/maps/knowledge-map.md:域总图 prepaid 行链 prepaid 知识地图,状态 🟡
- prop-acc/index.md:同步

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

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-25 23:04:35 +08:00
Willie
b3a8c502e7 vault backup: 2026-05-25 23:02:51 2026-05-25 23:02:51 +08:00
Willie
754fcadaf4 vault backup: 2026-05-25 22:57:50 2026-05-25 22:57:50 +08:00
Willie
af87159315 vault backup: 2026-05-25 22:52:49 2026-05-25 22:52:49 +08:00
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