メインコンテンツへスキップ
見出し画像

デザイナーがFigmaを一切使わずClaude Codeで体重・食事管理アプリを作った話

  • 割引あり


※ この記事は人間とclaudeが混じり合った文章であります


はじめに

「ダイエットをしないといけない」しないといけなくなった。
肥満度が3度になり、生きるためにはダイエットをしないといけなくなった。今回こそはダイエットをするため、健康になるため、メタボ外来へ行き先生や看護師さんの説教を受け、毎日食べるものを記録することになった。

もう何回も行ったダイエット。モチベーションを上げるために体重・食事管理アプリを自作することにした。無謀にもClaude Code を使って自分で作ることにした。

結果、以下のものが1週間程度で完成した。

  • 体重を毎日記録して目標と比較できる

  • 食事を4区分(朝・昼・夜・おやつ)で記録できる

  • バーコードをカメラで読み取って食品を登録できる

  • 商品パッケージを撮影するだけでOCRが栄養成分を読み取る

  • CSVで月次データをエクスポートできる

  • 管理画面で食品マスタを管理できる

コードをほとんど書かずに、ここまで作れた。

画像
こんな感じ

自己紹介

某ソーシング会社でプロダクトデザイナーとして働いている三児の母。社内デザイナーの中で一番AIを使ってる自負はある。
Next.jsはLP作れる程度で、Prismaは今回初めて使った。

個人開発は以下がある。


何を作ったか

カラダログ — 体重・食事管理アプリ

利用者向けアプリ

  • ログイン / 新規登録 / パスワードリセット

  • ホーム画面(今日の体重・目標進捗・食事サマリー)

  • 体重記録(日次・グラフ表示)

  • 目標設定(無理な目標には警告)

  • 食事記録(バーコード読取・料理検索・食品検索・手動入力)

  • CSV出力(月次)

画像

管理画面

  • 商品・材料・料理マスタの登録・編集

  • 商品登録時のOCR補助(栄養成分を自動読取)

  • CSV一括取込(2万件以上対応)

  • ユーザー管理(停止・有効化)

  • ダッシュボード(リアルタイムのマスタ件数表示)

画像
謎の英語は許してくれ

技術スタック

フロントエンド / バックエンド : Next.js 16 (App Router)
データベース                  : PostgreSQL(Neon)
ORM                          : Prisma 7
スタイル                     : Tailwind CSS v4
デプロイ                     : Vercel
画像保存                     : Vercel Blob
OCR                          : OpenAI gpt-4o-mini(Vision API)
バーコード読取                : react-zxing
認証                         : HMAC署名付きCookie

Vercelのエコシステムで完結させたのがポイント。
ローカル環境を最小限にして、デプロイまで一気通貫でできるようにした。


開発の流れ

STEP 1 — 仕様を固める

最初にopenAIに「体重・食事管理アプリを作りたい」と伝えて、
仕様書を一緒に作ることから始めた。

MVPでやること・やらないことを明確にするのが重要だった。

やること

  • 体重記録

  • 食事記録(バーコード読取)

  • 管理画面でマスタ管理

  • CSV入出力

やらないこと(最初は)

  • グラフ表示

  • ユーザー自身による食品登録

  • HealthKit連携

  • 課金機能

この「やらないこと」を決めるのが一番大事だった。
欲張ると終わらない。

STEP 2 — DBスキーマとAPI設計

openAIにDBのER図からAPIのエンドポイント定義まで、全部ドキュメントに落とした。
そしてCLAUDE.md という仕様書ファイルを作らせた。

画像
CLAUDE.mdの一部
users, weight_logs, user_goals,
meal_logs, meal_log_items,
products, ingredients, recipes, recipe_ingredients,
admin_users, password_reset_tokens

合計11テーブル。最初に設計を固めておいたおかげで、
後から「このデータどこに持つんだっけ」と迷わずに済んだ。

STEP 3 — 認証から実装

認証はセキュリティの要なので最初に作った。
最初はCookieにユーザーIDをそのまま入れていたが、
Claude Codeのコードレビューで指摘された。

「Cookieにuser_idを平文で保存するのはなりすましのリスクがあります。HMAC署名を使いましょう」

修正した。

// HMAC署名でCookieを保護
export function signId(id: string): string {
  const sig = createHmac("sha256", SESSION_SECRET).update(id).digest("hex");
  return `${id}.${sig}`;
}

こういうセキュリティの知識を勝手に補完してくれるのがClaude Codeの強み。

STEP 4 — バーコード読取の実装

カメラでバーコードを読み取る機能は正直ハードルが高かった。Claude Codeは react-zxing というライブラリを提案してくれた。

