Files

6.8 KiB

6. 公開・承認・共有・匿名ナビゲーション

状態:明示的なRevision公開、Street/Spotの自動公開、匿名ナビゲーションは実装済み。承認要求の登録・限定決裁APIと受信者別Inboxは実装済み。上位方針・reviewer継承、定足数、現行Revisionの再検証、決裁UIを含む公開運用フローは未完成。共有URL管理もTODO。2026-11-08、publication_approval_api.goと照合。

三つの異なるもの

  1. 公開可能な上限:上位管理者が許可するaudience。下位は狭められるが広げられない。
  2. 実際の公開:特定Revisionの明示承認、または確認済みの自動公開ルール。
  3. 認証後のread/write:ユーザー・グループの権限。公開設定を変更しただけで編集者を増やさない。

public という上限を保存しただけで配下全部を公開したと扱いません。

現行の自動公開

モード 動作
inherit この階層ではルールを追加せず上位に従う
required この範囲と配下は手動公開のみ。下位の自動公開で解除できない
automatic Street/Spotの現在と将来の対象Page、および各言語の現在headを公開

Domain・Quartierもrequiredの上限制約を設定できます。automaticは有効な公開audienceを必要とし、影響プレビューと明示確認、policy/topology/versionの一致で有効化します。空の範囲にも設定できるため、今後作成する記事も対象になり得ます。

固定したPath境界のrename、設定した本人の権限失効、Domain/Campus無効化は公開を継続する根拠になりません。境界内への移動も対象になり得るため、importやメールコピーでは公開先の確認が重要です。別名、制限された子範囲、予約領域は現行の除外対象です。

自動公開の停止と、別途承認したRevisionの撤回は同じ操作ではありません。完全に非公開へ戻す場合はaudienceも制限します。新しい導入・migrationで自動公開を有効にしません。

影響確認は現在512 Path、ルール列挙128行、公開ナビゲーション20,000件/4 MiB等の上限があります。大きい範囲は分割・ページ送り付き確認の実装が必要です。上限超過を認可成功として扱いません。

匿名表示と共有リンク

公開Pageは読めるchildren・tree・City・パンくずへ移動できます。構造上必要な仮想親フォルダは、非公開の親本文やタイトルを見せる許可ではありません。通常・詳細・アイコン表示を共通化します。公開画面にダウンロード操作を強調する必要はありません。

ユーザー領域 /u/{username} はCityの通常公開から除外したまま、専用の公開設定を /u/{username}/_/edit に実装しています。プロフィール情報、プロフィール画像、ユーザーWikiのroot、配下の既定値をそれぞれ private / domain / public から選べます。配下の個別Pathは既定値より狭い範囲に限って上書きでき、その指定はsubtreeにも効きます。Domainの公開上限がpublicで、有効なCampus/Domainかつ認可がenforcingの場合だけpublicを保存・配信できます。上限を閉じれば次の要求から匿名配信も閉じます。

これは所有者が明示的に有効化する現在headの自動公開です。通常Pageの固定Revision承認を流用せず、将来の編集も同じ範囲で公開されます。匿名children・tree・browserは当該ユーザー領域だけの公開snapshotを使用し、グローバル匿名treeへ /u/ を混ぜません。別名を持つObject、UUID/Revision経由、予約 /_/ 経路では迂回できません。詳細は user-space visibility contract を参照してください。

将来のshare URLは期限・範囲・目的を限定した単一ページ表示が基本です。ログインセッションや公開ナビゲーション全体への昇格はさせません。Macaroonを含む委譲方式は設計段階で、予約 /s/ があることは実装済みを意味しません。

承認Inboxの設計と実装状況

承認要求は対象Revision、依存物、scope、policy version、要求者と期限を固定します。変更された本文に旧承認を流用しません。承認者の現在の権限を決裁時に再検査し、outboxから通知Inboxへ重複排除して配送します。

状態はdraft → requested → approved / rejected / expired / supersededを案とします。取り消し・公開撤回は別監査イベントです。上位の承認必須設定を下位が解除できないこと、自動公開との優先順位、本人承認の可否を実装前に確定します。

共通通知Inboxの第一段階として、notification_inboxにDomain・受信者・イベント・種別を保存し、同じ組合せを重複排除します。GET /_/api/v1/notifications は現在のPrincipalに限定して unread、limit、before のkeyset取得を行い、POST/PATCH /_/api/v1/notifications/read は同じDomain・受信者の通知だけを既読化します。通知は権限や承認を付与せず、承認対象の本文や秘密を保存しません。要求登録からの限定的なInbox生成は下記のAPIに接続済み。現行対象の再検査を含む完全な決裁フローは次段階です。

承認要求の対象(Path/Object/RevisionのハッシュとJSON)、policy version、generation、期限、要求者をpublication_requestsに固定保存し、決裁履歴をpublication_decisionsへ追記します。期限付きpending要求はスケジューラが小さなbatchでexpiredへ遷移させます。Domain管理者向けの限定決裁APIは存在しますが、委譲レビュアーの決裁UI・完全な公開承認フローを提供した状態ではありません。

認証済みのDomain管理者向けに、POST /_/api/v1/publication/requestsでboundedな対象manifestを登録できます。idempotency keyで再送をまとめ、指定されたレビュアーがDomain管理権限を持つ場合だけInbox通知を作成します。POST /_/api/v1/publication/requests/{uuid}/decisionsはDomainとgenerationを再検査し、承認・拒否をCASで一度だけ適用します。上位方針の継承、定足数、対象Revisionの現在性検査は、公開運用へ進む前の残タスクです。

TODO

依存Assetと別名の完全な影響レビュー、広域の移動・統合時のfence、ルールGC、承認者・定足数・Inbox、署名付きpolicy配信、share失効管理。RSS読者や外部SNSが既に取得したコピーを遠隔削除できるとは約束しません。