目次
この記事では個人開発をしてサービスを公開するまでに必要な作業を書いていきたいと思います。開発ツールやクラウドの実際の操作方法はそれぞれで異なり、全部書くと凄い量になりそうなのでざっくりとした感じでまとめてみます。
・クラウドサービスのアカウント作成
・サービス提供者が守るべき法律
・WEBサイトの開発
・ドメインの設定
・CI/CDの設定とデプロイ
・データベースの設計
・フロントフレームワークの選定
・CSS
・HTMX
・WebAPI
・JSON or HTML
・DALの設計
・WebSocket(SPA、AI)
・ファイル管理(サムネイル、セキュリティ)
・メール
・AI(FunctionCalling、Vision)
・サーバーレス
・定期実行
・ログ管理
・利用量と料金の管理
・OAuth認証(M365、Google、Slackなど)
・検索
・セキュリティ
・Stripe
・マネタイズ
個人開発でサービスを提供しユーザーから利用料などの売上をあげるとなるとWEBサイトが必要です。クラウド(Azure、AWS、GCPなど)のいずれかのアカウントを作成しましょう。
サービスを提供しユーザーが使ってもらうとなると利用規約が必要でそのWEBサイトが必要になります。その他にサービスの種類によっては以下のような法律に気を付ける必要があります。
簡単に解説をつけておきました。
1. 個人情報保護法(メールアドレスとかをちゃんと管理しましょう)
2. 特定商取引法(商品を売るなら販売条件、返品、交換などしっかりね)
3. 資金決済法 (反社のマネーロンダリングに悪用されないよう金融庁がチェックするよ)
4. 景品表示法(嘘の誇大広告はやめてね)
5. 電気通信事業者の届け出(見知らぬユーザー同士のチャット機能があるなら必須)
6. 出会い系サイト規制法(18歳未満、有害情報の排除とかいろいろ…)
7. 著作権(ユーザーがアップロードした画像とかが著作権違反してたら?)
などに気を付ける必要があります。
以下のサイトが詳しいので該当してる部分がないか確認しましょう。
https://pentagon.tokyo/app/5663/
https://zenn.dev/nabettu/articles/013f114c7a1b44
利用規約、プライバシーポリシー、特定商取引などはHPに書いておく必要があります。
とりあえずサービスのWEBサイトを最初に作るのがお薦めです。なんといっても
これにつきます。なんか何かが始まりそう、みたいな。
自分のお気に入りのツールでWEBアプリを作りましょう。自分はもっぱらVisual Studioでやってますが、最近流行りのAIエディターとかもよいかもしれません。
開発したWEBアプリを手動でデプロイしてもよいのですが、ここはひとつCI/CDを使ってデプロイしてみましょう。デプロイするとURLをブラウザに打ち込めば自分の作ったWEBサイトを閲覧することができます。
https://docs.github.com/ja/actions/writing-workflows/quickstart
https://qiita.com/shun198/items/14cdba2d8e58ab96cf95
https://zenn.dev/praha/articles/9e561bdaac1d23
GodaddyやCloudflareなどのドメインプロバイダのアカウントを作成しカスタムドメインの設定をしましょう。後述するM365、Google、SlackなどとOAuth認証で連携するときにドメインの入力が必要でクラウドのURLだと使えない可能性も出てきます。早めに設定しておいたほうがよいでしょう。
ほとんどのサービスではユーザーのアカウントデータやサービス固有のデータを永続的に保存する必要があります。データベースの設計をしてデータを保存できるようにしましょう。RDBの設計の記事はこちら↓
https://qiita.com/nem_Nuco/items/6a00e1764628b1b3fefb
https://qiita.com/kiyodori/items/5083ad8bbfc232d01827
https://qiita.com/WebEngrChild/items/4fd38ade334a46629233
https://qiita.com/ktamido/items/98e10689673cec9dbce2
RDB以外にもNoSQLという選択肢もあります。
フロントのフレームワークを選定します。ReactでもNext.jsでもDjangoなんでもおーけー。
自分の最近のお気に入りはHTMXです。軽量でとてもわかりやすいです。
個人開発中のHigLabo(ひぐらぼ)はC#、ASP.NET、HTMX、TypeScript、Azureで構成してます。
https://tinybetter.higlabo.ai/
CSSの基本的な部分をおさらいしましょう。初心者はもちろん、経験豊富な人も定期的にチェックをお薦めします。コンスタントに進化しているので以前苦労した書き方が古くなっていて、最新のいけてる手法に気づいてない可能性があります。
https://zenn.dev/necscat/articles/bc9bba54babaf5
https://zenn.dev/hiraoku/articles/926cbb8bc35eaa
ちょっとおしゃれなテク↓
https://qiita.com/k__watanabe/items/70171a5095e714509af4
自分も久しぶりに学んで気づきがありました。コンテナクエリ、:has()セレクタ、100vmax、gap、clamp()、fit-contentなどはとても便利です。
自分が選択したフロントフレームワークの公式ドキュメントを1週間かけて読みます。遠回りなようでこれが近道。どんな仕様があるか目次レベルでよいので頭にいれておかないと車輪の再発明やいけてない実装で作ってしまってあとで全部書き直しが発生します。
HTMX
https://htmx.org/docs/
https://qiita.com/twrcd1227/items/7bce18167fb02ec22729
面倒でも公式ドキュメントを一度全て目を通しておくのが結局は近道です。
デスクトップ開発をする場合、開発フレームワークを選定して開発します。Windows、Macなど自分が対象とするプラットフォームを決め、適切なフレームワークを選択して開発します。
モバイルアプリを提供する場合、Apple Developer ProgramとGoogle Play Console デベロッパーのアカウントを登録する必要があります。有料です。
登録後はモバイルの開発フレームワークを選定して実装です。モバイルアプリの更新は申請→承認→公開という形で時間がかかるのは頭にいれておきましょう。個人開発でフィードバックを素早く回すには少し向いてない部分があります。
モバイルとWEBのいいとこどりをしたのがPWA開発です。基本はWEBアプリですがアプリとしてiPhoneやAndroidのホーム画面にアイコンを追加できます。また通知、オフライン対応などの機能も実装することができます。モバイルアプリと違って審査がないのでユーザーからのフィードバックを元に高速にPDCAを回すことができます。
フロントの作成が始まるとバックエンドのデータベースからデータを取ってくるというのが必要になります。DBへ直接クエリを投げるのはセキュリティ上望ましくありません。WEBブラウザ、デスクトップ、モバイルアプリのいずれにしてもWebAPI経由でデータのやり取りをする形になります。各WEBサーバーでそれぞれ書き方があるのでそれを参考にWebAPIを実装します。
多くのWebAPIではJSON形式でデータのやりとりをすることになります。HTMXはHTML形式でのデータのやり取りになります。
Webサーバー内でデータベースからデータを取得するレイヤーをどう設計するか考える必要があります。ORマッパー、生クエリ、ストアドプロシージャなどいくつか方法があります。システム全体で手法が混在しているとプログラムの保守性が下がるのでなるべく統一するほうがよいでしょう。
最近の今風のリアルタイムでページが更新されるようなUXを提供するにはWebSocketやSSEの活用が必須です。AzureではSignalRという双方向通信のためのライブラリがあり、サーバーから簡単にクライアントのJavaScriptの関数を呼び出せます。
これらのテクノロジーでAIの回答をリアルタイムでぬるぬる表示したり、他のユーザーが自分のタスクの状態を変えたときに自分のブラウザの画面を更新したり、といった感じのUXを実現できます。
サービスでユーザーが撮った写真、AIに解析させる論文ファイル、仕事の守秘義務のあるドキュメントなどをアップロードする機能を作りたいという時があります。その時にはクラウドのファイル管理のサービスを使うことになります。AzureではBlobサービスを使うことになるでしょう。
画像ファイルを使用する場合はアップロードしたタイミングでサムネイルの作成処理を行うことになります。最近のスマホの写真は高解像度なため、数MBのサイズになることもあります。一覧画面でアップロードされた画像を100個並べるとなかなか表示がされずUXが低下します。
もう一つの大事な注意点はセキュリティです。アップロードしたファイルをURLの直接指定でダウンロードできる形になっていると意図しないファイルの漏洩が発生します。
AzureのBlobではSASという機能があり、URLを動的に生成しないとそもそもダウンロードができないようにサービスを作りこむことができます。
https://learn.microsoft.com/ja-jp/azure/storage/blobs/sas-service-create-dotnet?tabs=container
こういった機能を使用して適切な公開範囲でファイルへアクセスできるようにしましょう。
多くのサービスではユーザーがパスワードを忘れた際や重要な連絡(規約の変更)などのためにメールアドレスを登録してもらい、そこにメールを送るという形になります。SendGridなどのメールサービスを利用しましょう。
https://philipptarohiltl.com/sendgrid-how-to-setup-spf-dkim-dmarc/
https://sendgrid.kke.co.jp/blog/?p=10883
SPF、DKIM、DMARCなどを適切に設定して迷惑メールに分類されないように設定をする必要があります。
ChatGPTやClaudeのAPIを利用してAIとのチャット機能を実装するには通常のWEBリクエストとは違って長時間実行が必要になります。WEBアプリとは別にサーバーレス(Amazon Lambda、Azure Functionなど)とWebSocketを利用して実装する必要があります。
テキストでのやり取りはもちろんVision系の機能を使えば請求書や領収書のデータから銀行口座番号や価格などのテキストを簡単に抽出できます。自分もメールボックスに届いた請求書データをAIに見てもらって請求一覧テーブルに保存する処理とかで使っています。
前述の画像のサムネイルの作成やメールの送信などはWEBサイトへのリクエスト&レスポンスの処理で行うのは避けたほうがよいでしょう。画像のアップロードを例に考えてみます。ユーザーが5個の画像をアップロードしたとすると、サムネイル5個の作成が終わるまでレスポンスを待たされることになりUXが低下します。他の例では100人が参加しているチャットのチャンネルがあるとして、100人に通知のメールを送る、といった場合には100人へのメール送信が完了するまでレスポンスが完了せずユーザーは待たされることになります。
メール送信、画像の作成、PDFの解析、AIの回答などの長時間かかる処理はサーバーレスを活用してUXの低下を防ぐように実装したほうがよいでしょう。
定期的に実行したいサービスなどもサーバーレスで実行することになります。過去のログデータを削除する、日ごとの各ユーザーのAPI利用数の合計を集計してテーブルに保存する、などといった処理が考えられます。
ユーザーのアクセスログやエラーログの機能は表には出ませんが、サービスの問題点をいち早く適切に診断を行い改善していくには重要です。最初の段階から作っておくことをお薦めします。
ログデータはとても多くなります。自分は安さ重視で全てGCPのBigqueryにログデータを保存しています。
ログ機能が実装してあればAPIをどのくらい利用したかなどの集計も簡単です。保存済みのログに対して、サーバーレスで定期的に集計処理を行い、結果をデータベースのテーブルに保存する、という流れで集計データの管理ができます。APIなどの使用量が分かればそれを元にした課金なども実装ができるようになります。そういった意味でもログ管理の機能は早めに作っておきたいところです。
外部サービスとの連携はOAuth認証かAPIキーという形が多いです。OAuth認証は初見だとまあまあ複雑です。しかし多くのサービスがOAuth認証でのAPI提供をしているので一度実装してみるのをお薦めします。
https://qiita.com/TakahikoKawasaki/items/e37caf50776e00e733be
一度理解してしまえばサービスが変わっても内容はほぼ同じなのでスムーズに実装ができます。
大量のデータがある場合、データベースのLIKE検索ではパフォーマンスがでません。全文検索やベクトル検索が可能なクラウドサービスがあるのでそれを利用しましょう。AzureであればAzure AI SearchやCosmosDBがあり検索機能を簡単に実装できます。
https://learn.microsoft.com/ja-jp/azure/search/search-what-is-azure-search
https://qiita.com/nohanaga/items/0637ea6fe8e01a98e4fc
ベクトル検索を使えば似ている画像の検索などの機能も提供できるので魅力があります。
セキュリティは後回しにされがちですがユーザーを被害から守るためにもしっかりと対応する必要があります。
https://www.proofpoint.com/jp/threat-reference/web-security
https://siteguard.jp-secure.com/blog/security-for-web-application
基本的なSQLインジェクション、XSS、CSRFなどは対策しつつ、WEB APIのエンドポイントの対策も必須です。開発者ツールなどで直接APIを実行されたときにユーザーが誰かというのをチェックする処理をすべてのエンドポイントで実装する必要があります。
ユーザーからの利用料を受け取りはStripeがお薦めです。設定画面、API、Webhookのログ、ドキュメントともにわかりやすく、様々な課金方法を実装できます。食器などの物理的な商品の販売、Huluなどのような毎月のサブスクリプション型、指定した金額の入金などサービスのニーズに合った方法を選択できます。
https://docs.stripe.com/payments-api/tour?locale=ja-JP
https://apidog.com/jp/blog/mastering-the-stripe-api/
https://zenn.dev/kisukeyas/articles/e0963675baa549
実際に課金を実装すると予想以上にパターンが多く大変です。
・無料期間中の解約→再度無料期間登録
・Stripeとこちらのデータベースの整合性の管理
※ユーザーデータは消えてるけどStripeのサブスクリプションが残っている
・月払い→年払いへのプランの変更
・月払いの価格変更。期間の途中の場合どうする?
など結構大変です。ここは仕様書をしっかり書いて管理したほうが良さそうです。
最後にマネタイズです。自分のサービスにあった方法を下記を参考に選びましょう。
https://zenn.dev/nabettu/articles/013f114c7a1b44
https://qiita.com/shinshin86/items/9ddf658b7f12060bb883
海外のマネタイズの成功事例
https://umatan.m-newsletter.com/recommendations
AIの波に乗れれば一気にユーザーが増えることもあるというのは夢があります。
この記事を読んだ人の誰からこういった波に乗れることを祈ってます。
最後まで読んでくれてありがとうございました。
自分はメールの判別と下書き作成をしてくれるAIエージェントを提供中です。
https://www.higlabo.ai
使って意見をくれる人はいませんか?
大量のメールの返信に追われてたり、問い合わせメールアドレスにたくさんの問い合わせが来ている人はぜひ使ってみてフィードバックを欲しいです。要望などあれば対応していきたいと思っています。
Xはこちら
https://x.com/higlabo
コメントはまだありません