first commit

migrations/AGENTS.md

@@ -0,0 +1,35 @@
+# 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
+
+無。