trip-albums
ai-team
て
新規アカウントの登録方法
更新: 2026-07-12(Fable)。セルフ登録実装(課題0711b)に伴い、CLI手順から本人登録手順へ書き換え。
ユーザー本人による登録(標準)
- https://trip-albums.zinichi.net を開き、メールアドレスを入力して「認証コードを送る」
- 届いた6桁コードでログイン(コード期限10分。切れてもメール再入力で新しいコードが届く)
- 初回は「ようこそ」画面で表示名(共有相手に見える名前・後から変更可)を入力して「はじめる」→ 完了
登録の裏側: アカウントの識別はメールアドレス。サーバー上のフォルダ名は無意味な自動記号でユーザーには見せない。会社台帳への作成もこの「はじめる」の瞬間に行われる(コード要求だけでは何も作られず、7日で自動掃除)。
写真の配置(現在はオーナー作業)
アップロード機能(iOS/Androidアプリ・別GO)ができるまで、写真はオーナーがNASに配置する:
- Macで
.venv/bin/python tools/create-user.py --listを実行 → メールアドレス↔フォルダ名の対応リストが出る smb://192.168.30.70/trip-albumsのphoto/<フォルダ名>/upload/に写真を置く- あとは自動(毎日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と同時期)
- アカウント登録: 同チャプター「新規アカウントの登録方法」