全栈工程实践：从架构到交付的 10 条硬规则

1) 架构：分层与依赖有界

  • 前后端明确边界，前端通过 API/SDK 调用，后端领域拆分（用户/订单/支付）。
  • 避免“跨层直取数据库”，所有访问经服务接口或仓储层。
  • 公共组件独立包，禁止业务互相 import 实现类。

2) API 契约优先

  • 先定义 OpenAPI/GraphQL schema，再写实现与前端调用。
  • 生成类型与客户端 SDK，避免手写重复代码。
  • 版本化：/v1 /v2，旧版设 sunset 计划。

3) 配置与秘密分离

  • 12-Factor：配置用环境变量/配置中心，密钥放 Secret/密文文件。
  • 本地/测试/生产分层配置，禁止把密钥写进仓库与镜像。

4) 可观测性三件套

  • 日志结构化（JSON），关联 trace_id/span_id。
  • 指标：HTTP QPS/延迟/错误、DB 连接与慢查询、队列积压。
  • 链路追踪：前后端/网关/服务/DB 贯通；异常自动告警。

5) 测试金字塔

  • 单测覆盖核心纯逻辑；集成测试覆盖 API/数据流；端到端覆盖关键用户路径。
  • 为外部依赖（支付/三方 API）做 mock，避免不可控的 flakiness。
  • CI 中把慢测试与快测试拆层并行。

6) CI/CD 与发布策略

  • CI：lint/单测/构建/安全扫描（SAST/依赖漏洞）。
  • CD：灰度发布（分流或副本），回滚脚本/开关预置。
  • 基础设施即代码：Kubernetes/Compose/Terraform 写进仓库。

7) 数据与缓存

  • 事务边界清晰；读写分离要配合幂等与一致性方案。
  • 缓存三要素：过期/淘汰/回源限流；热点用预热+锁。
  • 审计：重要表留审计日志，避免误操作难追。

8) 安全基线

  • 认证/授权前置；最小权限的 Token/密钥；避免长时效凭据。
  • 输入输出：防注入/模板逃逸；文件上传白名单与鉴权。
  • 依赖管理：定期升级、漏洞扫描、镜像签名。

9) 前端交付

  • Core Web Vitals（LCP/FID/CLS）持续监控；首屏关键资源预加载。
  • 组件库与设计规范统一；Dark/Light、i18n 规划好路径。
  • 缓存策略：静态资源指纹长缓存，HTML 短缓存或 no-store。

10) 运行与成本

  • 资源配额与自动扩缩容（HPA/VPA）；定期清理废弃实例与未用存储。
  • 日志/指标留存周期可配置，冷热分层；对象存储替代磁盘。
  • 成本可视化与预算告警，避免“默默失控”。

自查清单（精简）

  • API 契约有 schema/版本与 SDK
  • 配置/密钥未进仓库，分环境管理
  • 日志结构化 + trace，核心指标有告警
  • 单测/集成/E2E 分层并在 CI 执行
  • 灰度与回滚手段可用
  • 缓存策略与限流熔断
  • 安全扫描通过，依赖更新可追踪
  • 前端性能监控上线
  • 资源配额、自动扩缩容、成本告警