【AI航海日誌】AIプロジェクトマネージメント～Webサイト開発と品質管理（前編）～

こんにちは、ひでピチュです。

前回は、AIと一緒にプロジェクトを進める中で生まれた「ドキュメント管理」の試行錯誤について書きました。記事の最後を「次回は、実際にAIとWebサイトを作っていった話を書こうと思います」と締めくくっていたのですが、今回はその続きです。

いざ設計書をもとにWebサイトを作り始めたところ、当初よりもかなり本格的なシステムが出来上がってしまいました。少し長くなりそうなので、前後編の2回に分けて振り返ってみたいと思います。

最初は、普通のホームページを作るつもりだった

開発を始めた当初は、事業やサービスの内容を丁寧に伝える、いわゆる「閲覧用のホームページ」を作るつもりでした。きれいなトップページがあって、案内ページがあって、お問い合わせフォームがある。よくある一般的なWebサイトです。

ちょうどそのころ、AIを使って誰でもきれいなWebページが作れるというのが、YouTubeで賑わっていたので、単純にやってみようと思った次第です。

作り始めると色々欲が出てきて、あれもやりたいこれもやりたいと、顧客データ分析やアイデア出しで出てきた機能を搭載していくこととなり、それもAIに効き聞きながら、言い換えるとAIに言われるがままに次々と機能拡張をしていきました。

お客様が簡単に申し込める予約カレンダーでは、現在の空き状況に応じて柔軟に対応できるように、人の介在を入れた仮予約の仕組みを作りました。そして、一度利用してくださった方が継続的に使える会員マイページも必要になり、さらには、オンラインでクレジットカード決済も完結させたいし、運営側が日々の予約や入金、お礼メールの送信などを一元管理できるようにしたい。

そうやって「本当にビジネスを回すために必要な機能」を一つひとつAIに相談しながら足していくうちに、気がつけば単なるホームページではなく、予約管理、会員システム、カード決済、顧客台帳まで備えた、本格的なWebアプリケーション（SaaSのような仕組み）へと膨らんでいきました。

知らない技術を、AIに教わりながら実装する

私は会社員時代にプロジェクトマネージャー（PM）をしていましたが、サービスを作る際は、プロトタイプにしろ製品にしろ、社内の製作部門や外注のプログラマーによって、要件から仕様書、設計書を起こして、コーディング、試験実施、品質を保証するまで、何人もの手を通すことになります。

それを、AIを相手に「現場ではこういう運用がしたい」「こういうことを実現したい」と相談するとだけで、具体的な設計とコードを作り、試験の実行、バグ改修（修正）までこなしてしまうのです。プログラミング経験者としては、驚きを超えて恐怖にすら思えました。

特に、自分が全く知らない分野、や技術は、「どうやって実現するのか」「何が選択肢か」ということをについて教わりながら実装できる体験は、どんな研修や教本よりも分かりやすく学べるというのは、非常に楽しい経験になりました。

その中でも特に印象に残っているのが、クレジットカード決済（Stripe）の実装です。

最初は単純に「予約を申し込んだ時点でカード決済を完了させればいい」と考えていました。しかし、実際の業務フローを整理してみると、電話でのキャンセルや日程変更、利用期間の延長、あるいは当日の現金払い希望など、いろいろなケースが発生します。事前決済にしてしまうと、変更のたびに返金や再決済の手間が発生し、現場の運用が回りません。

それをAIに相談すると、ホテル業界などで標準的に使われている「SetupIntent＋事後決済（off-sessionのPaymentIntent）」という仕組みを提案してくれました。

簡単に言えば、予約申込の時点ではカード情報の有効性だけをチェックして登録（1円も課金しない）しておき、サービスがすべて終了した後に、管理者が確定した金額で裏側から決済を実行する方式です。さらに、いざ事後決済しようとしたときにカードエラーになる確率を下げるため、登録時に5段階のチェックをかける仕組みなども、AIに教わりながら組み込んでいきました。

また、予約の空き枠管理も少し変わった工夫をしました。すべてを専用の管理画面に閉じ込めるのではなく、現場のスタッフが普段使い慣れているGoogleカレンダーの説明欄に「男性枠・女性枠」のメモを書けば、裏側のプログラムがそれを読み取って、ホームページ上の空き枠表示と自動で同期する仕組みにしたのです。

システムに現場を合わせるのではなく、現場のやり方にシステムを合わせようとすると、従来のITシステム開発では仕様拡張で予算を大幅に超えてプロジェクト崩れを起こすことがままあります。しかし、それすらAIでなら難なくこなしてしまうのには脱帽しきりでした。

AIがコードを壊す、文字が化ける

ここまで書くと、AIが魔法のように何でも作ってくれたように思えますが、実際の開発にはまだまだ泥臭い現実もあります。

特に苦労したのが、プログラムのコードが1万行を超えてからの「品質管理」です。

最初は画面が動くだけで感動していたのですが、機能が増えてくると、あちらを直せばこちらが壊れるという問題が起き始めます。AIに修正を頼んだり、複数ファイルを一括で書き換えるスクリプトを走らせたりすると、思わぬ場所が壊れていることがあるのです。

