
「さがせる営業日報」ができるまで(制作記)AIに頼めばすぐアプリができる、は本当か? 営業日報アプリ制作の「泥臭い」中身
はじめに
「AIに頼めば、Webアプリなんてすぐにできる」。そう思っている方は多いのではないでしょうか。
私はAIにコードを書いてもらう開発(バイブコーディング)を、2年ほど続けています。今回も、Googleスプレッドシートで動く営業日報のWebアプリ「さがせる営業日報」を、AI(Claude Code)と作りました。コードは1行も書いていません。書いたのはすべてAIです。

ただ、2年続けていても、「頼んだら一発でできた」という場面はほとんどありません。今回もそうでした。画面を触って、おかしなところを見つけて、伝えて、直ったか確かめる。その地道な繰り返しです。この記事は、AIでWebアプリを作ったことがない方に向けて、その「泥臭い」中身を、実際に送った指示とAIの回答でお見せするものです。これから試してみようと思っている方が、始める前に知っておくと楽になることを書いたつもりです。なお、私の自己紹介は【ブイヨンの自己紹介】に書きました。ITエンジニアではありませんが、AIと一緒に、GASでいくつもの道具を作ってきました。
先に数字をお見せします
かかった時間:約16時間(休憩を含みます。仕様書を作った時間は含めていません)
AIに送った指示:約110回
そのうち「更新してよい」:35回
版の番号:v1.0.0 → v2.15.1
約110回の指示のうち、「こういう機能がほしい」という新しい頼みごとは、実は多くありません。ほとんどは「ここが動かない」「ここの見た目が変」「これはどういう意味?」です。
「更新してよい」の35回については、手順5で説明します。
やっていることは、7つの手順の繰り返しです
今回やったことを括ると、次の7つの手順になります。
準備する:何を作るか仕様書にまとめ、作業できる環境を整える
作ってもらう:仕様書を渡して、AIにコードを書いてもらう
本物で触って確かめる:仕様書に書いたことが本当にできるか、自分の手で確かめる
伝えて、直してもらう:困ったことを、言葉と写真で伝える
公開して、もう一度触る:直した版を公開して、また確かめる
手順書どおりにやってみる:使う人の立場で、最初から通してみる
決める:仕様書をどう変えるかを決めるのは、人
手順2は1回で終わります。泥臭いのは手順3〜5で、ここを35回まわしました。以下、手順ごとに、仕様書のどこをやろうとして、何が起きたかを、実際に送った指示とAIの回答でお見せします。
手順1:準備する
仕様書を書く
最初に、何を作るかを仕様書にまとめました。中身はおおよそ次のとおりです。
商品の約束:「Excelにしただけの日報を、探せる・数えられる日報に。様式は今のまま」
基本版の範囲:入力・検索・集計・帳票(PDF)・ログインの5つ。写真や通知は後回し
データの持ち方:日報1枚ではなく「訪問1件=1行」で貯める。だから顧客ごとに探せる
画面:入力・検索・集計・帳票・管理の5つのタブ。スマホで使える縦並び
項目の変え方:購入者がスプレッドシートの「項目設定」を直して、自社の日報に合わせる
帳票:自社の日報の様式をシートに貼り、差し込み記号を書けば、その様式でPDFが出る
入れないもの:フォロー漏れの一覧、過去のExcelの取り込み、上司のコメント、写真、メール通知
ここまで決めておくと、AIに「何を作るか」を説明し直す必要がありません。ただし、あとで書くとおり、仕様書どおりには終わりませんでした。
作業できる環境を整える
AIはパソコンの中で作業してくれますが、何でもできるわけではありません。次のことは自分でやりました。
Googleのスプレッドシートを用意する
AIが自分のGoogleアカウントで作業できるように、ログインする:パスワードを入れるのは自分です。AIに任せることはできません
この開発の環境(clasp という道具を使って、パソコンからGASにコードを送れるようにする設定)の作り方は、【(Claude Code+clasp 初期設定完全ガイド(AIでGASを簡単に作成する方法)】に書きました。これから試す方は、まずそちらをご覧ください。
手順2:作ってもらう
最初に送った指示はこれだけです。
営業日報_仕様書.mdがあるのでこの内容に従って進めたい
ここまでは、世間のイメージどおりです。AIは仕様書の5つの機能をすべて作り、自分で61項目のテストもして、「できました」と報告してきました。
大変だったのは、ここからです。
手順3:本物で触って確かめる
顧客をその場で追加する → 追加したのに出てこない
仕様書でやろうとしたこと:顧客名は一覧から選ぶ。一覧にない顧客は、入力画面からその場で追加できるようにして、表記のゆれを防ぐ。
AIのテストはすべて通っていました。ところが、実際に画面で顧客を追加してみると、会社名が入りません。
追加したがWEB画面の追加で会社名が入らないのでそちらでやって下さい
AIの答えはこうです。
原因(私のミスです) 初期設定で、顧客一覧の「有効」列の空いている500行に、先にチェックボックスを入れていました。(中略)Web画面で追加した顧客は500行目より下(505行目あたり)に書き込まれていました。
つまり、顧客は追加されていたのです。ただ、スプレッドシートの505行目という、誰も見ないところに入っていました。
AIのテストは、AIが用意した「本物に似せた」環境で行います。本物のスプレッドシートとは、少しずつ違います。AIのテストが通っても、本物で動くとは限りません。 本物で確かめるのは人の役目です。
顧客名で過去の訪問を探す → 入れた記録が見つからない
仕様書でやろうとしたこと:顧客名・担当者・期間・言葉で、過去の訪問を新しい順に一覧にする。これが商品の約束の「探せる日報」の中心です。
顧客の追加が直ったと思ったら、今度は検索で見つかりません。
はい、入力はできる様になりました しかし、「検索」では入れたものが検索できないです
AIが一番疑わしいと考えた原因は、検索のところだけ、項目の名前を「顧客名」と決め打ちしていたことでした。仕様書では「項目設定で項目の名前を変えられる」としていたので、たとえば「会社名」に変えると、検索では顧客名が空と扱われてしまいます。AIはここを直し、次の版で検索できるようになりました。
仕様書に書いた「項目は変えられる」が、別の機能の中では守られていなかった、という不具合です。AIのテストは、AIが思いつく使い方しか試しません。
顧客名を打つと候補が出る → 「てい」が「ていてい」になる
仕様書でやろうとしたこと:顧客名で探す。ただ、顧客が何百件にもなると選ぶ方式では使えないので、打った文字に合わせて候補を出すように頼みました(仕様書から一歩進めたところです)。
すると、検索の欄に「てい」と打ったら、「ていてい」と二重に出ました。
「検索」タブの「顧客名」で「てい」と入力したのに「ていてい」と表示される
原因は、日本語入力で変換を確定するEnterキーを、AIのコードが「検索の実行」と受け取っていたことでした。AIはすぐに直しましたが、こう付け加えています。
なお、この不具合は再現環境の自動操作では起きません(日本語の変換の操作を再現できないため)。版を更新したら、実際に「てい」と打って確定し、二重にならないことを確かめてください。
日本語で打つ、スマホで触る、実際の画面を見る。こうしたことは、人がやるしかありません。
本物に近い件数で探す → 数件では見えない問題が出る
仕様書でやろうとしたこと:顧客名を押すと、その顧客の全履歴が出る。営業担当が数人〜数十人の会社で使う。
数件のデータでは、本当に使えるかは分かりません。
実際に近い「検索」を試したいので、下記ができる様にして ・300件のテストデータを作成して欲しい
300件で試すと、次々に問題が出てきました。
顧客名の候補が、元の表示と重なって見づらい
検索するたびに待たされる
条件を変えるたびに、また待たされる

日報をPDFにする → 仕様書どおりなのに使いにくい
仕様書でやろうとしたこと:日付と担当者を選んで、PDFを作ってダウンロードする。
これは仕様書どおりに動いていました。でも、触ってみるとこうでした。
次は、「帳票」タブです 現状ではこれもダメです
・少なくとも選んだ条件に該当するのがあるか否かがわからない
・なくてもPDFを作成してしまう
・作成するPDFはこの画面では見ることができない
仕様書どおりに作っても、使いやすいとは限りません。 仕様書には「何ができるか」は書けても、「使ったときにどう感じるか」までは書けないからです。このあと、PDFを画面の中で見られるようにし、該当する日報がないときはPDFを作らないようにしました。

手順4:伝えて、直してもらう
困ったことを、言葉と写真で伝える
仕様書でやろうとしたこと:管理者が項目や帳票の様式を整える(このころには、手順7で書くとおり、シートではなく画面で整える形に変えていました)。
画面の見た目は、何度もやりとりしました。実際に送った指示の一部です。
・見た目が不自然(どうして空白部分がこんなに多いの)
・「編集」は上ではなく、各項目の右側にあった方が良い(最初編集ができないと思った)
・「編集」の画面で「種類」の選択の下に文字が重なっている
出力日の日付が枠からはみ出している
簡単な変更だが、「見込み金額」の表示がこのままでは桁がよくわからない
「見込み金額」は、仕様書で「自社の日報に合わせて足す項目」の例に挙げていたものです。例のとおりに足してみて、初めて桁の見づらさに気づきました。
どれも、画面の写真を一緒に送りました。写真があると、AIは「どこの話か」をすぐに分かってくれます。言葉だけで伝えるより、ずっと早く直ります。
「どうして」と聞くと、AIは原因まで答えてきます。空白が多かったのは、表の部品に付けた名前が、画面全体の枠の名前と同じだったため、だそうです。細かい仕組みまで分からなくても、原因が分かれば「次はここを疑えばよい」と見当がつくようになります。
あきらめずに、もう一度聞く
仕様書でやろうとしたこと:探せる日報(手順3の検索の続きです)。
300件のデータで遅かった検索は、一度直してもらっても、まだ待たされました。
はい、だいぶ良くなりました 下記はどうしようもないのですか
・検索条件を変更して選択すると、毎回表示に時間がかかる
「どうしようもないのですか」と聞くと、AIは別のやり方を考えて、さらに速くしてくれました。一度で満足できなければ、もう一度聞いてかまいません。
分からないことは、分からないと言う
AIの説明が分からないことも、正直に何度もありました。
下記の意味がわからないです(該当する部分が見つからない)
この内容は難しいので後で確認します
AIは、分からないと言えば、言い方を変えたり、どこを見ればよいかを教えてくれたりします。分かったふりをして進めるより、そのほうがずっと早いと感じました。
手順5:公開して、もう一度触る
仕様書でやろうとしたこと:スプレッドシートに紐づくGASを、Webアプリとして公開して、スマホから使う。
初めての方がまずつまずくのが、AIが「直しました」と言うのに、画面が何も変わらないことです。
GASのWebアプリは、コードを直しただけでは、公開中の画面は前のままです。「新しい版として公開する」という作業が別に必要です。
AIはこの公開を勝手にはせず、毎回「更新してよいですか」と聞いてきます。私が「更新してよい」と答えて、はじめて新しい版になります。これが35回です。
面倒に思えるかもしれませんが、AIが勝手に公開しないのは安心でもあります。公開したら、手順3に戻って、また触ります。この「触る → 伝える → 公開する」の1周を、35回まわしたということです。
手順6:手順書どおりにやってみる
項目を足すと帳票にも出る → 出ない
仕様書でやろうとしたこと:改造レシピ1「項目と選択肢を自社の日報に合わせる」。仕様書には「項目設定に項目を足せば、同じ名前の差し込み記号がそのまま使えます」と書いていました。
AIに購入者向けのレシピ(手順書)を書いてもらい、そのとおりにやってみました。
下記をやって見て、シート「項目設定」には書き込まれているが、「帳票」を見ても反映されていないです。
AIの答えは、「不具合ではなく、今の作りでは、項目を足しても帳票には自動で入らないため」でした。差し込み記号は「使える」けれど、帳票の様式に誰かが書き足さないと出てこない。仕様書の書き方と、使う人の期待がずれていたのです。
過去の記録を取り込む → 見本のファイルでもうまくいかない
仕様書でやろうとしたこと:仕様書では、過去のExcelの取り込みは「入れない(発展版)」でした。でも、購入者が使い始めるときに最初に困るのはここだと考え直し、基本版に入れることにしました。
取り込みの画面と、見本のCSVファイルもAIに作ってもらいました。ところが、見本をそのまま取り込んだだけで、こうなりました。
見本のCSVをダウンロードし、それをアップロードしただけなのに下記の問題があります
・「顧客一覧」に主担当が入っていない
・「ユーザー」にも何も記入されていない
AIが用意した見本のファイルを、AIが作った画面に入れただけで、うまくいかなかったのです。
手順書も見本も、一度自分でそのとおりにやってみるまで、完成とは言えません。

手順7:決める
ここまで「人が確かめる」話を書いてきましたが、もう一つ、人にしかできないことがあります。仕様書をどう変えるかを決めることです。
触って確かめているうちに、仕様書の方を変えたくなることが何度もありました。たとえば、項目の変え方です。
下記で検討してほしい
・購入者にはできるだけシート自体も触らなくていい様にしたい(シートを購入者が触るのは最終手段としたい)
・そのため、項目の「追加、削除、変更」もWEBからできる様にしたい
AIは、すぐには作らずに設計の案を出し、私が気づいていなかった問題まで指摘してきました。私の答えは「推奨のまま反映」の一言です。
最初の仕様書と、できあがったものを比べると、次のように変わっています。
項目の変え方
最初の仕様書:購入者がシートを直す
できあがったもの:管理者が画面で直す。シートは最終手段
帳票の様式
最初の仕様書:自社の様式をシートに貼る
できあがったもの:画面で様式を作れる。シートに貼るのは最終手段
フォロー漏れの一覧
最初の仕様書:入れない(購入者が改造して足す)
できあがったもの:入れた
過去の記録の取り込み
最初の仕様書:入れない(発展版)
できあがったもの:入れた
どれも、AIが案を並べ、おすすめと理由を書き、私が選んで決めました
考えるのはAI、決めるのは人、という分担でした。
これからAIでWebアプリを作る方へ
2年続けてきて、これから始める方に伝えたいことをまとめます。
一発でできるとは思わないでください。 「動くもの」はすぐにできます。でも「使えるもの」にするには、触って直す繰り返しが必要です
AIの「できました」は、自分で触って確かめてください。 AIのテストが通っても、本物で動くとは限りません
困ったことだけを書けば十分です。 作り方は書かなくてかまいません。「遅い」「見づらい」「ここが変」で伝わります
画面の写真を送ってください。 言葉だけより、ずっと早く伝わります
本物に近いデータで試してください。 数件では見えない問題があります
仕様書は先に書いて、途中で変えてかまいません。 何を作るかの説明が省けます。そして、触ってみて違うと思ったら、仕様書のほうを直せばよいのです
「作って」の前に「検討してほしい」と頼んでください。 案を見てから決めると、作り直しが減ります
分からないときは、分からないと言ってください。 AIは言い方を変えて説明し直してくれます
この仕様書で、試してみてください
この記事を読んで「自分でもやってみたい」と思った方のために、今回の最初の仕様書を公開します。
この仕様書で作れるのは、記事の手順2〜5で約4時間かけて動いた、最初の形までです。ここから先をどう育てるかは、あなたが決めることです。
進め方
環境を整える:【Claude Code+clasp 初期設定完全ガイド(AIでGASを簡単に作成する方法)】を見て、パソコンからGASにコードを送れるようにします
仕様書をファイルにする:下の枠の中をすべてコピーし、作業用のフォルダーに「仕様書.md」という名前で保存します
AIに最初の指示を送る:たとえば、次のように送ります
仕様書.md があるので、この内容に従って進めたい。分からないところや決まっていないところは、作る前に質問してください。
あとは、この記事の手順3〜5を繰り返します:本物で触って確かめる、伝えて直してもらう、公開してもう一度触る、です
試すときのコツ
AIの「できました」は、本物のスプレッドシートで確かめてください。 この記事の手順3で起きたことは、あなたのところでも起きるかもしれません
テストデータを300件くらい作ってもらってください。 数件では、検索の使いにくさが分かりません
困ったことを、そのまま書いて送ってください。 「遅い」「見づらい」「ここが変」で十分です。画面の写真も一緒に送ると、すぐ伝わります
仕様書は、途中で変えてかまいません。 触ってみて違うと思ったら、AIに「検討してほしい」と頼んで、仕様書のほうを直します
練習用なので、本物の顧客の情報は入れないでください。 ログインは自前の簡単な仕組みです
仕様書
# 練習用 営業日報アプリ 仕様書
AIと一緒にWebアプリを作る練習のための仕様書です。Googleスプレッドシートと GAS(Google Apps Script)で動く、営業日報のWebアプリを作ります。
## 作るもの
「今の営業日報の見た目はそのまま、中身はデータベース」にして、過去の訪問を探せる・数えられる状態にします。
- **困りごと**:日報を紙からExcelにしたが、1日1ファイルや1枚1シートで溜まるだけ。顧客ごとの過去の訪問が探せず、月の活動の集計は手で数え直している。
- **使う人**:営業担当が数人〜数十人の会社。
- **できるようになること**:顧客名で検索すると、過去の訪問がすべて出る。月の訪問件数と結果が自動で集計される。帳票は今の様式のままPDFで出せる。
## 作る範囲
「入力・検索・集計・帳票出力・ログイン」の5つに絞ります。
| 機能 | 今回 |
| --- | --- |
| 日報と訪問記録の入力(スマホ対応) | 作る |
| 訪問履歴の検索(顧客・担当者・期間・キーワード) | 作る |
| 担当者別・月別の訪問件数と結果の集計 | 作る |
| 帳票テンプレートへの差し込みとPDF出力 | 作る |
| 自前のログインと2種類の権限 | 作る |
| 項目・選択肢を設定シートで変更 | 作る |
| フォロー漏れの顧客一覧 | 作らない |
| 上司のコメント・承認 | 作らない |
| 写真の添付 | 作らない |
| メール通知 | 作らない |
| 過去のExcelの取り込み | 作らない |
### 技術上の決めごと
- スプレッドシートに紐づくGAS(コンテナバインド)+Webアプリ(HTML Service)。
- Webアプリは「所有者として実行」「Googleアカウントを持つ全員がアクセス可」で公開する。本人確認は自前のログインで行う。
- 権限はスプレッドシートの操作とPDF作成に必要なものに限り、メール送信の権限は求めない。
- 外部ライブラリは使わない。例外として、帳票のPDFを画面に表示するためだけに PDF.js(cdnjs)を使う。
## データ構造
データの単位は「日報1枚」ではなく「訪問1件=1行」です。訪問ごとに保存するので顧客単位で検索でき、帳票を出すときにその日の訪問をまとめて日報の見た目にします。
| シート | 1行の単位 | 主な列 | 人が直接触るか |
| --- | --- | --- | --- |
| 訪問記録 | 訪問1件 | ID/日付/担当者/顧客名/訪問方法/内容/結果/次回アクション/次回予定日 | 見るだけ |
| 日報 | 1人1日 | ID/日付/担当者/所感/明日の予定 | 見るだけ |
| 顧客一覧 | 顧客1件 | 顧客名/区分(会社・個人)/よみ/主担当/住所/電話/有効 | 触る |
| 項目設定 | 項目1つ | 対象(訪問・日報)/項目名/種類/必須/一覧に表示/選択肢 | 触る |
| ユーザー | 利用者1人 | ログインID/表示名/パスワード(ハッシュ)/権限/有効/失敗回数 | 管理者が画面から |
| 基本設定 | 設定1つ | 他の担当者の記録を見る(する/しない)、一般の編集できる期間、明細の行数、用紙の向き、自動ログアウト(時間) | 管理者 |
| テンプレート | — | 帳票の見た目 | 触る |
| 履歴 | 変更1件 | 日時/ユーザー/対象ID/項目/変更前/変更後 | 見るだけ |
### 初期の選択肢
- 訪問方法:訪問/電話/オンライン
- 結果:前進/保留/見送り/受注
### 決めごと
- 「担当者」はログインした人の表示名が自動で入り、入力欄は出さない。
- 顧客名は顧客一覧から選ぶ。一覧にない顧客は入力画面からその場で追加でき、表記ゆれを防ぐ。
- ID・作成日時・更新日時の列はプログラムが管理し、項目設定には書かない。
- 「基本設定」の「他の担当者の記録を見る」の初期値は「する」。
## 画面構成
画面はログイン後に4つのタブ(管理者は5つ)で切り替えます。外出先での入力を想定し、スマホで使える縦並びのレイアウトにします。
| 画面 | できること | 使う人 |
| --- | --- | --- |
| 入力 | 日付を選んで今日の日報を開き、訪問を1件ずつ追加・編集。所感と明日の予定を書く | 全員 |
| 検索 | 顧客名・担当者・期間・キーワードで訪問履歴を新しい順に一覧。顧客名を押すとその顧客の全履歴 | 全員(他の担当者分は設定次第) |
| 集計 | 担当者別・月別の訪問件数と、結果(前進・保留・見送り・受注)の内訳 | 全員(他の担当者分は設定次第) |
| 帳票 | 日付と担当者を選んでPDFを作成・ダウンロード | 全員(他の担当者分は設定次第) |
| 管理 | ユーザーの追加・無効化・パスワード再設定、基本設定の変更 | 管理者のみ |
## ログインと権限
Googleへのサインインは入口にすぎず、所有者の権限で動くWebアプリでは、同じ組織外の利用者のGoogleアカウントを取れません。そのため本人確認は自前のログインで行い、すべてのサーバー処理でログイン状態を確認します。
| 項目 | 仕様 |
| --- | --- |
| 認証方式 | ログインIDとパスワード。パスワードはソルト付きでハッシュ化して保存し、元の文字列は残さない |
| ログイン状態 | ログイン時にトークンを発行し、画面からの処理ごとにトークンを確認する。一定時間で自動ログアウト |
| 権限 | 一般(入力・検索・集計・帳票)と管理者(左記+管理画面) |
| 見える範囲 | 管理者が基本設定で「他の担当者の記録を見る:する/しない」を切り替える。初期値は「する」 |
| 編集できる範囲 | 一般は自分の記録のみ編集可。管理者は全員分 |
| 連続失敗 | 5回失敗で一定時間ロック |
| パスワード再設定 | 管理者が管理画面で再設定(メール送信はしない) |
| 最初の管理者 | スプレッドシートの初期設定メニューで登録 |
### 注意
- ログインの処理は独立したファイルに分ける。ほかの部分を直しても、ログインが壊れないようにするため。
- Webアプリのアドレスを知っていれば、ログイン画面までは誰でも開ける。
- 自前のログインなので、機密性の高い情報は入れない。
## 帳票テンプレートの仕組み
今の日報の様式を「テンプレート」シートにそのまま貼り、値を入れたいセルに差し込み記号を書くだけで、その様式の帳票を出せます。
### 差し込み記号
| 書く場所 | 書き方の例 | 入る値 |
| --- | --- | --- |
| 見出し部分(1回だけ入る) | {{日付}} {{担当者}} {{所感}} {{明日の予定}} | 日報シートの値 |
| 訪問の明細欄の1行目 | {{訪問.顧客名}} {{訪問.内容}} {{訪問.結果}} | その日の訪問を、1行目から下へ件数分 |
| どこでも | {{訪問件数}} {{出力日}} | 計算した値 |
項目設定に項目を足せば、同じ名前の差し込み記号がそのまま使えます。
### 出力の流れ
1. テンプレートシートをコピーして、差し込み記号を値に置き換える
2. コピーをPDFにして、画面からダウンロードできるようにする(ドライブの読み取り権限を使う)
3. 作業用のコピーは削除する
### 決めごと
- 明細の行数は基本設定で決める(初期値6行)。訪問が行数を超えたら、出力前に警告を出す。
- 訪問がない日は明細欄を空にして出力する。
- 書式(罫線・フォント・セル結合)はテンプレートのものをそのまま使う。
さいごに
上の仕様書から始めて、私が約16時間かけて仕上げたのが「さがせる営業日報」です。画面での項目の管理や帳票の様式づくり、過去の記録の取り込み、フォロー漏れの一覧などは、仕様書のあとから足したものです。自分で作る前に完成品を触ってみたい方は、デモをお試しください。
【さがせる営業日報のデモ】