Feature/blog cms public api

[vH192Hv]

设计方案

新增公开 REST API

GET /api/blog/:slug

响应格式

成功 (200):

{
  "id": "uuid",
  "title": "Post Title",
  "slug": "post-slug",
  "content": "Markdown content...",
  "excerpt": "Short description",
  "coverImage": "https://...",
  "status": "PUBLISHED",
  "authorId": "uuid",
  "author": { "id": "uuid", "username": "admin" },
  "tags": [
    { "id": "uuid", "name": "Getting Started", "slug": "getting-started" }
  ],
  "publishedAt": "2026-01-01T00:00:00.000Z",
  "createdAt": "2025-12-01T00:00:00.000Z",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}

未找到或未发布 (404):

{ "error": "Post not found" }

缺少参数 (400):

{ "error": "Slug parameter is required" }

安全设计

检查	行为
slug 参数缺失或非字符串	400 Bad Request
帖子不存在	404 Not Found
帖子状态 ≠ PUBLISHED	404 Not Found（不暴露草稿/归档）
认证	不需要 — 完全公开
Date 序列化	所有时间戳通过 .toISOString() 序列化

Wasp Spec 声明

// blog-cms.wasp.ts
import { api } from "@wasp.sh/spec";
api("GET", "/api/blog/:slug", getPublishedPostBySlugApi),

与现有查询的关系

此 API 端点补充了 Branch 2 中已实现的 Wasp Query：

• getPostBySlug — Wasp Query（同功能，供 Wasp 前端调用）
• getPublishedPostBySlugApi — REST API（供外部消费者如 Astro 博客调用）

两者返回相同数据结构，仅调用方式不同。

执行方案

• 在 operations.ts 添加 GetPublishedPostBySlugApi 类型导入
• 实现 getPublishedPostBySlugApi handler（slug 校验 + 404 + Date 序列化）
• 在 blog-cms.wasp.ts 声明 API 路由
• 修正 api() spec 签名格式适配 Wasp v0.24+

文件变更

文件	操作	行数
template/app/src/blog-cms/operations.ts	修改	+30
template/app/src/blog-cms/blog-cms.wasp.ts	修改	+3

🔽 依赖 PR2 (operations) — 合并顺序第 3（与 PR3 并行）