docs: document admin dashboard redesign

This commit is contained in:
2026-09-13 21:46:58 +08:00
parent 9eed1d32d3
commit cc142bfd06
2 changed files with 6 additions and 3 deletions
+1
View File
@@ -14,6 +14,7 @@ D1 讀取查詢層(`content.ts`)同後台網站設定欄位定義(`setting
- **查詢集中**:所有前台/Blog 的 D1 查詢寫喺 `content.ts`,唔好散落喺頁面或元件。
- **只回前台可見**`getItems` / `getCases` / `getPublishedPosts` 只回 `status = "published"`,並按 `sortOrder``publishedAt DESC` 排序;`getPostBySlug` 同時要求 published。
- **首頁聚合**`getHomeData(db)``Promise.all` 一次過攞 settings + services/features/steps/faqs + cases,形狀係 `HomeData`
- **後台總覽聚合**`getDashboardData(db)``DashboardData``posts``cases``content``keywords` 各狀態計數+`recentPosts` 最新 5 篇+`postsWithoutCover`),供 `/admin` dashboard 用;只讀 DBAI secrets 由頁面層 `getEnv()` 提供。
- **關鍵字佇列**`getKeywords(db)` 回全部 `blog_keywords`(按 `createdAt``id` 排序),供 `/admin/ai` 用。
- **Slug 去重**`uniqueSlug(db, base, selfId?)` 撞 slug 就加 `-2``-3`…;`selfId` 用喺更新自己時排除自己。admin 文章同 AI 生成都用。
- **`Db` 型別**`DrizzleD1Database<typeof schema>`