生成前端串接需求書（FastAPI → frontend.md）

目標

根據「目前既有的 FastAPI 後端 API 服務程式碼」，撰寫一份給前端工程師使用的串接需求與流程說明文件，輸出檔名固定為 frontend.md，並以 Markdown 撰寫、結構清楚、可直接交付前端實作。

核心原則（非常重要）

• 以「前端要怎麼串、怎麼做 UI/UX、怎麼處理錯誤與狀態」為主，而不是後端實作細節。
• 必須從程式碼中整理出事實：路由、request/response schema、認證方式、狀態值、錯誤碼。
• 不要憑空編造 API。若程式碼找不到，就在文件中標注「未在目前程式碼中發現」並給出前端建議的問項（最多 3 個關鍵問題）。
• 文件讀者假設：從未看過後端程式碼的前端工程師。