Yuruicamp

Yuruicamp API Contracts（索引）

欄位	內容
狀態	Active
日期	2026-07-21
欄位策略	甲：對齊 DB／架構決策的精簡契約；舊 Mock 胖欄位不當真相
實作清單	plans/backend-implementation-checklist.md
ENUM	docs/schema-enums.md

改約流程（強制）

1. 改契約文件並升版 → 2) 改後端 DTO／OpenAPI → 3) 改前端 Mock 正規化 → 4) 打 API 驗收。 禁止只改一邊。

---

契約一覽

優先	文件	階段	狀態
共用	common-api-conventions.md	全部	Locked v0.1
P0	auth-api-contract.md	A	Locked v0.1（已實作）
P0	product-api-contract.md	B	Locked v0.3（B-1～B-5b 已完成）
P0	branch-api-contract.md	B	Locked v0.1（B-7 已完成）
P0	checkout-api-contract.md	C/F	Locked v0.5（Checkout 與優惠券套用已實作；付款後消耗待線 D）
P0	order-api-contract.md	C	Locked v0.1（待實作）
P0	payment-api-contract.md	D	Locked v0.1（待實作）
P1	booking-api-contract.md	E	Locked v0.9（E-1～E-7 已實作；Booking Prepare／Reservation 完成，ECPay、優惠券分別延後至 D、F）
P1	coupon-api-contract.md	F	Partially Implemented v0.2（商城完成；Booking 關聯 Schema 待決定）
P1	admin-api-contract.md	G	Locked v0.4（G-1、G-2a、G-2b、G-5 已實作；其餘 G-2～G-4 待做）

刻意延後（P2，本輪不寫死）

領域	原因
Articles／Reviews	MVP 可延後
calendar_dates 維護	P2

---

給新手的閱讀順序

1. common-api-conventions.md（Envelope、金額、認證）
2. auth-api-contract.md + product-api-contract.md（已能打通的範例）
3. checkout → order → payment（商城能買）
4. booking → coupon → admin

---

與前端開關

前端	開關
商城／預約	USE_MOCK_API = false，API_BASE_URL = http://localhost:8080/api
後台	AdminAPI.configure({ useBackend: true, baseUrl: 'http://localhost:8080/api/admin' })