const { ref, torch } = useZxing({
  onResult(result) {
    if (hasScanned.current) return;
    hasScanned.current = true;
    router.push(`/meals/confirm?type=product&id=...`);
  },
});

ただ、Vercelへのデプロイ時にビルドエラーが出た。
react-zxing がReact 19に対応していなかった。

解決策は .npmrc に1行追加するだけだった。

legacy-peer-deps=true

こういう「あるある」な詰まりポイントもClaude Codeが即座に解決してくれた。

画像

STEP 5 — OCRで栄養成分を自動読取

管理画面の商品登録フローが一番楽しかった。

商品パッケージを2枚撮影する(バーコード面・栄養成分表示面)と、
OpenAIのVision APIが栄養成分を読み取ってフォームに自動入力してくれる。


画像
管理画面だけよ

最初はモデルが `gpt-5-mini`(存在しない)になっていたのをClaude Codeが
コードレビューで発見して修正してくれた。こういう細かいミスも拾ってくれる。

// 環境変数でモデルを切り替えられるように
model: process.env.OPENAI_MODEL ?? "gpt-4o-mini"

STEP 6 — ひたすら機能を積み上げる

あとはClaude Codeに「上から順に実装して」と指示するだけ。

  • 食事アイテムの削除・数量編集

  • 材料・料理のCRUD API

  • CSV取込(商品・材料・料理の3種別、upsert方式)

  • パスワードリセット(DBトークン管理)

  • ユーザー管理画面

指示の出し方はシンプルで、

「残りの未実装機能を上から順に実装してください」

と言うだけで、優先順位を考えながら実装してくれた。

STEP 7 — 食品データを充実させる

アプリができても、食品マスタが空では使えない。
文部科学省が公開している「日本食品標準成分表」(約2,500件)を取り込むことにした。

CSVの構造が複雑で、12行分のヘッダー・食品グループコード・特殊文字(< > [ ])などの前処理が必要だった。
Claude Codeにこう頼んだ。

「このCSVを材料・商品・料理の3種別に分けて、
 アプリのインポート用フォーマットに変換するPythonスクリプトを作って」

食品グループに応じた分類ロジック:

  • グループ18(調理済み流通食品類) → 料理マスタ

  • グループ15・16(菓子類・飲料類)→ 商品マスタ

  • それ以外 → 材料マスタ

スクリプト1本で約2,500件のデータが整形できた。

STEP 8 — 食事追加UIを統合検索に刷新

当初は「バーコード」「料理から追加」「食材から追加」の3ボタン選択UIだったが、シンプルさを優先して統合検索1本に変えた。

Before(3ボタン選択)

[バーコードで追加]
[料理から追加]
[食材から追加]

After(検索ファースト)

[🔍 料理名・商品名で検索    ▣]
                           ↑ バーコードは右端に小さく

料理・商品・Myメニューを統合検索して一覧表示。
バーコードは「補助機能」として検索バー右端のアイコンに格下げした。

検索結果が0件のときは詰まらないよう「手動登録」導線を用意:

見つかりませんでした
商品名を変えて検索するか、手動で登録できます

[ 商品を手動登録 ]   ← 全ユーザー使える
[ 料理を登録 ]       ← 管理者のみ ※ただいま検証中のため

最初は0件時のみボタンを出していたが、「近い商品はあるけどこのブランドのやつがない」というケースもあるため、検索バー直下に常時表示する形に変えた。検索中・結果あり・0件を問わず常にアクセスできる。

[🔍 料理名・商品名で検索        ▣]
[ + 商品を手動登録 ]  [ ✓ 料理を登録(admin) ]  ← 常時表示

STEP 10 — 検索精度の改善

「醤油」で検索したら「2段仕込み醤油香るイカ唐揚げ」が上位に来てしまう問題があった。中間一致なのに前方一致より上に出るのは直感に反する。

PostgreSQLの "ORDER BY CASE WHEN" で優先度を付けた:

ORDER BY
  CASE
    WHEN name ILIKE '醤油'      THEN 0  -- 完全一致
    WHEN name ILIKE '醤油%'     THEN 1  -- 前方一致
    ELSE                               2  -- 部分一致
  END,
  name ASC

これで「醤油」を検索すると「醤油(○○メーカー)」が上位に来るようになった。

STEP 11 — ひらがな検索対応(読み仮名カラム追加)

「しょうゆ」と入力しても「醤油」がヒットしない問題。
PostgreSQLの "ILIKE" はひらがな・漢字の変換ができないため。

解決策として "name_kana"(読み仮名)カラムをDBに追加した:

model Product {
  name     String
  nameKana String? @map("name_kana")  // ← 追加
  ...
}

