
【Claude Code 体験記】「業務管理SaaS」をたった1日で作った全記録
「業務管理システムを1日で作った」
こう言うと、だいたい2つの反応が返ってきます。
「嘘でしょ」か、「どうせショボいやつでしょ」。
どちらも違います。
バックエンドAPI 10本以上、フロントエンド15画面、PostgreSQL 6テーブル、Googleカレンダー双方向同期、ロールベースのアクセス制御、ダブルブッキング自動防止、Redis キャッシュ、非同期ジョブキュー──。
これを1日で作りました。使ったのは、Claude Code。
この記事は、その全記録です。
何を作ったのか
複数の取引先とやり取りする事業者が、スケジュールと案件を一元管理するためのシステムです。
取引先が増えてくると、スケジュール管理がカオスになります。A社から「3月20日の午前、空いてますか?」と連絡が来て、B社からも同じ日に依頼が来る。LINEとメールとカレンダーを行ったり来たりして、ダブルブッキングしないか毎回ヒヤヒヤする。
このストレスを丸ごと解消するシステムを、1日で形にしました。
できること
取引先側:
事業者の空き状況をカレンダーで確認(日・週・月表示)
案件リクエストの送信・変更・キャンセル
月別ダッシュボードで状況を一覧
事業者側:
全取引先の案件を一つのカレンダーで統合管理
リクエストの承認・拒否
プライベートの予定をブロック(全取引先に自動反映)
Googleカレンダーとの双方向同期
複数の業務カテゴリを独立したスケジュールで管理
システムが自動でやること:
ダブルブッキングの完全防止
承認待ち案件の24時間自動キャンセル
Googleカレンダーへの自動反映
「1日で作った」と言われると軽く聞こえるかもしれませんが、中身はかなり本格的です。
なぜ1日で作れたのか
結論から言います。
設計書を先に作ったからです。

多くの人が「Claude Codeにお願いすれば何でも作ってくれる」と思っています。半分正解で、半分間違いです。
「業務管理システム作って」と丸投げしても、AIは何を作ればいいか迷います。結果、的外れなものが出てきて、修正のやりとりで時間が溶ける。
僕がやったのは、最初にClaude Codeと一緒に設計書を作ることでした。
これが設計書の構成です。
ビジネス要件定義書(業務フローをMermaid図で可視化)
データベース設計書(ER図とテーブル定義)
API設計書(エンドポイント、エラーコード、レスポンス形式)
フロントエンド設計書(画面構成とワイヤーフレーム)
テスト・セキュリティ計画書
この5つの設計書がなぜ1日開発を可能にしたのか。そしてダブルブッキング防止やGoogleカレンダー連携をどう実装したのか。ここから先は、その具体的な中身をすべて公開します。
設計書があると、Claude Codeへの指示が「要件定義書の3.2節のフローを実装して」みたいに具体的になります。曖昧さがなくなるので、AIのアウトプット精度が段違いです。
設計書は「AIへの最高の指示書」。これが1日開発の最大の秘訣です。
技術スタック
技術選定もClaude Codeと相談しながら決めました。
【バックエンド】
・Hono + TypeScript
・Drizzle ORM(型安全なORM)
・PostgreSQL
・Redis + BullMQ(キャッシュ/ジョブキュー)
【フロントエンド】
・Next.js 15 + Tailwind CSS
・Zustand + TanStack Query
・Supabase Auth
【外部連携・インフラ】
・Google Calendar API
・Docker + Vercel + Supabase
正直に言うと、僕が選んだというより、要件を伝えたらClaude Codeがこの構成を提案してくれて、「じゃあそれで」と進めた感じです。結果的にはかなり良い選択だったと思います。
ダブルブッキング防止:データベース設計の核心

技術的に一番面白かったのは、ダブルブッキング防止の仕組みです。
テーブル構成はこうなっています。
事業者
↓ 1:N
契約 ── 取引先
↓ 1:N
案件
↓ 1:1
タイムブロック
↓ 1:N
ブロック枠(他社用)
ポイントは「タイムブロック」と「ブロック枠」の2つのテーブルです。
たとえば、A社が事業者の田中さんを3月20日10:00-12:00で予約したとします。このとき、以下が同時に起きます。
タイムブロックに「3/20 10:00-12:00 = 予約済み」が作成される
ブロック枠に、田中さんの他の全取引先に対して「3/20 10:00-12:00 = ブロック」が自動作成される
B社が田中さんの空き状況を見たとき、3/20の10:00-12:00は「予約不可」と表示されますが、「誰が予約しているか」は見えません。プライバシーが守られた状態でダブルブッキングが防止されます。
PostgreSQLの EXCLUDE 制約を使って、データベースレベルで時間の重複を弾いているので、どれだけ同時にリクエストが来ても競合しません。
この設計もClaude Codeが提案してくれました。「ダブルブッキングを絶対に防ぎたい」と伝えたら、トランザクションと排他制約を組み合わせた設計が出てきました。
業務カテゴリ別の独立スケジュール(v1.0→v2.0)
最初のバージョン(v1.0)は、事業者1人につき1つのスケジュールでした。
でも実際の運用を考えると、業務カテゴリが複数ある場合、カテゴリごとに独立してスケジュールを管理したいケースがあります。
午前中にカテゴリAの案件が入っていても、午後にカテゴリBの案件は受けたい。業務内容が違えば、同じ時間帯でも対応できる場合がある。
v2.0では、すべてのテーブルに業務カテゴリのカラムを追加して、カテゴリごとに独立したスケジュール管理ができるようにしました。
ただし「プライベートの予定」だけは全カテゴリ共通でブロックされます。休みの日は、どの業務でも働きたくないですからね。
このv1.0→v2.0の移行も、Claude Codeに「カテゴリ別に独立させたい」と伝えたら、影響範囲の洗い出しからマイグレーションファイルの作成まで一貫してやってくれました。
ロールベースの画面設計
フロントエンドは Next.js 15 の App Router を使っています。
ログインしたユーザーの役割(ロール)によって、まったく別の画面が表示されます。
取引先でログインすると、ダッシュボード・案件一覧・空き状況検索の画面が表示されます。事業者でログインすると、業務カテゴリごとにダッシュボード・案件一覧・承認待ちの画面が切り替わります。
認証にはSupabase Authを使っていて、ログイン・サインアップ・パスワードリセットの画面もClaude Codeが作ってくれました。OAuthでGoogleログインにも対応しています。
Googleカレンダー連携:地味に大変だった

