[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-79244":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":15,"forks30d":15,"starsTrendScore":19,"compositeScore":20,"rankGlobal":9,"rankLanguage":9,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":24,"hasPages":24,"topics":25,"createdAt":9,"pushedAt":9,"updatedAt":46,"readmeContent":47,"aiSummary":48,"trendingCount":15,"starSnapshotCount":15,"syncStatus":49,"lastSyncTime":50,"discoverSource":51},79244,"awesome-architecture","study8677\u002Fawesome-architecture","study8677","🧭 Architecture-first system design: 26 bilingual tutorials, 25 architecture templates, and 6 end-to-end cases covering distributed systems, AI-native systems, RAG, coding Agents, and production trade-offs.",null,"Vue",1301,145,4,1,0,14,143,1045,100,104.49,"MIT License",false,"main",true,[26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45],"ai-agents","architecture-decision-records","architecture-patterns","awesome","backend","c4-model","chinese","design-patterns","distributed-systems","interview-preparation","learning-resources","llm","microservices","rag","scalability","software-architecture","software-engineering","system-design","system-design-interview","tech-interview","2026-06-12 04:01:24","# Awesome Architecture · 架构图谱\n\n> 一个专注「**架构**」而非「代码」的开源知识库。\n> 收集真实热门系统的架构模板,并配一套让你成为更好架构师的教程。\n\n[English](.\u002FREADME_en.md) · **简体中文**\n\n**🌐 在线阅读(可交互 · 中英双语,HTTPS):** \u003Chttps:\u002F\u002Fstudy8677.github.io\u002Fawesome-architecture\u002F>\n\n**🧭 配套 skill:** [architecture-copilot](https:\u002F\u002Fgithub.com\u002Fstudy8677\u002Farchitecture-copilot) —— 把这套知识变成能在 Claude Code \u002F Cursor \u002F Codex 里**引导你一步步设计架构**的交互式 skill。\n\n---\n\n## 这个仓库为什么存在\n\n过去二十年,程序员的核心竞争力是「**把代码写对、写快**」。\n\n但有一件事正在我们眼前发生:**「写代码」这件事,正在消失。** 不是变难,也不是变少,而是作为「一门靠人来做的稀缺手艺」正在终结。在 OpenAI、Anthropic 这样的前沿实验室,代码几乎已经全部由 AI 写出,人类工程师不再亲手敲实现——他们只做两件事:**告诉 AI 要造什么,然后判断它造得对不对。** 当机器几秒就能吐出能跑的代码,\"用 `for` 还是 `map`、背没背过某个 API、熟不熟某种语法\"这些曾经的看家本领,一夜之间一文不值。\n\n真正不会贬值、而且越来越值钱的,是另一种能力:\n\n> **在动手写第一行代码之前,先想清楚这个系统应该长什么样子。**\n>\n> 数据从哪来、到哪去?哪些部分必须强一致、哪些可以最终一致?\n> 哪里会先崩?用户从 1 万涨到 1 亿时,第一个瓶颈在哪?\n> 为了拿到 A,我愿意放弃哪个 B?\n\n这就是**架构思维**。它和具体语言无关,和框架无关,甚至和今年流行什么无关。它是一种「**先看地图,再上路**」的判断力。\n\n**本仓库的信念:未来优秀的开发者,首先是一个会做架构判断的人,其次才是会写代码的人。** 你应该先在架构层面对自己要做的东西有清晰的理解,代码只是把这个理解落地的手段之一。\n\n---\n\n## 仓库里有什么\n\n```\nawesome-architecture\u002F\n├── tutorial\u002F      📚 教程 —— 系统地教你「怎么像架构师一样思考」\n└── templates\u002F     🗺️ 模板 —— 真实热门系统的架构地图,只讲架构、不讲语法\n```\n\n### 📚 tutorial\u002F —— 成为更好架构师的教程\n\n不是讲「某个框架怎么用」,而是讲一套可迁移的思考方法:如何把模糊的需求拆成约束,如何在取舍中做决策,如何画出能沟通的架构图,如何从 0 设计一个全新系统。\n\n| 章节 | 主题 | 你将学会 |\n|---|---|---|\n| [01](tutorial\u002F01-为什么先有架构思维.md) | 为什么先有架构思维 | 为什么「架构优先」是这个时代的核心技能 |\n| [02](tutorial\u002F02-架构师的思考框架.md) | 架构师的思考框架 | 需求 → 约束 → 质量属性 → 取舍 的通用流程 |\n| [03](tutorial\u002F03-读懂与画好架构图.md) | 读懂与画好架构图 | 用 C4 模型把脑中的系统画出来、讲明白 |\n| [04](tutorial\u002F04-十大核心架构模式.md) | 十大核心架构模式 | 分层、微服务、事件驱动、CQRS… 各自解决什么问题 |\n| [05](tutorial\u002F05-数据与状态.md) | 数据与状态 | 为什么「数据」才是系统真正的难点 |\n| [06](tutorial\u002F06-质量属性与取舍.md) | 质量属性与取舍 | 性能\u002F可用性\u002F一致性\u002F成本,怎么权衡 |\n| [07](tutorial\u002F07-从0到1设计一个系统.md) | 从 0 到 1 设计一个系统 | 一套可照着做的实战方法论 |\n| [08](tutorial\u002F08-架构决策记录与演进.md) | 架构决策记录与演进 | 用 ADR 记录决策,让架构随业务长大 |\n| [09](tutorial\u002F09-架构品味.md) | 架构品味 | 框架之外什么在拉开差距;用真实案例(微服务回单体、各大公司审美)养出判断力 |\n\n**🚀 进阶篇(10–17,新增)—— 驾驭「做大做关键后才咬人」的硬骨头:**\n\n| 章节 | 主题 | 你将驾驭 |\n|---|---|---|\n| [10](tutorial\u002F10-分布式系统的硬道理.md) | 分布式系统的硬道理 | 部分失败、无全局时钟、共识的代价、exactly-once 幻觉 |\n| [11](tutorial\u002F11-数据一致性工程.md) | 数据一致性工程 | Saga、Outbox、幂等、事件溯源、CQRS |\n| [12](tutorial\u002F12-为失败而设计.md) | 为失败而设计·韧性工程 | 级联失败、熔断、舱壁、降载、SLO、混沌工程 |\n| [13](tutorial\u002F13-规模化的力学.md) | 规模化的力学 | 一致性哈希、热点、多活、尾延迟与扇出放大 |\n| [14](tutorial\u002F14-演进与拆分大型系统.md) | 演进与拆分大型系统 | 绞杀者、并行运行、零停机迁移、拆单体、DDD 限界上下文 |\n| [15](tutorial\u002F15-组织即架构.md) | 组织即架构 | 康威 \u002F 逆康威、团队拓扑、平台工程 |\n| [16](tutorial\u002F16-安全与多租户架构.md) | 安全与多租户架构 | 威胁建模、零信任、爆炸半径、租户隔离 |\n| [17](tutorial\u002F17-大模型时代的架构判断.md) | 大模型时代的架构判断 | vibe coding、非确定性、上下文工程、agentic 硬骨头 |\n\n**🎯 实战篇(18–22,规划中)—— 把方法落到真实案例,补上「教程 → 模板」之间的桥:**\n\n| 章节 | 主题 | 你将练会 |\n|---|---|---|\n| 18 | 读地图:用框架拆解陌生系统 | 对着 `templates\u002F` 逆向读懂「为什么这么设计」 |\n| 19 | 完整设计演练:中等复杂度系统 | 07 八步流程第二次完整走法(票务\u002F支付级硬约束) |\n| 20 | 演进剧本:MVP 到规模化 | 08 + [演进触发信号](tutorial\u002F演进触发信号.md),同一系统的三段人生 |\n| 21 | 拆分与迁移实战 | 14 章方法案例化:绞杀者、并行运行、零停机迁移 |\n| 22 | AI 原生系统设计 | 17 章三个新约束的落地演练,引向 AI 协同篇 |\n\n**🤝 AI 协同设计篇(23–26,规划中)—— 会设计之后,学会与 AI 协作落地与审查:**\n\n| 章节 | 主题 | 你将掌握 |\n|---|---|---|\n| 23 | 规格即架构:约束怎么写给 AI | ADR \u002F `AGENTS.md` → 可执行护栏,对接 [architecture-copilot](https:\u002F\u002Fgithub.com\u002Fstudy8677\u002Farchitecture-copilot) |\n| 24 | 审查清单:AI 产出默认缺什么 | 11\u002F12\u002F16 的生产级 review checklist |\n| 25 | 评测驱动:把「够好」写进架构 | eval 当 CI 门禁,承接非确定性 |\n| 26 | 协作决策树:何时 vibe、何时 spec-first | 原型 vs 生产的 workflow 总收束 |\n\n> 👉 **新手从 [tutorial\u002FREADME.md](tutorial\u002FREADME.md) 开始**,那里有完整的学习路径。\n\n### 🗺️ templates\u002F —— 真实系统的架构模板\n\n每一个模板都是一张「架构地图」。我们**刻意不讨论用什么语言、什么框架**,只讨论:这类系统在解决什么问题、由哪些部件组成、数据怎么流动、关键决策怎么取舍、规模化时会死在哪里。\n\n> 目前共 **25** 个模板(16 经典 \u002F 通用 + 5 AI 原生 + 4 AI 编码 \u002F 自治 Agent),每个都在末尾附**真实开源项目 \u002F 工程文档链接**,可顺着去读源码。\n\n**经典 \u002F 通用系统:**\n\n| 模板 | 代表产品 | 核心架构看点 |\n|---|---|---|\n| [AI 对话产品](templates\u002Fai-chat-product\u002FREADME.md) | Claude、ChatGPT | LLM 推理、流式输出、上下文管理、RAG、成本控制 |\n| [浏览器插件](templates\u002Fbrowser-extension\u002FREADME.md) | Honey、Grammarly | 内容脚本\u002F后台分离、页面注入、隐私边界、变现 |\n| [普通网站](templates\u002Fstandard-web-app\u002FREADME.md) | 企业官网、博客、SaaS 后台 | 经典三层、缓存、读写分离的「够用就好」 |\n| [移动 App](templates\u002Fmobile-app\u002FREADME.md) | 大多数 iOS\u002FAndroid 应用 | 离线优先、数据同步、客户端状态、推送 |\n| [电商平台](templates\u002Fecommerce-platform\u002FREADME.md) | Amazon、Shopify、淘宝 | 库存、订单、支付、超卖、大促洪峰 |\n| [社交信息流](templates\u002Fsocial-feed\u002FREADME.md) | Twitter\u002FX、Instagram | Feed 拉取\u002F推送、关注关系、热点扩散 |\n| [视频流媒体](templates\u002Fvideo-streaming\u002FREADME.md) | Netflix、YouTube | 转码、CDN、自适应码率、推荐 |\n| [实时通讯](templates\u002Frealtime-chat\u002FREADME.md) | WhatsApp、Slack、微信 | 长连接、消息时序、离线投递、群扩散 |\n| [短链接服务](templates\u002Furl-shortener\u002FREADME.md) | Bitly、TinyURL、t.co | 读多写少、缓存、301\u002F302、分布式唯一 ID |\n| [支付系统](templates\u002Fpayment-system\u002FREADME.md) | Stripe、支付宝、PayPal | 幂等、复式记账、对账、状态机 |\n| [搜索引擎](templates\u002Fsearch-engine\u002FREADME.md) | Google、Elasticsearch | 倒排索引、相关性排序、召回+精排、分片 |\n| [网约车 \u002F 出行](templates\u002Fride-hailing\u002FREADME.md) | Uber、滴滴 | 地理空间索引、实时位置、供需匹配、动态定价 |\n| [实时协同文档](templates\u002Fcollaborative-doc\u002FREADME.md) | Google Docs、Figma | OT\u002FCRDT、单 writer 串行、操作日志、离线同步 |\n| [云存储 \u002F 网盘](templates\u002Fcloud-storage\u002FREADME.md) | Dropbox、iCloud | 文件分块、内容寻址去重、增量同步、断点续传 |\n| [通知 \u002F 推送系统](templates\u002Fnotification-system\u002FREADME.md) | Novu、FCM\u002FAPNs | 多渠道扇出、去重限频、异步重试、优先级 |\n| [在线票务 \u002F 抢票](templates\u002Fonline-ticketing\u002FREADME.md) | Ticketmaster、大麦、12306 | 虚拟等候室、原子扣减防超卖、锁座超时 |\n\n**🤖 AI 原生系统(LLM 时代新增):**\n\n| 模板 | 代表产品 \u002F 原型 | 核心架构看点 |\n|---|---|---|\n| [AI 中转站 \u002F 网关](templates\u002Fai-gateway\u002FREADME.md) | One API、LiteLLM、Portkey | 统一接口、计费限流、负载均衡、故障转移、缓存 |\n| [RAG 知识库](templates\u002Frag-knowledge-base\u002FREADME.md) | RAGFlow、LlamaIndex、Dify | 切块、向量检索、混合检索+重排、引用溯源 |\n| [AI Agent \u002F 工作流](templates\u002Fai-agent-platform\u002FREADME.md) | Dify、Coze、LangGraph | 行动循环、工具沙箱、记忆、可控兜底 |\n| [模型推理服务](templates\u002Finference-serving\u002FREADME.md) | vLLM、SGLang、Triton | 连续批处理、分页 KV 缓存、量化、多副本 |\n| [向量数据库](templates\u002Fvector-database\u002FREADME.md) | Milvus、Qdrant、pgvector | ANN 近似最近邻、HNSW\u002FIVF、召回-延迟权衡 |\n\n**🦾 AI 编码 \u002F 自治 Agent(2026 新增,真实在用的 Agent 产品架构):**\n\n| 模板 | 代表产品 \u002F 原型 | 核心架构看点 |\n|---|---|---|\n| [Claude Code](templates\u002Fclaude-code\u002FREADME.md) | Claude Code(Anthropic) | 本地优先编码 agent、子代理\u002F钩子\u002F技能\u002FMCP、双层权限 + OS 沙箱、上下文压缩 |\n| [OpenAI Codex](templates\u002Fcodex\u002FREADME.md) | Codex CLI + Cloud | 本地 CLI 与云端异步沙箱双形态、沙箱 × 审批双轴、默认断网防注入、自动开 PR |\n| [OpenClaw(龙虾 🦞)](templates\u002Fopenclaw\u002FREADME.md) | OpenClaw(原 Clawdbot) | 自托管 Gateway、聊天软件即 UI、心跳 \u002F cron、可插拔 harness、记忆即纯文本 |\n| [Hermes(爱马仕)](templates\u002Fhermes\u002FREADME.md) | Hermes(Nous Research) | 常驻自我成长、FTS5 持久记忆、自动沉淀技能、cron、多渠道 \u002F 多 provider |\n\n> 👉 **想加入自己的模板?** 套用 [templates\u002F_TEMPLATE.md](templates\u002F_TEMPLATE.md) 的统一格式即可。\n\n---\n\n## 怎么用这个仓库\n\n**如果你是初学者 \u002F 想转向架构思维:**\n按顺序读完 `tutorial\u002F`,每读完一章,就去 `templates\u002F` 里挑一个你感兴趣的系统,试着用刚学的框架去「读懂」它。\n\n**如果你正要设计一个新系统:**\n先去 `tutorial\u002F07` 学方法论,再去 `templates\u002F` 里找最接近你场景的那张地图,把它当作起点而不是答案——照着它的「关键决策」和「常见误区」逐条问自己。\n\n**如果你在准备系统设计面试:**\n`templates\u002F` 里的每个模板都覆盖了高频考点(超卖、Feed 扩散、消息时序、流式输出…),按统一格式组织,适合系统性复习。\n\n**如果你是资深工程师 \u002F 架构师:**\n直接看每个模板的「关键决策与权衡」和「演进路线」,这是最浓缩的部分。欢迎贡献你踩过的坑。\n\n---\n\n## 三条阅读原则\n\n1. **先问「为什么」,再看「怎么做」。** 任何一个架构选择,背后都是某个约束或某个取舍。看不到取舍,就等于没看懂。\n2. **没有最好的架构,只有最合适的架构。** 同样是「聊天」,做一个内部工具和做微信,答案天差地别。规模、团队、成本、合规决定一切。\n3. **架构是会长大的。** 不要拿成熟期的架构去套 MVP。每个模板都给了「演进路线」,告诉你什么时候该升级、什么时候过度设计。\n\n---\n\n## 一句话总结\n\n> **代码告诉计算机要做什么;架构决定这件事到底值不值得做、能不能做成、扛不扛得住。**\n> 这个仓库,帮你练后面那种判断力。\n\n---\n\n## ⭐ Star 历史\n\n> 如果它帮到了你,点颗 Star 就是对它最好的鼓励。\n\n\u003Ca href=\"https:\u002F\u002Fstar-history.com\u002F#study8677\u002Fawesome-architecture&Date\">\n  \u003Cpicture>\n    \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=study8677\u002Fawesome-architecture&type=Date&theme=dark\" \u002F>\n    \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=study8677\u002Fawesome-architecture&type=Date\" \u002F>\n    \u003Cimg alt=\"Star History Chart\" src=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=study8677\u002Fawesome-architecture&type=Date\" \u002F>\n  \u003C\u002Fpicture>\n\u003C\u002Fa>\n\n---\n\n## 🔗 友链\n\n- [LINUX DO](https:\u002F\u002Flinux.do\u002F) —— 新的理想型社区,一群热爱技术、乐于分享的开发者聚集地。\n","awesome-architecture 是一个专注于软件架构设计而非代码实现的开源知识库，旨在培养开发者的架构思维。该项目提供了21个架构模板，涵盖AI网关、RAG、代理、推理服务、向量数据库等，并配有一套系统设计教程，所有模板都链接到真实的开源原型。核心功能包括中英文双语支持、可交互式的在线阅读体验以及配套的架构设计辅助工具。适合希望提升自己在系统设计与架构方面能力的开发者，特别是那些准备技术面试或想要深入了解现代分布式系统架构模式的人士使用。",2,"2026-06-11 03:57:37","CREATED_QUERY"]