検索SQLを "name OR name_kana" の両方で引くように変更:

WHERE name ILIKE '%しょうゆ%'
   OR name_kana ILIKE '%しょうゆ%'

CSVインポートに10列目として「読み仮名(カタカナ)」を追加。
既存CSVは10列目を省略すれば壊れないので後方互換性も保てる。

STEP 12 — 料理登録を仕様通りの2ステップフローに修正

最初に実装した「料理を登録」は、栄養値を手打ちするだけの簡易フォームだった。使ってみると「これ商品登録と同じじゃないか」と気づいて仕様書を読み返した。

CLAUDE.md には明確に材料ベースの2ステップが書いてあった。

STEP 1 — 食材検索

  • 食材名で検索、+ボタンで追加

  • 追加済みはチェックマーク表示

  • 「追加を確認(N件)」で次へ

STEP 2 — 確認・登録

  • 料理名入力

  • 食材ごとにg数を変更(変更するとkcalが即時再計算)

  • 不要な食材を削除

  • 「+食材を追加」でSTEP1に戻れる

  • 「登録して追加」でMyメニュー保存+食事に追加

// g数変更時にkcalをリアルタイム再計算
function calcTotals(items: AddedIngredient[]) {
  return items.reduce((acc, ing) => {
    const ratio = ing.amountG / ing.baseAmount;
    return { kcal: acc.kcal + ing.nutrition.energyKcal * ratio, ... };
  }, { kcal: 0, ... });
}

仕様書を書いておいたことで「これは違う」とすぐ気づけた。
"CLAUDE.md" は実装の正解を確認するための参照元として機能した。

STEP 13 — 商品の一括削除

不要な商品データを削除したいときの手段として、
これまでは「置き換えモード(バーコードにないものを全部非表示)」しかなかった。ただしバーコードのない商品もあるため使い勝手が悪かった。

そこで「削除CSVアップロード」機能を追加した:

  1. エクスポートCSVに "id" 列を追加(1列目)

  2. ExcelやSpreadsheetで削除したい行だけ残す

  3. 管理画面の「商品を一括削除」にアップロード

  4. CSVの "id" 列を読み込んで "is_active = false" に更新

// クライアントでCSVをパースしてIDだけ抽出
const ids = rows.slice(1).map((r) => r[0]).filter(Boolean);
await fetch("/api/admin/v1/imports?type=products", {
  method: "DELETE",
  body: JSON.stringify({ ids }),
});

バーコードの有無に関係なく全商品で使えるようになった。


詰まったポイントと解決策

① Vercelビルドエラー(useSearchParams)

Next.js App Routerでは "useSearchParams()" を使うページは
"<Suspense>" でラップしないとビルドが通らない。

6画面が一気にエラーになって焦ったが、
Claude Codeが全画面を一括で修正してくれた。

② react-zxing のReact 19非対応

前述の通り。".npmrc" で解決。

③ Prismaクライアントの型が更新されない

スキーマを変更してマイグレーションした後、
型エラーが出た。"prisma generate" を実行し忘れていた。

npx prisma generate

④ OCRのJSONパースエラー

OpenAI APIのレスポンスをJSONパースする処理が壊れやすかった。
Claude Codeが "try/catch" を分けて安全に処理するよう修正した。

⑤ 2万件CSVインポートがタイムアウトする

文科省の食品データ(約2,500件)や OpenFoodFacts Japan(約2.7万件)を取り込もうとしたら、Vercelの10秒タイムアウトに引っかかってフリーズした。

解決策は「クライアントサイドでCSVをパースして100行ずつ送る」チャンク方式。

// ファイルをサーバーに送る代わりにブラウザでパース
const rows = parseCSVText(text);
for (let i = 0; i < rows.length; i += CHUNK_SIZE) {
  const chunk = rows.slice(i, i + CHUNK_SIZE);
  await fetch("/api/admin/v1/imports", {
    method: "POST",
    body: JSON.stringify({ header, rows: chunk, offset: i }),
  });
  setProgress({ done: i + chunk.length, total: rows.length });
}

進捗バー付きで「取込中... 500 / 27,040件」と表示されるようになった。

また、商品データの登録は1件ずつINSERTするのではなく、
PostgreSQLのバルクupsertに変更してさらに高速化した。

INSERT INTO products (...) VALUES (...)
ON CONFLICT (barcode) DO UPDATE SET name = EXCLUDED.name, ...

⑥ 検索で関係ない商品が上位に来る

「醤油」で検索したら「〜醤油〜仕立て唐揚げ」ばかり出てきた。
"ILIKE "%醤油%'" は全商品を部分一致で拾って "ORDER BY name ASC"するだけなので、アルファベットや数字から始まる商品が上位に来てしまう。

