Demo から正式版への移行

文書目的

この文書は、現在の demo を実プロジェクトへ段階的に移行する際に必要な主要作業を整理するものです。

現在の Demo の性質

現在のフロントエンド構造は安定していますが、業務データは demo 主導です。

現在の特徴:

• ページ構造は実装済み
• フロー体験は表示可能
• データと状態は主に local mock と storage に依存
• 実バックエンド連携は未実装

改造作業の全体像

第1段階: 製品定義の固定

目標:

• 実業務範囲の確定
• MVP 範囲の確定
• ユーザーロールの確定

必要成果物:

• 機能一覧
• 画面フロー
• データエンティティ一覧
• API 一覧

第2段階: バックエンド基礎能力

優先能力:

• ユーザーと認証
• コース体系
• lesson と assessment
• 宿題記録
• 通知
• イベント申込
• 注文と支払い

第3段階: フロントエンドの実 API 適用

必要作業:

• services/ に実 API 呼び出しを追加
• エラー処理
• ローディング状態
• 空状態と異常状態
• 開発用 mock の限定保持

第4段階: 管理画面構築

対象モジュール:

• 受講生管理
• コース管理
• スケジュール管理
• lesson 管理
• assessment 管理
• 宿題と講評管理
• イベント管理
• 通知配信管理
• 注文管理
• 会員管理

現在のコード置換ポイント

1. mock/

現在:

• demo データを保存

移行後:

• 開発用 fixture に縮小
• 本番環境の主データ源にしない

2. store/ の demo 状態

現在:

• 購入、既読、申込、提出などの状態を模擬

移行後:

• 一部はバックエンド返却値に置換
• フロントは UI 一時状態とキャッシュを保持

3. services/

現在:

• demo データ問い合わせ入口

移行後:

• 実 API の適配層
• バックエンドデータを画面 view model に変換

4. packages/types

現在:

• 安定したフィールド契約

移行後:

• 実 API payload と整合
• 前後端共有契約へ拡張