はじめに
スポーツボウリング場構想では、第一弾から第五弾まで段階的にシステムを拡張してきた。
- 第一弾:個人予約
- 第二弾:初心者教室
- 第三弾:スポーツボウリング場の運営システム
- 第四弾:会員管理・成長支援
- 第五弾:独自・高機能スコアリングシステム
今回取り組んだのは、第三弾の「拡張機能」である。
一度、
第三弾 → 第四弾 → 第五弾
と進んだあと、第三弾へ戻った。
ただし、これは単純な作り直しではない。
第三弾と第四弾、第五弾まで作ったことで見えてきた、店舗運営と会員成長のつながりを既存システムに追加する作業だった。
1.第三弾の開発時点で、拡張は予定されていた
第三弾を作った時点で、後から拡張することは決まっていた。
第三弾では店舗運営に必要な基本機能を作り、第四弾では会員側の成長支援を作る。
その後、両者をつなぐ。
そのため、次の4候補を保留していた。
| 番号 | 店舗側 | 会員側 |
|---|---|---|
| ① | メンテナンス管理 | オイル抜きリマインド通知 |
| ② | コーチシフト管理 | 全5回講座進捗&指導メモ |
| ③ | レーンアサイン自動化 | 達成バッジ・称号 |
| ④ | 個人カルテとの連携 | グループ単位出欠管理 |
この4候補を、第三弾・第四弾・第五弾まで完成した状態で実装していった。
2.開発順と完成順は違った
最終的には①②③まで実装・テストを完了した。
しかし、実装順は、
④ → ③ → ② → ①
だった。
④ 個人カルテ × グループ単位出欠管理
第三弾では、初心者教室に複数名で申し込んだ参加者の出欠をグループ単位で管理した。
これは店舗運営側の設計として意図的に採用した方式だった。
一方、第四弾では会員一人ひとりの成長を扱うため、個人単位の情報が必要になった。
そこで、第三弾の出欠管理を作り直すのではなく、既存のグループ単位の出欠情報を個人カルテにつなげる方向で考えた。
③ レーンアサイン自動化 × 達成バッジ・称号
次に、店舗側のレーン運営と会員側の成長情報を組み合わせた。
レーンをどう割り当てるかという店舗側の情報と、会員が何を達成したかという会員側の情報を別々に扱うのではなく、同じ店舗運営の中でつなげて考えた。
② コーチシフト管理 × 全5回講座進捗&指導メモ
第三弾で作った初心者教室の運営に、第四弾の個人会員情報を組み合わせた。
「予約できる」だけではなく、
- どこまで講座が進んだか
- 誰が担当したか
- どのような指導をしたか
を継続して扱えるようにする考え方である。
① メンテナンス管理 × オイル抜きリマインド通知
最後に①を実装した。
会員側の「オイル抜きリマインド通知」は実装した。
一方、店舗側の「メンテナンス管理」は未実装として残った。
第五弾ではレーンのオイルパターン記録まで実装しているため、今後この店舗側機能を追加すれば、レーンコンディションと会員側のボールメンテナンスをさらに関連づけられる。
3.既存システムとの接続をどう考えたか
今回の拡張で重要だったのは、単純に新しいテーブルや画面を増やすことではなかった。
すでに第三弾〜第五弾までで、それぞれ異なる粒度のデータを扱っている。
例えば、
- 第三弾:店舗運営、教室、レーン
- 第四弾:会員、ギア、成長
- 第五弾:投球データ、オイルパターン
である。
そのため、新機能を追加するときも「どこにデータを持たせるか」「既存のどの情報と関連づけるか」を確認する必要があった。
特に④では、第三弾のグループ単位出欠という既存設計を崩さず、第四弾側で個人の視点を追加することがポイントになった。
これは、既存システムを全部作り直すのではなく、既存設計を維持しながら必要な情報の粒度を追加するという考え方である。
4.AIを使った開発で起きた問題
今回の開発は、第三弾と第四弾の両方を理解したうえで実装する必要があり、もともと重たい作業だった。
ところが、第四弾のレビューから第五弾の実装まで進めていたClaudeの同じチャットで、そのまま第三弾拡張機能の実装を始めてしまった。
過去の文脈が大量に残った状態で作業を続けたため、Claudeへの指示が長くなり、メッセージ上限に何度も引っかかった。
ここから、
「AIに何を作らせるか」だけでなく、「どの文脈を持たせるか」「どこでチャットを分けるか」も設計の一部
だと分かった。
結果として、④③②はClaudeを中心に実装した。
①の会員側「オイル抜きリマインド通知」はChatGPTに引き継いだ。
ただし、その時点でChatGPTのWorkの残り使用量は15%だった。
Workは最後にコードをまとめる作業に使用し、使用量が0%になったため、gears.py はChatGPTの通常チャット欄で実装した。
AIの利用制限も、実際の開発手順に影響する。
今回それを実感した。
5.「全終了」後に発覚した実装漏れ
④③②を実装・テストし、①の会員側も実装した。
リポジトリの起動確認や既存テストも確認したため、一度は「第三弾拡張機能は全終了」と考えた。
しかし、その後Claudeに「今後もし拡張するとしたら」と確認したところ、
①の店舗側「メンテナンス管理」が残っている
ことが分かった。
①はもともと、
店舗側「メンテナンス管理」× 会員側「オイル抜きリマインド通知」
という一つのペアだった。
今回完成したのは、そのうち会員側だけだった。
これは新しい仕様ではなく、予定していた機能の片側が実装から抜けていたということになる。
店舗側メンテナンス管理は、今後のポートフォリオ候補として残している。
6.今回の開発で得たこと
今回の第三弾拡張機能は、単なる追加機能ではなかった。
第三弾では店舗運営を考えた。
第四弾では会員一人ひとりの成長を考えた。
第五弾では投球データを扱った。
そして第三弾拡張では、それらをつなぐ。
特に今回のポイントは、既存設計を壊さず、異なる粒度の情報をつなぐことだった。
また、AIとの開発では、AIそのものだけでなく、作業環境・文脈・利用制限まで含めて開発プロセスを設計する必要があることも分かった。
実装できた部分だけでなく、実装漏れまで含めて、今回の開発記録として残しておく。
収入が安定したら、Claudeを有料プランにしたい。
今回の経験を踏まえ、より適切な環境で、また一緒に開発してみたいと思っている。
おわりに
第三弾から第四弾、第五弾へ進み、そこから第三弾の拡張へ戻った。
でも、実際には後戻りではなかった。
前に進んだからこそ見えたつながりを、後から埋めていく作業だった。
第三弾拡張機能は、機能を追加した記録であると同時に、ここまで作ってきた「スポーツボウリング場構想」が、少しずつ一つのシステムとしてつながっていく過程の記録でもある。
なお、ここで「今後の候補」として残した店舗側のメンテナンス管理は、その後、実際に形にした。その記録は、次の記事で。
スポーツボウリング場構想・第三弾開発記録は、まだ続きます。🎳
🏠 ホームページ(ポートフォリオ・開発記録・ご相談窓口)
https://junko-takahashi-cloud.github.io/personal-site/?utm_source=qiita&utm_medium=article&utm_campaign=daisan-kakuchou
🐍 ココナラ(Python業務自動化シリーズ)
https://coconala.com/users/6008491