→ "CASE WHEN" を使った前方一致優先ソートで解決(上記STEP 11参照)。

⑦ ひらがなで打っても出てこない

「しょうゆ」と検索したら0件。漢字の「醤油」しかヒットしない。
PostgreSQLには日本語の読みを変換する機能がないため、
データ側で読み仮名を持つしかない。

→ "name_kana" カラムを追加してCSVで一括登録できるようにした(上記STEP 11参照)。

⑧ レシピCSVで「材料が見つかりません」エラー

料理CSVのインポートで "材料「81.0」が見つかりません" というエラーが出た。

原因:文科省データから変換した料理CSVは材料名ではなく栄養値が直接入っていた。
対応:col2が数値なら「直接栄養値モード」として材料ルックアップをスキップするよう実装した。

⑨ 検索APIが本番環境で500エラー

ローカルでは動いていた検索APIが、Vercel本番で突然500エラーになった。

GET /api/v1/search?keyword=カレー → 500 Internal Server Error

原因は raw SQLの中に書いた "::uuid" キャスト:

-- NG: user.id は CUID 形式(clxxxxxxxx)なので uuid にキャストできない
AND (user_id IS NULL OR user_id = ${user.id}::uuid)

ユーザーIDに"@id @default(cuid())" を使っていたが、
PostgreSQLの "::uuid" キャストは UUID フォーマット(ハイフン区切り)しか受け付けない。
ローカルでは Prisma ORM 経由のクエリしか使っておらず、raw SQL で初めてこの問題が露出した。

-- OK: キャストを外すだけで解決
AND (user_id IS NULL OR user_id = ${user.id})

教訓:raw SQL を書くときは型の前提を確認する。
ORM が隠蔽していたことが raw SQL では素直に出てくる。


Claude Codeを使って感じたこと

良かったこと

コードレビューが優秀
「セキュリティ上の問題がある」「このAPIモデルは存在しない」
「このパターンはNext.js App Routerでは動かない」
など、自分では気づかないミスを拾ってくれた。

技術選定を任せられる
「バーコード読取を実装したい」と言えば、適切なライブラリを選んで
実装までしてくれる。自分で調べる時間が激減した。

コンテキストを保持してくれる
`CLAUDE.md` に仕様を書いておくと、セッションをまたいでも
「このプロジェクトの方針」を理解した上でコードを書いてくれる。

気をつけること

仕様を曖昧にしない
「いい感じに作って」は通じない。
「何を・誰のために・どう動くか」を明確に伝える必要がある。

ビルドエラーは自分でも読む
エラーメッセージをそのまま貼り付ければ解決してくれるが、
何が起きているか理解しながら進めると後で困らない。

セキュリティは任せすぎない
Claude Codeが大元実装してくれたので、QA的なチェックとセキュリティチェックをこまめに行った。任せ過ぎはよくないよ!
認証・認可まわりは自分でも理解して実装するべき。


完成したもの

[📸 画像: アプリ全画面のスクリーンショット一覧]

主要な画面:

  • ホーム(今日の体重・目標・食事サマリー)

  • 体重記録(棒グラフ・バリデーション付き)

  • 目標設定(無理な目標への警告モーダル)

  • 食事記録(バーコード読取・料理検索・食品検索・手動入力・PFC表示)

  • Myレシピ(食事内容をセット保存・次回ワンタップ入力)

  • 管理画面(OCR補助・CSV取込・リアルタイムダッシュボード)


次にやること

今は無料でユーザーに使ってもらい不具合等ぜひ教えてください。要望もくれると直します!https://x.com/466548 にご連絡を。

近日中の実装予定:

  • PWA対応(ホーム画面にインストール可能に)

  • OGP設定(SNSシェア時に画像を表示)

  • 体重グラフ強化(週・月単位)


まとめ

コーディング経験がそこまでなくても、
Claude Codeを使えばここまで作れる時代になった。

ポイントは3つ。

  1. 仕様を最初に固める(CLAUDE.mdに書く)

  2. MVPを小さく定義する(やらないことを決める)

  3. エラーはすぐ貼り付ける(解決が速い)

「アプリを作ってみたい」と思っている人の参考になれば嬉しい。


この記事が参考になったら、スキ・フォローしてもらえると励みになります。最後に補足のプロンプト例を置いときます。ほんと大したプロンプトではありません。9000文字超えのチップとして下さったら泣いて喜びます。

 
 

taz

 
 
17年12月生の長女と19年11月に爆誕早産次女と三女の育児忙しいUI/UXデザイナー。実は黒い画面も嫌いではない。

あなたへのおすすめ