プロジェクト オンボーディング 完了判定

全体像

📌 新規プロジェクト作成ウィザードの進捗を管理し、「完了」判定をルールベースで行う。
⚙️ ルールベース (LLM コールは LP 解析 / バナー初回生成 に委譲)。

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#f6f8fa','primaryTextColor':'#1f2328','primaryBorderColor':'#d0d7de','lineColor':'#57606a','secondaryColor':'#eaeef2','tertiaryColor':'#ffffff','fontFamily':'sans-serif','fontSize':'14px'}}}%%
flowchart TD
    Signup["サインアップ<br>(メール + パスワード)"] --> Plan["⚙️ free プラン付与<br>(試用 50 クレジット)"]
    Plan --> Start["ウィザード起動"]
    Start --> Q["① ユーザー振り分け 2 問<br>(LP 有無 / 広告アカウント有無)"]
    Q --> Level{"⚙️ スキルレベル判定<br>(広告アカウント有無のみ)"}
    Level -->|"広告アカウントなし"| Beg["初心者"]
    Level -->|"広告アカウントあり"| Adv["中級者以上"]
    Beg --> P0["② 必須入力<br>(プロジェクト名 + LP URL)"]
    Adv --> P0
    P0 --> Validate0["⚙️ 必須項目検証"]
    Validate0 -->|"NG"| P0
    Validate0 -->|"OK"| Backend["⚙️ バックエンド処理 (自動実行)<br>プロジェクト作成 (DB) → 🤖 LP 解析"]
    Backend --> Banner["🤖 バナー初回生成<br>(オンボーディング 6 枚)"]
    Banner --> Done2(["作成したプロジェクトのページに<br>リダイレクト"])
    Done2 --> Tut{"③ スキルレベル別<br>チュートリアル分岐"}
    Tut -->|"初心者"| TutB["全承認ボタン"]
    Tut -->|"中級者以上"| TutA["ステップ 1〜4 を全案内"]
    TutB -->|"全承認 or スキップ"| Billing{"④ 課金フロー起動<br>(課金済み判定 / 広告主の選択)"}
    TutA -->|"完了 or スキップ"| Billing
    Billing -->|"課金済み (skip)"| Dash(["作成したプロジェクトのページ"])
    Billing -->|"プラン選択 → Stripe checkout"| Stripe["⚙️ Stripe 決済<br>(クレカ登録 + 3 ヶ月縛り同意)"]
    Billing -->|"初期構築依頼"| SetupReq["📧 初期構築依頼メール送信<br>(運用代行リクエスト)"]
    Billing -->|"後で"| Dash
    Stripe --> Dash
    SetupReq --> Dash
    Dash -.->|"チュートリアル未完了"| Resume["⑤ 「チュートリアルを再開する」<br>ボタン (ダッシュボード上に表示)"]
    Resume -.->|"クリック"| Tut

    click Backend "./lp-analysis-logic.md" "LP 解析ロジックへ"
    click Banner "./initial-banner-generation-logic.md" "バナー初回生成ロジックへ"

    Signup:::form
    Plan:::rule
    Start:::form
    Q:::form
    Level:::rule
    Beg:::out
    Adv:::out
    P0:::form
    Validate0:::rule
    Backend:::rule
    Banner:::llm
    Done2:::out
    Tut:::rule
    TutB:::out
    TutA:::out
    Billing:::rule
    Stripe:::rule
    SetupReq:::form
    Dash:::out
    Resume:::rule
    classDef form fill:#e3f2fd,stroke:#1565c0,color:#0d47a1
    classDef rule fill:#eceff1,stroke:#546e7a,color:#37474f
    classDef llm fill:#fff8e1,stroke:#b8860b,color:#5d4037
    classDef out fill:#e8f5e9,stroke:#2e7d32,color:#1b5e20

各補足は ①〜⑤ で本文と連動。バックエンド処理 (LP 解析) / バナー初回生成 の詳細はノードクリックで該当ロジックへ。フローで自明なノード (Signup / Plan / Done2 / Stripe / Dash 等) は本文での再説明を省く。

---

① ユーザー振り分け 2 問