個人的に一番苦労したのは、Googleカレンダーとの連携です。
仕組みとしては:
事業者がGoogleアカウントを連携
案件が確定すると、自動でGoogleカレンダーにイベントが作成される
逆に、Googleカレンダーに手動で入れた予定も、システム側に反映される(双方向同期)
Vercelのcronジョブで1時間ごとに同期
Google OAuth2の認証フロー、アクセストークンのリフレッシュ、カレンダーAPIの呼び出し、BullMQでの非同期処理……と、裏側でやっていることが多くて、ここはClaude Codeに頼りっぱなしでした。
「Googleカレンダーと同期したい」と一言伝えれば全部やってくれるわけではなく、OAuth2のクライアントIDの取得やリダイレクトURIの設定など、自分でGoogle Cloud Consoleを操作する部分もあります。
ただ、「次に何をすればいいか」をClaude Codeが逐一教えてくれるので、迷うことはなかったです。
セキュリティ:見えない部分こそ大事

業務管理システムは、他社の案件情報が漏れたら大問題です。
セキュリティ面では以下を実装しています。
JWT認証:APIリクエストごとにトークンを検証
ロールベースアクセス制御:取引先スタッフは自社の案件しか見えない。事業者は自分の案件だけ
Row Level Security(RLS):データベースレベルでアクセス制御。アプリにバグがあっても、他社のデータは物理的に取得できない
入力バリデーション:Zodスキーマで全入力を検証。不正なデータはAPIに到達する前に弾く
Claude Codeに「このシステムのセキュリティで足りないところはある?」と聞いたら、RLSの導入やエラーコードの統一など、自分では思いつかなかったポイントを提案してくれました。
キャッシュと非同期処理
ユーザーには見えませんが、裏側ではパフォーマンスのための工夫もしています。
Redisキャッシュ: 空き状況は頻繁にアクセスされるので、Redisにキャッシュしています(5分間のTTL)。案件が入ったり変更されたりすると、該当する日付のキャッシュだけが無効化されます。
BullMQバックグラウンドジョブ:
Googleカレンダーの同期
24時間経過した承認待ち案件の自動キャンセル
通知処理
これらはAPIのレスポンスをブロックしないよう、バックグラウンドで処理されます。
1日開発を再現するためのポイント
最後に、Claude Codeで1日開発を成功させるために大事だと感じたことをまとめます。
1. 設計書を先に作る
これが全てと言ってもいいです。設計書がないClaude Code開発は、地図なしで知らない街を歩くようなものです。
2. 「何を作るか」は人間、「どう作るか」はAI
技術選定、設計パターン、エラーハンドリングの方針……「どう作るか」はClaude Codeの方が引き出しが多いです。人間は「ダブルブッキングを防ぎたい」「他社の案件は見せたくない」という「何を作るか」に集中する。この役割分担がうまくハマると、開発のスピードと品質が両立します。
3. エラーはそのまま見せる
エラーが出たら、メッセージをそのままClaude Codeに見せる。「ここが原因です」と即答してくれます。自分でStack Overflowを検索する時間がゼロになります。
4. 「その修正で他に影響ない?」と聞く癖をつける
AIの提案をそのまま受け入れるのではなく、副作用を確認する。これだけで、後から手戻りになる確率が大幅に下がります。
5. v1.0で動かしてからv2.0にする
最初から完璧を目指さない。まずシンプルな形で動くものを作って、そこから機能を追加していく。Claude Codeは「ここを拡張したい」と伝えれば、影響範囲を分析して安全に拡張してくれます。
プロジェクトの全体像

【プロジェクト規模】
・開発期間:1日
・バックエンドAPI:10以上のエンドポイント
・データベース:6テーブル + 排他制約 + インデックス
・フロントエンド画面:15画面以上(ロール別)
・設計書:7ドキュメント
・外部連携:Google Calendar API、Supabase Auth
・インフラ:Docker + Vercel + Supabase
1日でこの規模のものが形になるとは、自分でも驚いています。
Claude Codeがいたからこそ、「こういうものが欲しい」というビジョンを形にできました。興味がある方は、ぜひ小さなプロジェクトからClaude Codeと一緒に作ってみてください。