API Migration

這個資料夾用來追蹤 legacy PHP 5.6 API 到 pro360_api_82 的搬移狀態。

先看哪裡

目的	文件
看整體規則、狀態定義、目前優先順序	overview.md
review 搬移程式是否有 legacy parity / DB side effect 風險	migration_review_checklist.md
複製近期切換 API 清單	recently_updated_apis.md
從 API path 查目前盤點狀態	quote_requests.md, quote_bids.md, quote_services.md, quote_categories.md, users.md, other.md
看已深入調查的流程規則	details/README.md
看 `quote_bids/change_status` 各 filter	details/quote_bids/change_status/README.md
查 legacy 正式機 access log 位置、rotation 與共用語法	_meta/access_log.md

文件層級

層級	用途	不放什麼
`README.md`	文件入口與導覽	不放搬移細節
`overview.md`	整體範圍、狀態定義、優先順序	不放完整 endpoint 表
`migration_review_checklist.md`	搬移程式 review 共用檢查清單	不放單支 API 實測結果
`quote_*.md` / `users.md` / `other.md`	endpoint inventory，以 path 為主	不放長流程規則
`details/**`	已調查 API 的業務規則、DB side effect、測試、流量紀錄	不放整體盤點表

查一支 API 的順序

先到對應 module index 找 path，例如 /quote_bids/... 看 quote_bids.md。
若備註有 detail link，進 detail 文件看完整規則。
若是 change_status，直接進 change_status filter index。
若要判斷是否仍有 legacy 流量，先看共用的 _meta/access_log.md，再把單支 API 結論寫回對應 inventory 或 detail。

維護原則

path 對照只維護在 module index。
business rule 維護在 details/**。
流量查詢結果要寫清楚日期、機器、log 範圍與結果。
不要把同一段規則複製到多份文件；總覽只放連結與一句話摘要。
搬移 legacy API 時要明確檢查 PHP 5.6 -> PHP 8.2 runtime 差異；重點是 isset / empty / null、缺 key / 缺關聯資料、warning / notice 是否改變 response 或 DB side effect。