• スキルレベル判定: Q2 = はい のみ「中級者以上」、それ以外は「初心者」。Q1 はスキルレベル判定に使わない (チュートリアル UI の出し分けにのみ影響)。
• Q1 = いいえ: 自社 LP が無いため、② で 他社 LP URL の入力補助 (下記) を使って暫定的にプロジェクトを開始できる。LP 解析結果は参考用扱い、自社 LP 用意後にプロジェクト設定から差し替え可。
• Q2 = いいえ + Q1 = はい: ② 〜 バナー初回生成 まで通常進行。② で配信先媒体は尋ねない。完了後に「まずは Meta から」ステップガイドを表示。

---

② 必須入力

必須項目未入力時は「次へ」ボタン disabled。

自社 LP がない場合の入力補助 (他社 LP URL 提案)

自社 LP を保有していないがオンボーディングを進めたい広告主向けに、他社 (競合 / 類似業種) の LP URL を借りる入力補助 UI を提供する。LP 解析は他社 LP に対して行い、訴求軸・業界カテゴリ・ターゲットを推定して暫定的に生成パイプラインを動かす。

---

③ スキルレベル別 チュートリアル分岐

初心者向け (全承認ボタンのみ)

• メインカード: 「6 枚のバナーを生成しました」+ サムネ一覧
• プライマリ CTA: 「全て承認する」ボタン
• サブ CTA: 「あとで」(スキップ) リンク (控えめ)
• 非表示: 個別承認 / 修正 / 再生成 / カスタム生成 / リスティング案内

設計意図: 広告運用未経験者には「個別承認」「修正」などの選択肢は混乱を招くため、全承認ボタンを目立たせ判断保留したい人向けにのみスキップ導線を置く。

中級者以上向け (ステップ 1〜4 を全案内)

スキップ挙動 (両レベル共通)

• いつでもスキップ可。スキップしても ⑤ 「チュートリアルを再開する」ボタンから再開できる。
• 中級者の各ステップ「後で」: 当該ステップだけスキップ、残りは継続表示。
• 「全部スキップ」: 全ステップ閉じてダッシュボードへ。
• 全ステップ完了: バッジ「セットアップ完了」を付与。
• 進捗保存: tutorial_progress テーブルにステップ別完了フラグを保持。

---

④ 課金フロー起動

入口で 課金状態を判定。既に standard / pro 契約済みなら課金 UI を出さずに直接 作成したプロジェクトのページ に遷移。未課金の場合のみ広告主に 3 分岐を提示。

課金済み (スキップ)

• 既に standard / pro を契約済みのアカウント (同一広告主が 2 件目以降のプロジェクトを作成した場合 等) は ④ をスルー。
• そのまま 作成したプロジェクトのページ に着地。

未課金 — 広告主の 3 分岐

• サイドナビ常設: スキップ後でも「プラン / 課金」エントリからいつでも再起動可。
• 紹介クーポン: サインアップ時に保存した紹介者 ID があれば、standard 以上選択時にキックバック (詳細)。

② 初期構築依頼メール

a. 運用チーム宛メール

b. 広告主への自動返信メール (受付確認)

リクエスト送信と同時に広告主のメールアドレスへ自動返信。担当者対応開始までの空白時間に「受け付けたこと」を担保する。

---

⑤ 「チュートリアルを再開する」ボタン

チュートリアルが未完了の状態でダッシュボードに戻ってきた場合、ダッシュボード上部に 「チュートリアルを再開する」ボタン を表示。クリックで保存済の進捗 (tutorial_progress) を読み出し、最後にいたステップから ③ チュートリアル分岐に復帰する。

媒体接続 / CV 定義の未消化案内は別 UI (下記「ウィザード完了後の必須ステップ」を参照)。本ボタンは チュートリアル再開専用 で、他の設定タスクには使わない。

---

ウィザード完了後の必須ステップ

ウィザード本体はバナー初回生成で完了扱い。課金フローはチュートリアル完了直後に自動起動 (④)、媒体接続 / CV 定義 はダッシュボード上の設定タスク UI で順に消化。いずれも実配信開始までに必須。

CV 定義

📌 媒体接続後に初めて媒体側の CV イベント一覧が引けるため、媒体接続の後に置く順序は固定。

CV 未定義時の挙動

• KPI ダッシュボード: CPA / CVR 列に「CV 未定義」プレースホルダ、グラフ非活性
• 自動精査 / 運用アクション: 全アクション pending (CPA 倍率比較ができないため)
• 上位 2 位派生 / 言い換え: 勝ち判定 (cost 降順) は実行可、後段の予算アクションが止まる
• 媒体入稿: ブロック (CV 未定義での出稿不可)

---

関連フロー