arise

ARise（旧: AR名刺システム）

バージョン: v1.8（2026-09-24更新：QRコードライブラリの配信不具合を修正）

写真（顔写真・ウェディング写真など）をARマーカーとして、スマートフォンをかざすと動画が再生される体験を作るためのシステム一式。

構成

ar-namecard-system/
├── generator/
│   └── ar_generator.html      # 写真・動画からARページを生成するツール（社内完結型）
└── supabase/
    ├── migrations/             # DBスキーマ（ar_namecardスキーマ、5ファイル・適用順）
    └── functions/
        ├── validate-license/   # ライセンスキー検証API
        └── send-email/         # Gmail API経由のメール送信API

ジェネレーターツール（generator/ar_generator.html）

• 顔写真・動画をアップロードすると、ブラウザ内でMindAR.jsのコンパイラを直接実行し、ARマーカー（.mind）を生成
• 生成したマーカー・参照用サムネイル・動画（アップロードした場合）を1つの自己完結型HTMLファイルに埋め込んで出力
• 写真・動画データは一切外部送信されない（社内完結型プランのコンプライアンス要件に対応）
• 利用にはライセンスキーの入力が必要（validate-license APIに照会。キー以外のデータは送信されない）
• claude.aiのArtifact機能では公開できない：カメラ利用・ファイルダウンロードのどちらもArtifactのサンドボックスでは動作しないため、GitHub Pages等、実際のWebホスティングに配置する前提

Supabaseスキーマ（ar_namecard）

既存のCrealize本番データ（publicスキーマ）とは完全に分離した独立スキーマ。主なテーブル：

テーブル	役割
partners	B2Bチャネルパートナー（フォトスタジオ・印刷業者・結婚相談所・式場）
projects	1件のAR体験案件
targets / contents	マーカー・動画の配信方式（embedded_html / external_link / arweave）
consents / takedown_requests	撮影同意・公開同意の分離管理、削除申請のSLA管理
contracts / license_keys / license_validations	契約管理（クラウド型／社内完結型）とライセンス認証
coupons / coupon_redemptions	割引クーポン（B2C/B2B両対応、Crealizeと同じ設計）
email_templates / email_logs	メールテンプレートと送信ログ

セットアップ手順

1. supabase/migrations/ を適用（supabase db push またはSupabase MCP経由のapply_migration）
2. 重要：Supabaseダッシュボードの Settings > Data API > Exposed schemas に ar_namecard を追加する（マイグレーションだけでは有効化されない。忘れるとAPI経由のテーブルアクセスが not found になる）
3. Edge Functionsをデプロイ（supabase functions deploy validate-license / send-email）
4. send-email 用の環境変数（Secrets）を設定：
   • AR_GMAIL_CLIENT_ID
   • AR_GMAIL_CLIENT_SECRET
   • AR_GMAIL_REFRESH_TOKEN
   • AR_GMAIL_SENDER_ADDRESS
   • AR_GMAIL_SENDER_NAME（任意、未設定なら「ARise」）

既知の落とし穴（開発時の学び）

• Gmailエイリアス送信：Google Workspace管理コンソールの「予備のメールアドレス（メールエイリアス）」に追加しただけでは、そのアドレスから送信できない。Gmail自身の設定（アカウントとインポート→「名前」→自分のメールアドレスを追加）で個別登録が必要
• メールヘッダーの日本語：Fromの表示名・Subjectに日本語を使う場合はRFC2047（=?UTF-8?B?...?=）でMIMEエンコードしないと文字化けする
• Arweaveの削除不可制約：contents.delivery_method = 'arweave' を使う場合、ネットワーク上のデータは削除不可能。暗号化＋鍵破棄（encryption_key_ref / encryption_key_destroyed_at）でしか事実上の削除を実現できない。お見合い用途には提供しない方針
• claude.ai Artifactの制約：カメラAPI（getUserMedia）・ファイルダウンロードのどちらも標準では動作しない。ダウンロードはdownloadsケイパビリティを明示的に宣言すれば動作する

技術スタック

• MindAR.js（画像認識AR、OSS）/ A-Frame（WebAR表示）
• Supabase（Postgres / Edge Functions）
• Gmail API（OAuth2リフレッシュトークン方式でのメール送信）