アルバムの共有方法

更新: 2026-07-11(Fable)。単位R4実装完了に伴い、設計予定ページから実手順書へ書き換え。

できること

オーナーが手動ハブとなり、イベント単位で他ユーザーへ共有できる(単位R4・2026-07-11稼働)。共有された側のViewerには、端末フォルダと同格に「共有:ユーザー名」フォルダ(アイコン🤝)が現れ、中に共有されたイベントが並ぶ。

階層: ユーザー > 共有:ユーザー名 > イベント(2026-07-11オーナー指定。ユーザー名は当面slug表示、プロフィールUI実装後に表示名へ)

操作手順(オーナー・Mac側)

trip_albumsプロジェクトルートで実行する。

共有の付与

.venv/bin/python tools/share-event.py --grant --owner zinichi --event event_0214 --to hiroe

付与前にイベントの実在・所有者一致・共有先ユーザーの台帳登録を自動検証する(通らなければエラーで止まり、台帳には書かれない)。二重付与は安全(既存の共有を返すだけ)。

共有の取り消し

.venv/bin/python tools/share-event.py --revoke --owner zinichi --event event_0214 --to hiroe

台帳の行は削除せずrevoked_atを記録する(履歴保持)。取り消すと相手のフォルダから即座に消える(75へは同期後)。

共有一覧の確認

.venv/bin/python tools/share-event.py --list

公開Web(75)への反映タイミング

• 自動: 毎日6/14/22時のauto-ingest末尾の同期で反映
• 即時に反映したい場合: bash tools/sync-web-artifacts.sh を手動実行

付与/取消はMacの正本にのみ書く。75は台帳を読むだけ(訂正アウトボックスとは無関係)。

共有された側に見えるもの

• 共有されたイベントの一覧・詳細・サムネイル(そのイベントの写真のみ)
• 共有されていないイベント・写真はURL直叩きでも404(認可は共有台帳にある分だけ穴があく)

グループへの共有(準備済み・グループ機能は未実装)

台帳は共有先としてユーザーslugとグループIDの両対応で作ってある。グループアカウント(課題0711a)実装後は --kind group --to <group_id> で同じ台帳に乗る。

関連

• 実装記録: trip_albumsリポジトリの 課題0710a.md「単位R4」
• グループ構想: 課題0711a.md(実装はプロフィールUIと同時期)
• アカウント登録: 同チャプター「新規アカウントの登録方法」