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

思いつきだけで、BtoB受発注ECを丸ごと作ってみた ― Claude Codeと二人三脚の開発記|MIT:#3

    はじめに

    「受発注の業務を、ちゃんと画面と帳票で回せる“自分のシステム”が欲しい。売る人・買う人・管理する人がいて、注文が承認から出荷・請求・入金まで流れて、最後は請求書までPDFで出てくるやつ」

    ——そんな“ひとつの思いつき”から始めて、Claude Code と一緒に、BtoBの受発注ECを本当に丸ごと作ってしまった話を書きます。

    作ったアプリの名前は WebEC。まずは、実際にできあがった画面から。

    画像
    ログイン画面
    画像
    管理者画面
    画像
    商品検索画面

    (ターコイズグリーン基調でシックに。左が入口のログイン、下が購買者の商品一覧。検索も画像もちゃんと動きます)

    そして念のため——私はコードをほとんど書いていません。 やったのは、日本語で“こういうの欲しい”と伝え続けただけです。


    1. 最初にあったのは「素案」だけ

    立派な仕様書があったわけではありません。あったのは、メモ帳に書き出した素案だけ。だいたいこんなことです。

    • 会員は 管理者・販売者・購買者 の3ロール。見える画面をそれぞれ出し分けたい。

    • 購買者は 商品を探す → 申請 → 受領確認 → 入金 ができる。

    • 販売者は 商品・在庫を管理 → 注文を承認・出荷・請求できる。

    • 管理者は 入退会の承認・マスタ管理・ログ監査ができる。

    • 注文は勝手に飛ばせない。在庫が足りなければ承認できない、みたいな“業務のルール”を効かせたい。

    • 見た目は ターコイズグリーンでシステマティックに。

    • そして最後、注文書・納品書・請求書をPDFで出したい(ここ大事)。

    ……我ながら欲張りです。でも「やりたいこと」だけは、はっきりしていました。


    2. Claude Code と“壁打ち”しながら設計する

    この素案を Claude Code に渡して、まず仕様書のかたちに正規化してもらいました。ここからが面白い。

    私が「注文って、途中で勝手にキャンセルされたら困るよね?」と投げると、注文ステータスを一本道の状態遷移として設計し直してくれる。頭の中にあった流れが、そのまま番号付きの段階になっていきました。

    申請 → 承認 → 受注 → 出荷 → 納品 → 受領確認 → 請求 → 入金確認(=完了)/ 途中でキャンセル。

    “考えるのは私、実装と整合性チェックは Claude Code” という分担が、とにかく速い。

    さらに私が「承認したら在庫を“引き当て”て確保して。キャンセルしたら戻して。出荷したら実際に減らして」と注文すると、在庫の増減ルールまで一箇所に集約してくれる。

    しくみ(簡易データフロー)

    言葉だけだと伝わりづらいので、全体の流れを一枚に。

    画像
    簡易データフロー

    ポイントは、注文がどの段階でも“決まった順番”でしか進まないこと。そして各段階で、対応する帳票(注文書・納品書・請求書…)が発行できるようになっています。

    構成そのものは、拍子抜けするほどシンプルです。

    画像
    開発環境・指示系統

    私は言葉で指示するだけ。Claude Code がコードもテストも書いて動かし、できるのは普通のWebアプリ+DB+ファイル。それだけ。


    3. 思いつきが、どんどん機能になる

    作りながら、次々と「あ、これも欲しい」が出てきます。そのたびに実装され、テストが増え、画面が育っていきました。

    • 商品を選ぶなら詳細ページが要る → 画像をクリックで拡大するビューアー(左右送り・拡大縮小つき)

    • 売り買いには連絡がつきもの → 注文ごとのメッセージ(画像添付もOK)

    • 規約もちゃんと → プライバシーポリシーを日本語・英語・中国語で切替

    • 処理が重いと不安 → ローディングのアニメーションで「今動いてます」を可視化

    • 毎回ログインが面倒 → デモ用のテストデータを自動投入(販売者2社・購買者2名・注文も各ステータス分)

    画像
    商品検索

    そして販売者の注文処理画面がこれ。今の状態に合わせて、押せるボタンが変わるのがミソです。

    画像
    注文画面

    「ここ、こうしたい」と日本語で言うだけで形になる。この“かゆいところに手が届く”感じが、Claude Code との開発のいちばんの気持ちよさでした。


    4. 最大の“詰まり”は、ロジックじゃなかった

    一番てこずったのは、業務ロジックでも画面でもなく——帳票の、日本語でした。
    意気揚々と請求書PDFを出してみたら、こう。

    請求書:??? ??? ?????
    

    全部「?」。文字化けです。 中身の計算は合っているのに、PDFに日本語フォントが乗っていなくて、漢字もかなも全滅していました。
    PDFの日本語って、フォント埋め込みやら消費税の区分計算やらで、地味に沼なんですよ。ここで心が折れる人、たぶん多い。
    Claude Code に「日本語がちゃんと出る帳票にして。ついでに社章の透かしも入れて」とお願いして、原因を一つずつ潰していく。日本語フォントをPDFに埋め込み、透かし画像を重ね……そして出てきたのが、これです。

    画像
    請求書

    ……いや、ちゃんとしてる。 ちゃんとしすぎてる。

    • ✅ 日本語がきれい(フォントを埋め込み済み)

    • ✅ 宛先・発行元・明細がビシッと整列

    • ✅ 消費税を税率ごとに区分集計(軽減8%対象◯円…)

    • ✅ 右下に社章の透かし

    • ✅ 下に発行管理番号と枝番(何回目の発行かの証跡)

    しかも「発行のたびに番号を採番、30分だけダウンロード可、期限切れたらPDF本体は消す(履歴は残す)」という運用ルールまで込み。

    「???」だった帳票が、そのまま現場に出せそうな請求書になった瞬間は、正直「おー、きた!」と声が出ました。この記事でいちばん見てほしいのは、ここです。


    5. できあがったもの

    気づけば、メモ帳の素案が“動く業務システム”になっていました。

    • 3ロール(管理者・販売者・購買者)で見える画面を出し分け

    • 注文の状態遷移(申請→…→完了/キャンセル)と在庫の引当・減算

    • 商品・在庫・カテゴリ・税率・サイト設定の管理

    • 画像ビューアー/注文メッセージ(添付可)/多言語の規約ページ

    • ログイン履歴・操作ログの監査

    • そして 注文書・納品書・受領証・請求書のPDF帳票(日本語・税区分集計・透かし・発行番号つき)

    • 自動テスト一式・SQLite/SQL Server切替・デモデータ自動投入まで

    既製のパッケージをカスタマイズしたのではなく、発想から設計・実装・帳票まで一気通貫で作れた、という手応えが新鮮でした。


    おわりに ― このシリーズについて

    「Claude Code × 業務アプリ」は、頭の中の“こういうの欲しい”を起点に、自分だけのシステムを形にしていく記録シリーズです。

    次回は、この受発注ECに 売上ダッシュボードや通知あたりを足してみたいですね。

    「思いつきを、そのまま動くものにする」。その面白さが、少しでも伝わっていたら嬉しいです。

    スクショ・帳票はすべて、実際に動くデモ環境のものです(データはダミー)。

    © 2026 TwinTail company


    また、次のアプリで。

     
     
    ツインテールカンパニーのコウです! 作詞や心の声、趣味や勉強、旅行といったことや心理学的なことをも投稿しています♪ 祝!ここからAIキャラクターが生まれました★ PG・SE 13年目でBPDの寛解中であったりしています★ #趣味 #旅行 #写真 #心理学 #自己成長

    あなたへのおすすめ