# アルバムの共有方法

更新: 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と同時期)
- アカウント登録: 同チャプター「新規アカウントの登録方法」