# 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から復活させないことを合格条件にします。