用途:为后端设计与实现提供一套“精英级”规范,核心原则是隔离功能、不信任任何输入、线性扩展。主张按业务能力(垂直切片)组织代码,禁止以控制器/服务/仓储等横向分层作为主要目录;每个特性目录内含 handler、logic、schema、db 等文件,通用代码仅放入 shared。架构上反对一开始就用微服务,主张模块化单体:模块间通过事件通信而非直接导入代码,采用 Outbox 模式保证数据变更与事件写入同一事务,模块不得查询其他模块的表。
安全与可靠性:输入在进入逻辑前先用 Zod/Pydantic 等做模式校验,禁止返回原始数据库实体,改用 ResponseDTO;令牌推荐 PASETO v4,JWT 则用 Ed25519。性能目标为 P50 低于 100ms、P99 低于 500ms,主键使用 UUIDv7 而非 UUIDv4,避免 N+1 查询。错误响应遵循 RFC 7807 Problem Details,关键 POST/PATCH 需支持 Idempotency-Key,缓存 24 小时。
数据与运维:数据库约束视为“法律”,使用外键、唯一索引、检查约束;大表分页用游标而非 OFFSET/LIMIT;破坏性变更采用扩展-收缩模式;并发更新用乐观锁版本列。日志仅用带关联 ID 的 JSON 结构化日志,分布式追踪使用 OpenTelemetry 并携带 traceparent。提供存活与就绪两种健康检查,外部调用加断路器,公开接口用令牌桶限流并按角色区分。工作流要求启动时校验环境变量、先定义 DTO 与错误状态,测试遵循单元/集成(Testcontainers)/端到端三层。反“幸福路径”要求每个业务逻辑切片至少记录并测试竞态、数据完整性与边界三类失败场景。限制:该资料为规范与最佳实践集合,未提供具体实现代码、依赖版本、许可或收费信息。