# 開発の経緯 ## 2026-10-24 — 依頼、調査、初版 - 所有者から「ハトの生態・行動を論文を含めて調査し、大阪・日本橋の地図データで 3D マップを作り、ハトが自律行動するアプリ(ハト視点の再現、観察中心、将来は操作も)」という依頼。 - ディープリサーチを実施し、ハトの生態・視覚・行動と、日本橋の 3D 地図データ(PLATEAU / OSM)の調査レポートを作成([docs/research/report.md](research/report.md))。調査の推奨は PLATEAU LOD1 だったが、実データの取得と統合が先に成立したため、初版は OpenStreetMap を採用した(PLATEAU 差し替えは将来の拡張候補として残置。アプリ内の調査ノートに高さ情報源の内訳と理由を記録)。 - **初版(v1)を同日納品**: OpenStreetMap 実データの 3D マップ(建物 9,079 棟、堺筋・千日前通・御堂筋、阪神高速の高架、道頓堀川・東横堀川)の上で 24 羽のドバトが自律行動。行動パラメータは調査値(巡航 8〜16 m/s、速度連動の羽ばたき 6.6〜8.9 Hz、首振り hold/thrust、二段着陸、producer/scrounger 採餌、吸水飲水、求愛 bow-coo、夕方のねぐら帰還)。モードは観察・追跡・鳩視点(頭部カメラ+視覚マップ、紫外帯疑似カラー)・操作(リーダーとして群れを誘導)の 4 つを初版から実装。イベントは餌まき・ハヤブサ襲撃・夕方スキップ。初期不具合 2 件(鳩視点で建物内部へ入る、デスクトップ解像度で「群れを飛ばす」が固まる)を修正・再検証して納品。 - 所有者からフィードバック 3 点(建物とハトをもっとリアルに/観察モードでハトが遠い/餌まきの反応が分かりにくい)を受け、同日中に改善版を納品: 建物の窓・階線・反射・建物ごとの色・屋上構造物・街路樹・露出の抑制、観察開始位置をハトの近くにして追跡・リング・矢印・名前タグ・距離表示、餌は大きな粒・光柱・ラベル・接近するハト・反応パネルで可視化。 ## 2026-10-24 — 生態の指摘とリアリティ改修、季節・天候 - 所有者から「ハトがずっと飛んでいるが、普段見るハトは地上で採餌している。生態として正しいのか」との指摘。調査レポートと照合し、実在のドバトは覚醒時間の大半を地上の採餌と止まり木の休息に使い、飛行はねぐらと採餌場の短距離移動と逃避が中心(バーゼルの GPS 研究では 3 割超の個体がねぐらから 300 m 以内に留まる)であり、初版の行動配分は飛行に寄りすぎていたことを確認。 - 行動配分のリバランス: 定期飛行はシミュレーション時間 80〜170 分間隔のタイマー式にし、群れの 25〜55% が 2〜4 区間の短距離移動のみ。朝の出発と夕の帰還だけ全羽飛行。地上で座る loafing(休息)を追加し、群れチップに地上/止まり/飛行の内訳を常時表示。 - 同時に所有者から「鳩も場所もリアリティをとことん追求してください」との方針。場所はファサードを用途別 4 種(オフィスのガラスカーテンウォール、商業の看板帯+店舗ガラス、住宅のバルコニー+室外機、低層店舗のシャッター+庇)にアトラス化し、屋上広告塔、街灯、電柱・架線、自販機、マンホール、横断歩道、袖看板、高架の桁帯と半透明の遮音壁、川面の流れを追加。ハトは首の構造色が視点角度で緑↔紫に変化、離着陸時の脚下げ、着陸時の尾の扇状展開、眼・嘴の拡大を行った(部分完了として納品。監査環境の制約で路上小物の判別は未検証のまま残った——この「未検証の持ち越し」が後の検証停滞の伏線になる)。 - **季節・気象シミュレーションを実装**: 大阪(緯度 34.67°・経度 135.51°)で太陽位置を計算し(夏至 4:45/19:13、冬至 7:02/16:51)、日の出・日没でハトのスケジュール、光の色温度、影を駆動。季節は実日付連動の自動+春夏秋冬の手動切替。街路樹は季節で色替えし冬は落葉。ハトは繁殖期の求愛・巣材運び増、夏の水飲み・水浴び増、冬の羽膨らみ・ねぐら延長・群れ凝集。天候は晴れ・曇り・雨・強雨・雪・強風に季節重み付き自動遷移し、雨粒・濡れ路面・水たまり・積雪・木の揺れ・曇天の影消失を描画。雨では高架下への避雨、雨上がりの水浴び、強風での飛行間隔延長と風下ドリフト、雪での採餌範囲縮小を実装。残件だった夕方の窓明かりも日没連動で点灯するようになり解消。HUD に季節・天候・気温・日の出/日の入りを表示。 - 至近 LOD の改修(必須改善 6 項目): 嘴・蝋膜の分離ジオメトリ、虹彩・瞳孔+眼環、関節・爪付きの脚趾、尾羽 12 枚、翼帯の高コントラスト二重化、分割テクスチャの精細化、遮蔽建物の自動半透明化、生態修正(繁殖状態、hold 比 0.63、二段着陸の原則化、序列キュー、飲水・採餌の場所限定)、名簿パネルと個体カード、影カメラの追随と動的解像度などを実施。 ## 2026-10-30 — 検証の停滞とその対策、9 項目改善 - 初版以来、街路レベルの判別確認(電柱・架線、自販機、マンホール、横断歩道、遮音壁、首の虹色、赤い脚、袖看板の文字、川面の質感)が「監査環境の制限」を理由に 6 日間未完了のままだった。セルフレビューの結果、根本原因は 3 層だった: (1) 監査ハーネスはソフトウェア WebGL で 15 秒の読み込み上限があり、デスクトップシーンの初回描画がその予算に収まらない、(2) 監査経路を唯一の検証経路として扱い、独立した実ブラウザ経路を試していなかった、(3) 失敗が納品報告の留保に埋まり、担当と次の手つきを持つ未完了項目として残らなかった。 - 再発防止として運用ルール化: 「監査キャプチャの失敗は検証の終端状態ではない。独立経路(公開リンクを実ブラウザで開く)を必ず 1 回試し、それでも確認できない項目は GOAL の記録に担当と次の手つき付きで残す」。 - 判別できなかった 9 項目すべてに手を入れる改善ビルドを作成し、視点ボタン 3 つ(路面で見る/川面を見る/高架の遮音壁)を追加。 ## 2026-10-31 — 再検証の反復と項目の閉鎖、低速設定、OSS 公開 - 所有者の指示で公開リンクを新ビルドへ更新し、項目ごとの実ブラウザ再検証を実施: マンホールは確認、6 項目は要素のみの部分確認、首の虹色と赤い脚は未確認。 - 首と脚に絞った追加改善(首は方位で回る緑⇔紫グラデーション+フレネル層を首〜胸へ拡張、脚は鮮やかな赤 #ea0d0d・半径約 2 倍・体高引き上げ、至近 LOD で脚のステップ駆動が止まる除外の撤廃、ステップ振幅と持ち上げの増加)を実施し、再検証で **首の虹色は確認**(3 個体・1.9〜3.4 m 接写で角度によりグラデーションが流れる)、脚は色・太さを確認。ただし接写対象はテレメトリ表示に反して速度 0 km/h で留まり続け、左右交互ステップは確認できなかった。 - フォーカスなし・路面視点での再確認(×10)では、歩行そのものと歩行中の鮮やかな赤い脚を確認。一方で距離約 10〜11 m では交互ステップは読み取れず、「フォーカスした個体は留まる」という仮説の裏付けが強まった。 - 低速での再確認を試みたところ、当時のビルドの速度 UI には ×1・×2 が存在せず(停止・×10・×60・×600 のみ)、低速条件自体が成立しないことが判明。所有者の選択で **×1・×2 の低速設定を追加** し、公開リンクへ再共有したうえで最終再確認(×1→×2、路面視点、フォーカスなし)を実施したが、脚が数ピクセルで左右・前後の区別がつかず、歩行もその場の小刻みな採餌中心で、交互ステップはなお読み取れなかった。 - 所有者が「ステップは観察条件の限界として記録し、この件は閉じてよい」と判断し、項目 7 は色・太さ・歩行の確認済み+ステップは観察限界として閉鎖。これで 2026-10-30 改善ビルドの 9 項目はすべて処分済みになった。 - 同日、所有者の指示で本リポジトリを作成し、成果物を OSS として公開した。