「正解の仕様」を求めて、決断する

Transcript

1. 「正解の仕様」を求めて、決断する ~PHPerKaigi mini #4~ 2026.08.24 せきねこ - CoDMON, Inc.
3. 今回のLT 😭 PHP Conference Japan 2026 のプロポーザルで reject されたネタです PHPerKaigiじゃない上にPHP要素もない話ですが…供養させてください！ 3
4. 舞台は給付費申請画面刷新プロジェクト • 「給付費申請用データ作成機能」を、連携先システムの更改に合わせて画 面刷新 • プロジェクト開始時の状況 ◦ 連携先のUIだけでなく、業務フロー自体も新しくなる模様 ◦ コドモン側に何をどうする機能があれば良いのか？が分からない 4
5. プロジェクトを前進させたもの： 「やらない」という意思決定 5
6. 「やらない」という意思決定 • やるものを決める ＝ つくるものが増える • つくるものが増える ＝ 価値は増えるが工期と負債も増 える • （旧システムは保守工数がかさんで苦しい思いをし た） 6
7. 「やらない」という意思決定を支えたツール ADR（Architecture Decision Record） 意思決定を1件ずつ記録するドキュメント 7
8. ADRテンプレート 8
9. CASE1：祝日考慮は必要？ 9
10. CASE1：祝日考慮は必要？ 背景 • 保育施設の利用時間は、家庭（園児）ごとに予め決められている ◦ Aさん：7:30~18:30 ◦ Bさん：8:30~16:30 • 認定された利用時間外での利用（＝延長保育）は、追加料金が発生する • 利用時間の定義は曜日によって異なる（平日・土曜・休日） → 「祝日の延長保育利用」は考慮が必要だろうか？？ 10
11. CASE1：祝日考慮は必要？ 最初は漠然と「考慮必要かも…」と誰もが思っていた でも、やるとなると • 祝日データの管理が必要になる • コードが複雑になり、テストパターンも増える 11
12. CASE1：祝日考慮は必要？ もし「やらなかったら？」を検討した • 当該機能利用中の施設に影響がないことが判明 ◦ 利用中施設のデータ調査で裏付け ◦ そもそも祝日に保育を実施している保育施設がほぼない • 万一考慮が必要となっても、出力データを施設が修正することで申請業務 は可能 → 結論： やらない 12
13. 勿論「やる」という意思決定を することだってある 13
14. CASE2：園児識別番号の削除機能は必要？ 14
15. CASE2：園児識別番号の削除機能は必要？ 背景 • 保育施設を利用する園児には、自治体が園児識別番号を発行している ◦ マイナンバーの保育施設バージョンみたいなもの ◦ 給付費申請業務でも使用されている ◦ コドモン上で、園児ごとの園児識別番号入力欄がある • 園児識別番号は変更される場合がある ◦ 市外転出時などに発生 • 旧システムでは出力データの仕様上、入力済番号の削除機能が必須だった 15
16. CASE2：園児識別番号の削除機能は必要？ 新システムでは出力データに影響がない →「削除機能、なくて良いのでは？」と思っていた （「やらない意思決定」の波に乗ろうとしていたかもしれない） 16
17. CASE2：園児識別番号の削除機能は必要？ → 結論： やる • 新システムにおいても、僅少だが入力済番号の削除を要するユースケース が存在することが発覚 ◦ 特定条件下において、給付費申請対象外となる園児がいる • やらない場合の回避コストが高い ◦ 「給付費申請対象外の園児かどうか」識別フラグを追加 ◦ または、該当園児の園児識別番号データをエンジニアが都度削除 17
18. CASE2：園児識別番号の削除機能は必要？ つくるものは増えたが… • 隠れ仕様のようとはいえ、考慮が必要なケースに対処 できた • 代替案による回避コストを把握したことで「やる」意 思決定に納得感を持てた 18
19. このプロジェクトでの意思決定実績 ほぼ 毎イテレーションで意思決定 • 約4ヶ月のプロジェクト • 19以上のADR ◦ ADR運用は途中から始めた ◦ 記録を忘れてしまった意思決定もそこそこ… • 余談：最近はADR作成コストも下がってきている ◦ 文字起こし〜AIにADRテンプレートを渡して要約〜気になった部分を 修正 19
20. まとめ 20
21. まとめ • プロジェクトを前進させたもの：「やらない」という 意思決定 • 意思決定を支えたツール：ADR • 漠然と「やる」→ 「やらなかったら？」も考える • 代替コストを把握→「やる」ことに納得感を持てる 21
22. おまけ 「やらない」という意思決定以外の実践例はブログにて！！ • コドモン Product Team Blog 「正解の仕様が分からない」を乗り越えた、給付費申 請画面刷新プロジェクトの実践例 22