🔗 點此造訪正式上線網站 (Hotel Partner System) (註：此為企業正式營運中之商業產品。由於原始碼具版權保護，本 Repo 僅供架構分享與能力佐證，不提供完整業務邏輯程式碼)
📖 專案概述 (Project Overview)
本專案是為園區合作飯店開發的 B2B 票券管理平台。為了解決過去實體券核銷繁瑣、人工對帳數據不精確的痛點，系統實現了從「飯店端自主產券」到「園區端即時核銷」的全數位化流程。核心亮點在於支援「單張 QR 多人、分次核銷」的複雜邏輯，極大提升了入園效率與數據透明度。
🚩 B2B 合作的營運瓶頸
在與飯店合作發放票券時，過往的作業模式存在以下風險：
- 核銷難度高：園區現場難以辨識飯店發出的實體憑證真偽，且無法追蹤已使用人數。
- 結算爭議多：由於缺乏即時數據，雙方在月底對帳結算時常因「入園人數」認知不一而產生爭議。
- 體驗不佳：多人同行的家庭若分批入園，傳統票券難以處理「部分核銷」。
💎 核心商業價值 (Business Value)
| 評比項目 | 傳統人工核對 | 本數位核銷系統 | 商業價值 |
|---|---|---|---|
| 行政成本 | 每月 4–6 小時人工對帳 | 即時統計、自動對帳 | 累計節省 100+ 小時 成本 |
| 數據即時性 | 數據延遲 3-5 天 | 秒級同步、即時掌握人流 | 數據驅動營運決策 |
| 核銷精確度 | 易有人為疏失或超額領取 | 原子化扣額、嚴格效期檢核 | 確保每一分營收資產安全 |
| 用戶體驗 | 流程繁瑣、易遺失票券 | 數位 QR 隨身、流程極簡 | 提升合作夥伴與遊客滿意度 |
🛠️ 技術亮點 (Technical Highlights)
- 全棧型別安全 (End-to-End Type Safety)：採用 React 18 + TypeScript + Supabase，結合 Zod 進行嚴謹的資料校驗，確保系統的高穩定性。
- 靈活的額度核銷引擎：
- 多人分次使用：單張 QR 可設定總人數（如家庭票），支援分批入園核銷。
- 原子更新 (Atomic Updates)：確保在高併發環境下，剩餘名額扣減絕對精確。
- 權限控管 (RBAC)：嚴謹的角色區分，確保飯店夥伴、掃碼員工與管理員僅能存取授權範圍內的數據。
- 效期管理：自動化的有效期檢核機制，降低逾期票券誤用的營運風險。
🏗️ 系統架構
├── src
│ ├── pages # Partner (飯店端), Scan (核銷端), Admin (後台)
│ ├── supabase # RLS 安全策略與資料庫配置
│ ├── hooks # 業務邏輯封裝 (Quota Management)
│ └── components # 響應式 UI 組件 (Ant Design)
🌈 未來展望
本系統架構具備高度擴展性，未來可輕鬆接入更多合作品牌，或與會員 CRM 系統對接，實現從入園核銷到園內消費行為的全鏈路數據追蹤。
Created by s110905 (2026)
💡 AI 協作筆記：本專案之架構設計與核心邏輯優化係透過與 AI 深度對話共同完成，展現了高效能的 AI 輔助開發模式。