
【第3章 3-20話】移植初日、僕が書いたのは Markdown 5本だけやった
移植を始めた日のコミットを開けたら、中身は Markdown が5つだけやった。プラグインのコードはゼロ。そのうち4つは「元のシステムに答えが無い決定」の記録で、残り1つが対応表。9月7日の夕方に、それだけを置いて終わってる。
進捗報告としては、まあ、しょうもない見た目である。
前段はサイトのほうやった
そもそもこのリポジトリは予約システムのために作ったもんやない。8月18日の朝、介護タクシーの公式サイト用に WordPress テーマ一式を最初のコミットで入れた。ヘッダーからフッターまで、固定ページもホームの各セクションも、カスタム投稿タイプもまとめて放り込んでる。同じ日の午後には、サブページを広げたクライアント確認版。20日の夕方には対応エリアの制限と LINE 予約の案内を直してる。
その間、19日から23日にかけて、243往復のセッションが1本まるごと残ってた。何を話してたかまでは書き残してへんから、今となっては分からん。ただ、手は動いてたらしい。
あと先に言うとくと、この予約システムは 2026年10月のリリースに向けて作ってる途中のもんで、この記事の時期はまだ一般公開してない。開発と検証で触ってる予約や氏名や電話番号は全部テストデータで、実在のお客さんの情報は入ってない。
予約の本体は、別のリポジトリにある
LINE と Web から予約を受ける仕組み自体は、`line-app-…-taxi-booking` の `feature/line-mini-app-foundation` という別リポジトリで先に作ってあった。これを WordPress プラグインとして、サイト側のリポジトリに移す。それが今回の宿題。
移植って口で言うと、ファイルを開いて名前を付け替えて貼るだけの作業に聞こえる。実際、7割くらいはそれで済む。手が止まるのは残りのほうや。
ひとつ、分かりやすいのがあった。予約の重なり防止である。元の設計は Postgres で、`EXCLUDE USING gist` が使える。期間が重なる行は、そもそもテーブルに入らんようにデータベース側で断ってくれるやつや。MySQL には、これに相当する range-exclusion の制約が無い。
つまり、元の設計をそのまま写していくと、この一箇所だけ写す先が空白になる。「Postgres の制約でやってました」と書いたところで、移した先にその制約は無い。ここは元の資料を読んでも答えが出てこん。こっちで決めるしかない。
対応表に書けるものと、書けへんもの
で、コードを触る前に、コミットの内訳を先に決めた。
元から持ってこられるものは、対応表に書く。どのファイルがどこに行くか、という機械的な話やから、表の形で並べたら足りる。一方、持ってこられへんもの——移植先に同じ仕組みが無くて、こっちで新しく決めなあかんもの——は、対応表に混ぜずに ADR として別に番号を振る。
混ぜたら、あとで見たときにどっちがどっちか分からんようになる。「元がこうやったから」と「僕がこう決めたから」は、半年後の自分にとって全然ちがう重さのはずやのに、同じ表に並んでたら区別がつかん。
先に条件を文字にして自分を縛っておくと後で効く、という意味では、制約と誓約に近い話やと思ってる。誓約のほうは代償がでかいけど、こっちの代償は「初日にコードが1行も進まん」だけなんで、まあ安いもんや。
その日入った5つのファイル
出来上がったのが `docs/BOOKING_PORTING_MAP.md` と、`docs/adr-wp/` に入れた4本。
`0001-mysql-overlap-prevention.md`
`0002-admin-auth-on-wp-core.md`
`0003-public-routes.md`
`0004-cron-strategy.md`
0001 が、さっきの重なり防止の置き換えをどうするか。残りの3本も同じ理屈で、元のシステムに対応物が無いから新しく決めた枠や。中身をここで解説しはじめると長くなるんで、それはまた別の回で。
マップのほうには、元のどのファイル、設計のどの章、どの ADR が、プラグインのどのファイルに落ちるかを対応させて書いた。要するに引っ越しの荷物リストで、箱の外側に「これは中身をそのまま移す」「これは向こうに置き場が無いから買い直す」と書いてあるのと同じ。
コミットメッセージの頭には Phase 1 と入れて、元リポジトリの調査は完了、とした。9月7日の夕方。その日増えた行のうち、動くものはひとつもない。
元が取れたかどうか
Markdown 5つのコミットは、やっぱり見栄えが悪い。スクリーンショットも貼れんし、デモもできん。
ただ、あとで「ここは元に無い判断です」と言える場所が4つできた。番号が振ってあるから、指さすのも楽や。それだけで、この日は元が取れたと思ってる。
#個人開発 #開発日記 #移植 #WordPressプラグイン #設計ドキュメント #第3章 |AIと作る介護タクシーの予約システム #ADR #MySQL