Capture accumulated application, UI, CLI, regression tests and design documentation changes, including task project mapping and default CalDAV list naming. Keep deployment data, backups, local credentials and build artifacts out of Git. Move the Compose enrollment token to an ignored local environment file.
3.1 KiB
4. Knowledge City と案内図
状態:階層、境界、案内図、URL推論・編集の初期実装あり。自動整理の完全な整合性と大規模化は継続課題。
街の役割
Domainを一つのKnowledge City、Quartierを学区・街区、Streetを通り、Spotを知識の拠点として扱います。道路交通図ではなく、西洋建築の街区・中庭・入口を手がかりに知識へ到達する案内図です。
Spotを開くと、その拠点と周囲のPageを探索できます。ポータルPageは説明の入口であって、配下の一覧を失わせる自動転送の代用品にはしません。
Path境界と多重参照
/life、/life/home、/life/home/kitchen をQuartier、Street、Spotへ対応させる例では、子境界は親の厳密な子孫です。同階層境界の重複はprimaryな所属の曖昧さを避けるため制限します。移動・統合では境界と親子関係を一緒に検証します。
Pageのprimary所属はPathから推論し、明示的なSpot参照は別のグラフ辺として持ちます。他のSpotへ紹介してもPageを複製せず、所属させただけで閲覧権限を与えません。Spotの下へ別のSpotを任意にネストさせる操作は現行モデルの階層ではありません。
案内図の表示規約
- Domainで生成した街の幾何をQuartier・Streetへ割り当て、ズームで文脈を保つ。
- Page数は相対重みだけでなく、少量のStreetを小さくする規模の目安にも使う。
- 未整理Pageは黄緑の個別ポイント。意味のない重複Spot名を増やさない。
- ラベルは原則水平。未ホバー時は場所を把握でき、ホバー時は対象を強調する。
- Spot近接・ラベル重なり・クリックとドラッグの判定を試験する。
- メニューはモーダルへ集約し、地図ポップアップは地図中心。ESC、矢印、WASD/HJKLを既存操作と衝突させない。
- 戻る・進むはアプリ内の状態遷移として扱い、URLの恒久履歴と同じものだと説明しない。
URLからの自動整理
設計案は「推論結果を無条件に再生成」ではなく、手動編集を保護するreconciliationです。生成元、生成版、手動上書き、除外tombstoneを記録し、同じ入力なら変更なしに収束させます。
更新トランザクションと共通outboxを接続し、作成・編集・rename・削除を記録します。 DomainごとのCity consumerは10秒周期でイベントをdebounceし、URLからの自動計画を 背景キューで実行します。成功時だけwatermarkを進め、失敗時は再試行します。完全な 所有権・分散consumer・通知配送はTODOです。
性能・認可のTODO
現在のWorker生成や表示数上限だけでは、サーバー側で全体を読む問題は解決しません。局所的な階層取得、Pageのcursor、directory索引を先に整備します。権限で除外した名前・件数・ポータル・辺をcacheから復活させないことを合格条件にします。