Backend Capability Map
后端优先设计
先设计数据模型、内容流、搜索、精选、统计、订阅和后台管理，再逐步接入前端。
核心数据模型
Post
id, slug, title, summary, content, status, visibility, published_at
文章主体，支持草稿、定时发布、归档、SEO 摘要和多语言扩展。
PostTopRank
post_id, rank, reason, start_at, end_at, enabled
后台人工选择 Top5 的核心表，前端文章流只读取启用中的前五条。
Tag / Category
id, name, slug, parent_id, weight, color
分类和标签体系，支撑检索、聚合、推荐和文章归档。
EventLog
event_type, path, post_id, referrer, user_agent, created_at
访问统计、阅读完成率、热门文章和推荐排序的基础事件表。
核心 API 分组
Public Content API
GET /api/postsGET /api/posts/:slugGET /api/posts/topGET /api/tags
Admin CMS API
POST /admin/postsPUT /admin/posts/:idPOST /admin/posts/:id/publishPUT /admin/top-posts
Search API
GET /api/searchGET /api/archiveGET /api/recommendations
Interaction API
POST /api/commentsPOST /api/messagesPOST /api/subscribePOST /api/events
实施阶段
1. MVP
文章 CRUD、标签分类、Top5 精选、公开文章列表和详情。
2. V1
全文搜索、最近阅读、订阅、留言、访问统计和后台登录。
3. V2
MDX、版本历史、推荐排序、阅读完成率、RSS、Webhook 通知。
4. V3
Agent 辅助写作、自动摘要、引用检查、文章质量评分和知识库联动。