# ai-team

# て



# 新規アカウントの登録方法

更新: 2026-07-12(Fable)。セルフ登録実装(課題0711b)に伴い、CLI手順から本人登録手順へ書き換え。

## ユーザー本人による登録(標準)

1. [https://trip-albums.zinichi.net](https://trip-albums.zinichi.net/login) を開き、メールアドレスを入力して「認証コードを送る」
2. 届いた6桁コードでログイン(コード期限10分。切れてもメール再入力で新しいコードが届く)
3. 初回は「ようこそ」画面で**表示名**(共有相手に見える名前・後から変更可)を入力して「はじめる」→ 完了

登録の裏側: アカウントの識別はメールアドレス。サーバー上のフォルダ名は無意味な自動記号でユーザーには見せない。会社台帳への作成もこの「はじめる」の瞬間に行われる(コード要求だけでは何も作られず、7日で自動掃除)。

## 写真の配置(現在はオーナー作業)

アップロード機能(iOS/Androidアプリ・別GO)ができるまで、写真はオーナーがNASに配置する:

1. Macで `.venv/bin/python tools/create-user.py --list` を実行 → **メールアドレス↔フォルダ名の対応リスト**が出る
2. `smb://192.168.30.70/trip-albums` の `photo/<フォルダ名>/upload/` に写真を置く
3. あとは自動(毎日6/14/22時に解析→本人へ完了メール)

## オーナーによる代理登録(補助)

```
.venv/bin/python tools/create-user.py --email tester@example.com --display-name たろう
```

本人がログインする時は、そのメールアドレスでコードを取得するだけ(上の手順2から)。

## メールモードの注意

完了メール・グループ招待メールは**owner\_testモード**中は全部オーナー宛(\[TEST\]付き)。認証コードだけは本人宛に直接届く。解除は data/config/mail.json を作成して mode を上書き。

## 関連

- 実装記録: trip\_albumsリポジトリの 課題0711b.md
- 共有とグループ: 同チャプター「アルバムの共有方法」

# アルバムの共有方法

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