例えば、HTMLの開始タグと終了タグの数は合っているのに、スマートフォン表示用のレイアウト設定（CSSのメディアクエリ）がごっそり消えてしまっていたことがありました。また、Windows環境で日本語ファイルを扱う際の文字コード（BOM付きUTF-8など）の兼ね合いで、編集した後に日本語の一部が「（U+FFFD）」という代替記号に文字化けしてしまう事故も起きました。

一番やきもきしたのは「機能の先祖返り」です。ある画面の文字化けや表示崩れを直そうとした際、AIが少し前のバックアップファイルを使ってファイルを丸ごと上書き復元してしまい、その間にせっかく実装した新しい機能（音声プレイヤーやバッジ表示など）がすべて消えてしまったのです。

仕組みでミスを止める「劣化防止ルール」

人間の担当者であれば、一度大きなミスをすれば次から気をつけてくれます。しかし、AIはセッションが変われば過去の失敗をきれいに忘れてしまいます。

そこで、過去に起きた失敗を二度と繰り返さないための「劣化防止および品質管理ガイドライン（REGRESSION_PREVENTION_RULES.md）」というルール文書を作り、AIが作業を始める前に必ず読み込ませるようにしました。

• 「構造」より「機能」を疑え：閉じタグの数が合っていても、スマホ対応コードなどの機能が消えていれば破壊である。

• 安易な全体上書きの完全禁止：不具合を直すために古いバックアップで丸ごと上書きすることは禁止し、最新のファイルをベースに差分だけをピンポイントで移植（マージ）すること。

さらに、文書で注意するだけでなく、機械的にミスを止めるゲートも作りました。本番環境へプログラムを反映（デプロイ）するスクリプトの中に、事前の自動検査プログラムを組み込んだのです。

主要なファイルを自動でスキャンし、文字化け記号が1文字でも含まれていないか、

実はこの検査スクリプト自体も、最初は「ファイルの読み込みに失敗したときにエラーを出さず『問題なし』として素通りしてしまう」という抜け穴があり、後から直すことになりました。「動くプロトタイプを作る」のと「本番で壊れないように運用する」のには、これほど大きな溝があるのだと実感した出来事でした。

ただ、これらのルールや試験も、1からすべて自分で考え出す必要はありませんでした。失敗を修正する過程そのものをAIと一緒にルール化（スキル化）していけたので、「自分が学んでいくのと一緒に、AIも育っていく」という感覚もありました。

外注見積もり「3,200万〜3,600万円」の衝撃

こうして試行錯誤の末に出来上がったシステムが、もし一般的な開発会社に外注したらどのくらいの費用になるのか気になり、実装した全コードと仕様をもとに市場の標準価格で見積もりを算出してみました。

結果は、自分でも驚くような金額でした。

• 機能実装（コーディング）のみ：約 2,638万円

• PM・要件定義・デザイン・テスト等：＋550万〜1,000万円

• 総合計：3,200万〜3,600万円

なぜホームページ作成から始まったものがここまで高額な試算になるのか、理由は大きく3つありました。

1つ目は、裏側で動くプログラム（API）の規模です。一般的な中規模Webシステムでは、裏側の処理（Cloud FunctionsなどのAPI）は15〜20本程度が標準ですが、今回のシステムは予約処理、決済、自動メール、カレンダー同期、クーポン発行、会員管理など、合計43本ものAPIが稼働していました。一般的なシステムの2倍以上のビジネスロジックが詰まっていたことになります。

2つ目は、先ほど触れたStripeの「事後決済」の難易度です。利用終了後に管理者が金額を確定して引き落とす「off-session事後決済」は、実装ミスがそのまま金銭トラブルに直結するため、設計・実装できるエンジニアが希少で単価が最高水準になり、この決済機能だけで約540万円相当になるとのことでした。

3つ目は、ランニングコストの設計です。この規模のシステムを通常のサーバーで動かすと月額20万〜100万円ほどの維持費がかかりますが、今回はFirebaseを使った完全サーバーレス設計で作ったため、毎月の維持費はほぼ0円で動いています。3〜5年運用すれば、節約できたサーバー代だけで開発費用の全額を回収できる計算です。

もちろん、私の人件費（時間）やAIの月額料金はかかっていますが、市場価格で3,000万円を超えるようなシステムが、個人とAIのやり取りだけでゼロから作れてしまう。これは、個人でそれだけ稼げるではなくて、市場価格が今の1/10、1/100になるということなので、これからの「ホームページ制作業」や「システムの受託開発業」は、これまでのやり方が通用しない大きな転換点を迎えるのだろうと感じます。

さらに、これだけ高度なシステムを個人で作れるようになったとしても、今の時代だから待ち受ける大きな課題に直面します。

開発の後半は、「セキュリティ」というさらに重い問題と、そして「AIで簡単に仕事ができるようになる未来」に対して、現在の社会問題も谷ごとではありません。
後編では、そのセキュリティの裏側と、AI時代のいたちごっこについて書こうと思います。

#AI航海日誌 #AIプロジェクトマネジメント #生成AI #AIとやってみた #Web開発 #個人開発 #SaaS #Firebase #Stripe #システム開発 #品質管理 #業務効率化