新规范发布:Web 系统后端通用架构规范 v1.0
今天发布了一份新的技术规范——《Web 系统后端通用架构规范 v1.0》。
这是一份什么样的规范?
它定义了 Web 系统后端架构层的全量工程契约,核心定位是三个 "不绑定":
- 不绑定架构形态:同时适用于单体、模块化单体、微服务与分布式系统
- 不绑定技术栈:不限定编程语言与框架,示例仅为说明契约语义
- 不绑定实现细节:只约束"必须遵守什么",实现方案与配置示例放在附录
规范覆盖哪些内容?
全篇共 26 个章节 + 1 个参考附录,覆盖后端架构的方方面面:
- 架构基础:全局无状态设计、前后端分离优先、分层架构与模块组织
- 工程契约:错误码体系(E1~E5 分类 + 边界收敛)、常量分类管理、接口与 SPI 扩展机制
- 运行韧性:认证授权(OAuth2.0/RBAC)、远程调用超时重试熔断降级、缓存全生命周期、消息队列消费、定时任务调度
- 数据与安全:数据访问与查询门禁、事务与本地事务表、数据库备份恢复(RTO/RPO)、文件对象存储、应用层安全(注入/XSS/越权)
- 质量与交付:测试与 CI 门禁、API 设计、日志与链路追踪、指标告警、部署发布、镜像与 CI/CD
文档体系
规范的顶层文档之下,还规划了配套的下位扩展规范,按场景按需引入:
| 规范 | 状态 |
|---|---|
| 《多租户与数据隔离规范》 | ✅ 已发布 |
| 《AI 与大模型扩展规范》 | 📝 待编写 |
| 《灰度发布实施细则》 | 📝 待编写 |
| 《分布式调度规范》 | 📝 待编写 |
阅读方式
规范的完整正文已归档到本站文档模块(分类:技术规范),可随时查阅与归档。
全文较长,建议按章节索引检索——架构审查红线(§26)可作为团队评审时的快速 Checklist。
后续规范更新与下位扩展文档,都会在 "技术规范" 分类下持续归档。