01-schema-setup.md

資料庫綱要設定 (Schema Setup)

AI Agent Target: Outlines the initialization sequence and setup commands for Firebase, Supabase, MongoDB, and PowerSync schemas.
Human Target: 設定底層資料儲存與同步元件的逐步指南。

1. Firebase RTDB

Firebase 即時資料庫用於即時狀態與設定。

• 部署規則: 部署 database.rules.json 以保護節點。
• 初始結構: 建立包含問題、使用者與考試的根節點。
• 索引 (Indexes): 確保針對 topic 與 isApproved 等鍵值設定 .indexOn 以支援查詢。

2. Supabase PostgreSQL

Supabase 作為主要的關聯式資料庫，並支援 PowerSync。

• 資料庫遷移 (Migrations): 依序執行 8 個 SQL 遷移檔案。
• pgvector: 啟用 pgvector 擴展以支援 AI 相似度搜尋。
• RLS 策略: 套用資料列層級安全性 (Row Level Security) 以隔離使用者筆記與分析。
• Edge Functions: 部署所需的邊緣函式。
• 儲存 (Storage): 建立公開/私有儲存體以存放使用者頭像與媒體。

3. MongoDB Atlas

用於高效能文件快取與搜尋引擎。

• 資料庫: 建立資料庫與集合 (Questions, Users)。
• 索引: 建立必要的文字與複合索引。
• 存取: 將正式伺服器與 CI/CD 執行器的 IP 位址加入白名單。

4. PowerSync

透過 SQLite 複寫提供行動裝置的離線優先功能。

• 規則: 部署 powersync_rules.yaml。
• 連線: 使用複寫角色將 PowerSync 連結至您的 Supabase PostgreSQL 實例。