书鸿的个人技术空间 · Juno Mak Digital Garden

书鸿Juno Mak在代码、架构与文字之间构建秩序

这里记录后端工程、云原生、API 网关、缓存系统、对象存储与 AI Agent 的工程化实践。

Agent Studio

Agent 开发项目

工具调用、记忆系统、任务规划、向量检索、评测与部署的工程化项目入口。

选择今日阅读人格

🧑‍💻 夜行 Debugger
🛰️ 系统架构航海家
⚡ 缓存命中猎人
🤖 Agent 召唤师

文章流

后台精选 Top 5 与全部文章检索。

Top 5 · 1/5

全部文章

检索全部文章,Top 5 只是后台精选展示。

13 篇文章 · 第 1/3
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 辅助写作、自动摘要、引用检查、文章质量评分和知识库联动。