该技能聚焦后端开发实践,资料覆盖 API 设计、数据库模式、认证、缓存、限流与可观测性等主题。
用途:设计 API、数据库 schema 或后端系统时参考。
主要能力:
- API 设计:给出 RESTful 约定,如 GET /users 列表、POST /users 创建、GET/PUT/PATCH/DELETE /users/:id,以及嵌套资源 /users/:id/posts;统一响应格式(data 与 meta 分页字段)和错误格式(error.code、message、details)。
- 数据库模式:建议公开 ID 使用 UUID,示例含 SERIAL 主键、public_id UUID、唯一 email、created_at/updated_at,软删除用 deleted_at 字段,并为 email、created_at 建索引;查询模式含游标分页与基于 pg_class 的估算计数。
- 认证:JWT 载荷含 sub、iat、exp、scope,提供 verifyToken 与 authenticate 中间件示例,未授权返回 401。
- 缓存:cache-aside 模式,读取先查 Redis,未命中查库并 setex 写入;更新时删除缓存键。
- 限流:基于窗口与 IP 的 rateLimit 配置,超限返回 429。
- 可观测性:结构化 JSON 日志与请求 ID、延迟与错误率指标、分布式追踪关联 ID、/health 与 /ready 健康检查。
使用方式:资料以代码片段和约定形式呈现,未提供安装命令或运行步骤,暂未提供具体集成方式。
适用场景:后端 API 与数据库设计、微服务模式参考、测试驱动开发相关实践。
限制:资料未说明支持的语言、框架、版本、收费或平台信息,暂未提供;示例代码需按实际技术栈调整。