yingfungsolar/migrations/AGENTS.md

migrations/AGENTS.md

Purpose

Cloudflare D1 的 schema migration 同種子資料。

Ownership

• 擁有 migrations/ 全部 SQL、migrations/meta/ 同 seed.sql。
• Drizzle schema 定義喺 src/db/schema.ts（見 src/db/AGENTS.md）。

Local Contracts

• Migration 由工具產生：0000_*.sql、0001_*.sql 由 npm run db:generate（drizzle-kit）依 schema.ts 產生；migrations/meta/ 係產生檔。唔好手改呢啲檔或 meta。
• seed.sql 係手寫、獨立於 migration：全部用 INSERT OR REPLACE，可重複執行。db:migrate 唔會執行 seed。
• 指令（本機用 :local，雲端省略）：
  • npm run db:generate — 由 schema 產生 migration
  • npm run db:migrate:local / npm run db:migrate — 套用 migration
  • npm run db:seed:local / npm run db:seed — 匯入種子
• Seed 內容：公司資料（site_settings）、首頁內容（content_items：service/feature/step/faq）、cases、一篇示範 posts。
• DB 名稱 yingfung-solar-db，binding 喺 wrangler.jsonc（database_id 仍係佔位，部署前要填）。

Work Guidance

• 改 schema → 先 db:generate，再 db:migrate:local；改 seed → 直接 db:seed:local。
• 新增 setting key 時同步更新 src/data/settings-fields.ts。

Verification

• npm run db:migrate:local && npm run db:seed:local，再用 npm run db:studio 或 SQL 查證。
• npm run build。

Child DOX Index

無。