LUMINA AI売上分析ダッシュボード

毎月の売上レポート作成に時間を取られているアパレルEC様等の店舗運営者様・経営層様（架空クライアント アパレルEC「LUMINA」を想定）

月次レポート作成(グラフ作成・数値集計・コメント執筆)に毎回3時間かかり、翌月のアクション提案も感覚頼りになっていた(架空クライアント アパレルEC「LUMINA」を想定)。

CSVアップロード→Supabaseへの蓄積→KPI自動計算→Claude APIの構造化出力(JSON Schema)によるAI分析コメント生成という一気通貫のパイプラインを設計し、AI・データ分析に詳しくない経営層でも数値の意味を数十秒で理解できるダッシュボードとして提案した。

• →Next.js App Router + TypeScriptでCSVアップロード〜KPI集計〜AI分析までのAPIを構築
• →PapaParseで全行事前検証するCSVバリデーション(行番号つきエラー返却)を実装
• →Supabaseにcsv_imports / sales_transactions / ai_analysesの3テーブルを設計し、月次データを蓄積する構成に
• →Claude APIのoutput_config(JSON Schema)で構造化出力を強制し、パース失敗しない分析コメント生成を実現
• →AI分析結果をアプリ側でも型検証する二重防御を実装し、Vitestのスナップショットテストで回帰を検知
• →GitHub Actions(TypeCheck→Lint→Test→Build)とVercelのGit連携による自動デプロイ(CI/CD)を構築

要件定義〜DB設計〜API実装〜AI連携〜CI/CD構築〜本番デプロイまで一貫対応

• ✓CSVアップロードからAI分析コメント生成までを実データでE2E検証(ローカル・本番URL双方)
• ✓月次レポート作成時間を3時間→数分規模に短縮する設計を実現
• ✓APIキー等のシークレットをコードに一切含めない設計とし、Vercel環境変数のみで運用
• ✓GitHub Actions CIとVercel本番デプロイまで公開済み