きっかけ
第三弾の開発記で「店舗側のメンテナンス管理は今後の課題」と書いていました。あれから時間が経ち、気づけば拡張①は完成し、AWSにデプロイされ、第三弾・第四弾とAPIで繋がっていました。今回はその完結報告です。
なぜこの構成にしたか
今回の一番の目的は「新しい技術スタックの実務経験を積むこと」でした。
- FastAPI → 慣れているので維持
- PostgreSQL → 初挑戦(これまではSQLite中心)
- Docker → 初挑戦
- AWS(EC2) → 初挑戦
一方でKubernetesやTerraformは今回は見送りました。個人開発だと「全部一気にやりたく」なりがちですが、新しいものを増やしすぎると結局どれも中途半端になると思い、あえて絞りました。既存の予約システム群(第一〜五弾)とは別リポジトリ・別DBにしたのも、実験場として気楽に壊せるようにするためです。
作ったもの
貸出用品(シューズ・ボール)の管理(rental_items)と、整備記録(maintenance_log)の管理です。整備記録は「対象種別+対象ID」で汎用化していて、拡張①内の設備だけでなく、後述する第四弾(会員のマイギア)の整備記録にも同じテーブルを使い回せる設計にしています。
Docker・AWS、詰まった話
未経験からのスタートだったので、当然いろいろ詰まりました。個人開発ブログなので、恥ずかしながら詰まった順に書きます。
- SSH接続できない:.pemファイルの権限が緩すぎて拒否される → icaclsコマンドで自分のみ読み取り権限に絞って解決
- .envを直したのに反映されない:docker compose up -dだけでは反映されないケースがあり、--force-recreateを付けて解決
- PowerShellでコンテナ内の環境変数がおかしい:ダブルクォートだとPowerShell側で変数展開されてしまう罠。シングルクォートで解決
- Swagger UIのPATCHで事故る:サンプル雛形を一部だけ書き換えると他の項目がサンプル値で上書きされる。本文を一度全消しして必要な項目だけ書くルールに
一つ一つは小さいですが、「動かない」で止まった時間の分だけ、確実に身についた感覚があります。
第三弾・第四弾との連携
第三弾(店舗管理)とは、レーンが新たに「故障中」になったタイミングだけ拡張①へ自動でPOSTする仕組みを作りました。「実際に店舗を運営する立場なら」と考えて、書き込み系エンドポイントにはAPIキー認証を追加。拡張①が落ちていても第三弾の処理は止めない、という例外設計も意識しています。
第四弾(会員のマイギア管理)とは双方向連携にしました。
- 第四弾→拡張①:会員が整備依頼を出す
- 拡張①→第四弾:整備完了情報を会員のマイギア履歴に反映
第四弾は.envの自動読み込みが入っていなくて最初ハマりましたが、load_dotenv()を追加して解決。あとデスクトップに同名フォルダが複数あって、.envを違うフォルダに保存してしまうという初歩的なミスもやらかしました(実際に動いているのは「スポーツボウリング場予約システム第四弾\bowling-lane-growth-system」の方でした)。
おわりに
Docker・AWSともに未経験だった状態から、EC2への本番デプロイ、そして既存システムとの双方向API連携まで実機で確認できたことが、この拡張①プロジェクトの一番の成果です。
「今後の課題」と書いた一行が、こうして「完了しました」に変わる瞬間は、記録を残してきたからこそ味わえるものだと感じます。
スポーツボウリング場構想・拡張①の開発記録は、これで一区切りです。🎳
