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

【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と一緒に設計書を作ることでした。

    これが設計書の構成です。

    1. ビジネス要件定義書(業務フローをMermaid図で可視化)

    2. データベース設計書(ER図とテーブル定義)

    3. API設計書(エンドポイント、エラーコード、レスポンス形式)

    4. フロントエンド設計書(画面構成とワイヤーフレーム)

    5. テスト・セキュリティ計画書

    この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で予約したとします。このとき、以下が同時に起きます。

    1. タイムブロックに「3/20 10:00-12:00 = 予約済み」が作成される

    2. ブロック枠に、田中さんの他の全取引先に対して「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カレンダーとの連携です。

    仕組みとしては:

    1. 事業者がGoogleアカウントを連携

    2. 案件が確定すると、自動でGoogleカレンダーにイベントが作成される

    3. 逆に、Googleカレンダーに手動で入れた予定も、システム側に反映される(双方向同期)

    4. 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と一緒に作ってみてください。

     
     
    エンタープライズAI導入のプロ|M365・Azure基盤設計からRAG・AIエージェント開発まで一気通貫で手がけるフリーランスエンジニア|Claudeヘビーユーザー|AI×ビジネスの最前線を毎日発信

    あなたへのおすすめ