設計メモ — 複数区画のマイソク(#9636)
上部の「案」で 現状・Issue案(v2)・★レビュー案 を切り替えられます。「画面」でクイック登録・物件編集・物件一覧・解説(このページ)を行き来できます。「状態」で、反映前・1件目の処理後・2件目の処理後へ飛べます。物件一覧の行を押すと、その物件の編集画面が開きます。データはダミーです。
0. 現状 — 2区画目を登録できず、価格も未入力になる
「案: 現状」で再現しています。玉縄ヒルズ 第2期のマイソクには1号棟と4号棟が載っています。価格は「6,490万円〜7,090万円」と価格帯で書かれています。
重複候補カード
- 共通の価格欄が価格帯なので、単一価格の検算で空欄になる。
- 比較表の価格は「— / —・不明・両方未入力」。値下げに気づけない。
- 区画を選ぶ場所が無い。
「同じ物件として反映する」
- 価格は両方空なので差分に出ず、主ボタンは「最終更新日を今日にする」になる。
- 押すと、資料全体が物件 #2481 の資料になり(ⓘの説明どおり)、ページは「登録済み」。
- #2481 の価格は未入力のまま。4号棟は登録する手段が無くなる。
「別の物件として新規登録」
- フォームに区画の選択はあるが任意。価格欄は空欄で「要確認」。
- 区画を選ばずに登録すると、価格未入力のまま保存される(本番の #1889 と同じ)。
- 登録後は資料全体が登録済みになる。2区画目を登録しても1件目の物件にまとめられる。
この結果、物件一覧の「価格が原本と違う」も効きません。比べる原本の価格は資料ごとに1値で、価格帯の資料では空だからです。
本番の規模(読み取りのみ・2026-11-19):
- 区画が2つ以上ある原本は127件(事業用で募集が2つ以上の資料は0件)。
- 物件に結び付いた96原本では、区画の合計271に対して物件が96件。全区画が登録された原本は0件。
- 結び付いた有効物件92件のうち26件が価格0。種別は土地60・戸建30・事業用2。
原因: 住宅系では、原本と物件の結び付きが資料単位しかない。新規登録・反映・自動化・決着の判定・重複判定のすべてが「1原本=1物件」として動いている。
1. 案の比較
| 項目 | 現状 | Issue案(v2) | ★レビュー案 |
| 区画の選び方 | 重複候補カードには無い。新規登録フォームにだけあり、任意。 | 比較表の「号棟」行で選ぶ。 | ページ上部の区画カードで1回選ぶ(事業用の募集カードと同じ部品)。比較・反映・新規登録が同じ選択を読む。 |
| 比較表の価格 | 両方未入力。 | 選んだ号棟の価格。旧マイソクの価格と差額も出す。 | 選んだ区画の価格。旧マイソクの価格は出さない(論点C)。 |
| 同じ物件として反映 | 価格は差分に出ず、「最終更新日を今日にする」だけ。 | 選んだ号棟の価格を反映する。 | 選んだ区画の価格・面積を反映する。 |
| 新規登録 | 区画は任意。選ばないと価格未入力で保存される。 | 選んだ号棟の値で登録する(未選択時の扱いは書かれていない)。 | 区画の選択が必須(サーバで止める)。 |
| 原本と物件の結び付き | 資料全体(offer_key='doc')。 | 「既存の紐づけを利用」としか書かれておらず、住宅系では資料全体のまま。 | 区画ごと(offer:<index>)。事業用の複数募集と同じ。 |
| 残りの区画 | 登録できない(ページは登録済み。登録しても1件目の物件にまとめられる)。 | 画面上は確認待ちに残る。ただし結び付きが資料全体のままだと、保存でまとめられて実現しない。 | 確認待ちに残る。全区画が結び付くまで決着しない(既存の複数募集の規則)。 |
| 物件一覧「価格要確認」 | 価格帯の資料では効かない。 | 変わらない。 | 結び付けた区画の価格と比べる。 |
| 物件編集 | 価格根拠は「どれかの区画の価格と一致すれば可」。 | 変わらない。 | 結び付けた区画の値で照合する。同じマイソクの別区画がどの物件かも分かる。 |
| 重複候補ページ | — | 区画を数えないまま別区画を同じ原本に結び付けると、別区画どうしが「同じ原本ファイルから登録されています」の重複候補になる。 | 区画が2つ以上の原本は「同じ原本」という強い根拠から外れる(既存の複数募集と同じ)。 |
| 自動化(同じ原本の再受信) | 登録済みの1物件の最終更新日を自動で進める。 | 変わらない。 | 人の確認へ回る(論点A)。 |
Issue案とレビュー案は、クイック登録の画面ではほぼ同じに見えます。違いは保存の裏側(何と何を結び付けるか)と、他の画面にあります。「案」を切り替えて、物件一覧と物件編集を見比べてください。
2. レビュー案の本質的なフロー
本質: 1枚のマイソクに売り物(区画・号棟)が複数あるときは、原本と物件の対応を区画単位で持つ。事業用の「募集」(offers・offer:<index>)と同じ単位に、住宅系の lots も載せる。重複候補カードの比較表示は、その上に乗る薄い層にすぎない。
- 読み取り:
lots(区画名・土地面積・価格)は今も保存されている。変更しない。
- 資料を開く: 募集数が2以上なら区画カードを出す。募集数は「
offers が無ければ2件以上の lots」。数え方は PHP と SQL の2関数(khh_qrd_snapshot_offer_total()/khh_qr_intake_doc_offer_total_sql())だけで決める。
- 区画を選ぶ: 選択はページの下書き(既存の
qr_lot_index)に置き、読み取り結果(不変の snapshot)には書かない。比較表・反映の差分・新規登録フォーム・価格根拠は、同じ「区画値の関数」を読む。この関数は snapshot と区画番号から価格と土地面積を返し、区画の根拠が無い項目は要確認として返す。
- 反映か新規登録: 選んだ区画を
t_bukken_source_offer の offer:<index> で束縛する。区画を選ばない登録・反映はサーバで止める。1物件が結び付くのは同じ資料の1区画だけ(主キーが doc×物件のため)。
- 次の区画へ: 全区画が束縛されるまで、ページは確認待ちに残る(既存の
khh_qr_intake_doc_settled())。#9631 の「他の資料も登録済みにする」も同じ規則を読むので、区画単位になる。次の区画へ進む動きは、事業用の khhCommercialAdvance を流用する。
- 登録後: 物件一覧の「価格要確認」、物件編集の価格根拠・AI再読み取り、重複判定が、束縛された区画の値を読む。
- 自動化: 区画が2つ以上ある資料は機械が区画を決められないので、人の確認へ回す。募集番号の無い claim は既に
current_multi_offer で止まる。
3. 論点
オーナー判断A. 同じ複数区画マイソクを再受信したとき
区画単位にすると、機械はどの区画の物件か決められない。推奨: 人の確認へ回す。既定の動きなので追加のコードは要らない。代案: 束縛済みの区画の物件すべてへ touch する(自動化側にコードが要る)。
オーナー判断B. 既存データ(価格0の26件・未登録の区画)
このIssueでは一括で書き換えない。別Issueで読み取り専用の棚卸しをし、土地面積で区画を特定できるものから、直すかどうかを決める。既存の資料全体の束縛は、決着済みのまま扱う(127資料が確認待ちへ戻ることはない)。
C. 旧価格の表示
推奨: 外す。物件に結び付いた複数区画の資料では、対応行99行のうち97行が資料全体の束縛で、「同じ区画の根拠」が無い。旧マイソクを拡大すれば旧価格は読める。値下げに気づく仕組みは、物件一覧の「価格要確認」を区画単位にすることで持たせる。
D. 物件編集に区画をどこまで出すか
最小限は、価格・土地面積の「原本(1号棟)」の表示。同じマイソクの別区画へのリンクは任意で、あれば区画の取り違えに気づきやすい。
E. 区画別の建物面積
lots が持つのは区画名・土地面積・価格だけで、新築戸建では建物面積も区画ごとに違う。読み取りの schema に building_area を足すかは別Issueで決める(新しい読み取りにだけ効く)。それまでは要確認とする(Issue本文と同じ)。
F. 原本の価格を区画単位で持つ方法(実装の判断)
observed_price は資料1行に1値。読むときに束縛の区画番号で lots[index].price を引くか、束縛行に観測価格を持たせるか。絞り込み・バッジ・件数の3か所が同じ述語を読む、という既存の規約(#7506)は守る。
G. 別の資料に分かれた区画
1号棟を資料A、4号棟を資料Bで登録すると、どちらの資料も「1/2区画」のまま残る。別資料の間で区画番号を推測しない既存方針(#7875)を守り、既知の制約とする。
H. 文言
行の名前は「区画」、選択肢は原本のラベル(1号棟、A区画など)をそのまま出す。本番の複数区画資料は土地60・戸建30・事業用2で、号棟より分譲地の区画のほうが多い。
I. ロールバック
旧コードは、区画の束縛行を「何かしらの対応」として読む。1区画だけ束縛した資料は登録済みに、2区画以上を束縛した資料は確認待ちで登録停止に見える。誤った書き込みは起きない。
J. 段取り
PR1 でサーバ側を入れる(募集数に区画を数える・反映を区画で束縛する・区画値の関数・契約テスト)。PR2 で区画カードと比較表を入れる。この順にすると、表示だけ先に入って保存は資料単位のまま、という状態を避けられる。
4. Issue案(v2)からレビュー案で変えた画面
- 区画の選択を比較表の中から、ページ上部の区画カードへ移した。部品は事業用の募集カードと同じ。
- 旧マイソクの価格(「旧マイソク 6,690万円」「旧マイソク比 −200万円」)を外した。
- 1号棟を反映した後に4号棟を選ぶと、「同じ物件として反映する」は押せず、物件ID 2481 がこの資料の1号棟だと示す。
- 「号棟」を「区画」にした。
- 物件編集に「原本(1号棟)」の値と同じマイソクの別区画を、物件一覧に区画単位の「価格要確認」を出した。