从零梳理项目架构：一份通俗易懂的分层学习笔记

0. 前言

很多新手 AI 开发者都有一个通病：会调大模型、会写RAG代码，却完全不懂整套项目的落地架构。只会堆砌技术组件，分不清什么项目该用什么架构，照搬大厂顶配方案做小项目，导致过度设计、部署报错、项目臃肿难维护。网上的架构教程偏向传统后端，很少针对AI应用开发做轻量化、落地化讲解。

因此我整理了这份通识笔记，用通俗的商场生活化类比，拆解互联网项目11层完整架构，全程人话讲解、不深挖晦涩原理，只帮AI开发者搞懂层级职责、组件作用、AI项目落地取舍逻辑，补齐AI开发必备的计算机底层通识。

文末针对性补充新手刚需内容：小型、中型AI/业务项目的技术选型取舍，明确哪些组件必装、哪些可以直接舍弃，彻底告别盲目架构，适配日常Demo、毕设、轻量化AI项目落地。

一、十一层架构总览

我们将一整套完整的互联网项目等价为一座大型商业商场，所有技术层级一一对应，逻辑清晰、方便永久记忆：

• L0 基础设施层：地皮、市政水电、园区围墙大门（项目底层硬件、云资源底座）

• L1 运维自动化层：商场统一物业、库房管理、设备机房（容器调度、运维自动化体系）

• L2 公共中间件层：商场中央空调、快递收发室、广播系统（全业务通用技术工具）

• L3 数据持久存储层：商场永久档案室、储物库房（数据永久存储，断电不丢失）

• L4 后端业务逻辑层：商场后台办公室（会计、客服、调度）（项目核心业务计算大脑）

• L5 数据计算与向量知识库层：数据分析办公室、智能检索档案室（大数据统计、AI向量检索核心）

• L6 Web前端层：商场一楼对外门店橱窗、导购屏幕（电脑浏览器可视化界面）

• L7 跨端客户端层：线下售货机、小程序、独立APP（全终端用户入口）

• L8 纯业务流程层：完整购物全流程（进店-选品-下单-付款-售后）（无技术耦合的纯产品业务逻辑）

• L9 测试质量保障层：质检部门（全链路bug检测、性能校验）

• L10 CI/CD流水线层：物流自动化流水线（代码打包、发布、迭代自动化）

• L11 项目文档层：商场图纸、说明书、员工手册（项目配套文档、学习沉淀资料）

二、十一层架构详解

L0 基础设施底座层（IaC）｜项目地皮与机房硬件

层级核心定位：项目最底层硬件、网络、云资源底座，所有程序、服务的运行载体，是整套架构的基石。核心思想IaC基础设施即代码：摒弃手动鼠标配置云资源，通过配置文件一键自动化搭建、扩容、销毁机房资源，高效且可复用。

核心组件解析：

• ECS云服务器：云端24小时不间断运行的远程电脑，是部署项目程序的基础载体；

• GPU机器：高配算力服务器，专为AI大模型、图文生成等高强度计算场景服务，普通服务器无法承载；

• VPC私有网络：项目专属封闭网络环境，与外部陌生项目完全隔离，保障网络安全；

• 子网：私有网络内的分区楼栋，可按功能拆分（数据库子网、前端服务子网），实现精细化管控；

• 安全组/防火墙：服务器网络门禁，通过黑白名单限制IP和网络访问权限，抵御黑客攻击；

• SLB负载均衡：流量分流门卫，高并发场景下自动分摊用户请求到多台服务器，避免服务卡顿、崩溃；

• CDN内容分发网络：全国分布式缓存节点，静态图片、页面就近加载，大幅提升用户访问速度；

• DNS域名：将晦涩的服务器IP地址转换为通俗易懂的网址，是用户访问项目的入口；

• IAM/RAM账号体系：云平台权限分级系统，为开发、运维、新人分配不同操作权限，避免误操作；

• 密钥：服务器、云存储的加密登录凭证，替代传统密码，安全性更高；

• K8s集群：大规模服务器统一调度管理系统，可批量管控上百台机器和程序服务；

• 节点池：集群内配置统一的服务器组，支持批量扩容、下线、运维；

• 命名空间：集群内隔离空间，区分测试环境、生产环境，避免环境互相干扰；

• PV/PVC存储卷：服务器永久硬盘分区，程序文件独立存储，服务器重启数据不丢失；

• 监控告警存储：实时记录CPU、内存、负载等运行数据，服务异常时自动触发告警提醒。

L1 DevOps运维自动化层｜机房物业与容器管理

层级核心定位：衔接底层硬件与上层业务，负责程序打包、部署、调度、环境管控，实现运维全流程自动化，解放人工操作。

核心组件解析：

• Dockerfile：程序打包配置脚本，定义程序运行所需环境、依赖，一键生成标准化程序镜像包；

• 私有镜像仓库：项目专属程序包仓库，仅内部项目可调用，存储前后端标准化镜像；

• 镜像安全扫描：自动检测程序镜像漏洞、病毒，提前规避线上安全风险；

• Deployment：K8s核心调度规则，保障服务常驻运行，程序崩溃后自动重启恢复；

• Service：集群内部服务通信通道，实现后端各服务之间的互相调用，不对外暴露；

• Ingress：项目外网统一入口，用户通过域名、网址访问项目的唯一对外通道；

• ConfigMap：明文配置存储组件，存放接口地址、功能开关等非敏感配置；

• Secret：加密配置存储组件，专门存放数据库密码、API密钥等敏感信息，防止泄露；

• 服务器初始化脚本：自动化环境配置工具，新服务器一键安装依赖、配置环境变量；

• HPA自动扩缩容：智能调度服务器资源，高峰期自动扩容、低峰期自动释放资源，节约成本。

L2 公共中间件服务层｜全业务通用配套工具

层级核心定位：所有业务服务共用的通用工具，不绑定具体业务，专注解决提速、异步、存储、检索等通用技术问题。

核心组件解析：

• Redis缓存：高速临时数据仓库，缓存高频查询、静态不变数据，避免反复查询数据库，大幅提升接口响应速度；

• Kafka/RabbitMQ消息队列：异步任务中转站，将发短信、文档解析等耗时任务异步处理，不阻塞用户操作页面；

• API网关：项目请求总入口，统一完成登录校验、限流、防刷、恶意请求拦截，统一管控所有接口；

• OSS/MinIO对象存储：专属云网盘，专门存储图片、视频、文件附件，不占用业务服务器资源；

• ES搜索引擎：全文检索专用组件，适配知识库、商品搜索等场景，检索效率远超普通数据库模糊查询；

• 定时任务中间件：自动化任务触发器，定时执行数据统计、缓存清理、日志归档等固定任务。

L3 数据持久存储层｜永久数据档案室

层级核心定位：负责项目所有核心数据的永久存储，断电、重启不丢失，保障数据安全、稳定、可查询。

核心组件解析：

• MySQL/PostgreSQL关系型数据库：结构化表格数据库，格式规整，适合存储用户、订单、表单等行列清晰的核心业务数据；

• MongoDB非结构化数据库：无固定表格约束，灵活存储长文本、聊天记录、多层级复杂数据；

• 时序数据库：专属时序数据存储，记录服务器负载、页面访问量等随时间变化的监控数据；

• 分库分表：大数据量优化方案，单表数据过载时拆分数据，分担查询压力，解决卡顿问题；

• 数据备份：定时自动备份全量数据库，支持误删、故障后一键数据恢复；

• 数据同步：主从数据库实时数据复制，主库故障时快速切换备用库，保障服务高可用。

L4 后端核心业务服务层｜项目核心计算大脑

层级核心定位：项目的业务核心，所有用户相关的逻辑计算、数据处理、功能实现均在这一层完成。

核心组件解析：

• 统一返回格式：后端接口固定返回模板，统一数据结构，降低前端适配成本；

• 全局异常捕获：统一拦截程序运行报错，返回友好用户提示，避免乱码、空白报错页面；

• JWT令牌：用户登录电子凭证，每次请求携带令牌，后端校验用户登录状态与身份；

• RBAC角色权限体系：账号分级管控，区分普通用户、运营、管理员，实现权限精准控制；

• CRUD基础操作：开发通用核心操作，即新增、查询、修改、删除，是所有业务的基础；

• 第三方对接模块：对接短信、支付、AI通用接口等外部平台，拓展项目功能；

• RAG后端逻辑：AI问答核心逻辑，负责知识库检索、提示词拼接、大模型调用；

• Agent工具调用：AI自主调用接口、数据库，独立完成订单查询、数据统计等复杂任务；

• 管理后台接口：为运营后台提供数据支撑，实现数据查看、内容审核、批量运维操作。

L5 数据计算&向量知识库层｜AI与大数据核心

层级核心定位：专为大数据统计、AI智能问答服务，负责数据清洗、向量转换、智能检索，是AI项目的核心支撑层。

核心组件解析：

• Milvus/Chroma向量数据库：AI专属数据库，将文本转化为数字向量存储，通过相似度匹配实现智能知识库问答；

• ETL数据清洗：过滤、去重、格式化原始杂乱数据，剔除无效脏数据，保障统计和AI检索精准度；

• 实时数据计算：实时聚合订单、用户访问等数据，生成可视化数据大盘；

• 文档切片：拆分超长知识库文本为小段内容，解决AI长文本答非所问的问题，提升检索精度。

L6 Web前端应用层｜电脑端可视化界面

层级核心定位：用户电脑浏览器可直接看到、操作的页面，负责数据展示、用户交互，承接用户操作并调用后端接口。

核心组件解析：

• Vue/React+TS：主流前端开发框架，搭配语法校验工具，简化代码编写，规避低级bug；

• 路由系统：页面跳转管理器，根据网址自动匹配、切换对应功能页面；

• 全局状态管理：跨页面共享用户信息、全局配置，无需重复请求后端数据；

• Axios请求工具：前端专用网络请求工具，负责调用后端所有业务接口；

• 请求/响应拦截器：统一携带登录令牌、统一处理接口报错，减少重复代码；

• UI公共组件：封装按钮、表格、弹窗等通用页面组件，提升开发效率，统一页面样式；

• ECharts/AntV图表工具：绘制折线图、饼图等数据图表，搭建数据统计可视化大盘；

• 全局CSS/主题：统一网站字体、颜色、间距，实现全站视觉风格统一。

L7 跨端客户端层｜全终端用户入口

层级核心定位：除电脑网页外的所有用户终端载体，实现多端适配，覆盖全场景用户使用需求。

核心组件解析：

• 小程序：微信、抖音轻量化应用，无需下载安装，即开即用，适配移动端轻量场景；

• Flutter/Uniapp：跨端开发框架，一套代码同步生成安卓、苹果APP，无需双端独立开发；

• Electron：基于网页技术开发电脑桌面软件，钉钉、VS Code等主流软件均基于此框架开发。

L8 纯业务产品流程层｜无技术耦合的用户链路

层级核心定位：完全脱离技术框架、代码逻辑，纯粹的产品业务规则，是所有技术架构服务的最终目标。

核心内容包含：用户注册登录、会员体系、下单支付、优惠券活动、AI对话、内容审核、售后流程等用户全生命周期操作链路，是产品设计的核心内容。

L9 测试质量保障层｜全链路bug防控体系

层级核心定位：项目质量质检部门，从代码、接口、全流程、性能多维度排查问题，保障线上服务稳定可用。

核心组件解析：

• 单元测试：测试最小代码单元（工具函数、方法），保障基础功能无bug；

• 接口自动化测试：批量自动调用后端接口，校验数据返回规范性与准确性；

• E2E端到端测试：模拟真人完整操作流程，验证整套业务链路的可用性；

• 性能压测：模拟高并发用户访问，测试服务器承载上限，提前优化性能瓶颈；

• ESLint代码校验：统一代码书写规范，自动检测拼写、语法、格式类低级错误。

L10 CI/CD流水线自动化层｜代码迭代发布体系

层级核心定位：实现代码提交、打包、测试、上线、迭代的全流程自动化，提升开发交付效率，降低上线风险。

核心组件解析：

• Git代码仓库：存储项目全量代码与历史版本，支持多人协作开发，避免代码冲突覆盖；

• 分支管理：区分开发、测试、线上分支，隔离新功能开发与线上稳定服务；

• GitHub Action/Jenkinsfile：流水线配置文件，定义自动化打包、测试、发布的完整步骤；

• 自动打包：自动化完成代码编译、压缩、程序打包，无需人工干预；

• 灰度发布：小范围用户优先更新新版本，验证无故障后全量上线，降低崩溃风险；

• 版本管理：记录迭代版本与更新日志，支持线上故障一键回滚。

L11 项目文档层｜项目沉淀与学习体系

层级核心定位：项目所有标准化资料、学习沉淀的集合，保障项目可维护、可传承、可复盘。

核心内容人话解析：

• PRD需求文档：产品功能说明书，明确所有页面、功能的设计逻辑与实现效果；

• API接口文档：记录接口地址、传参、返回格式，是前后端开发对接的唯一标准；

• 架构设计文档：梳理项目分层、服务依赖、数据流转逻辑，指导整体技术开发；

• 运维操作手册：标准化服务器部署、重启、故障排查流程，方便运维快速处理问题；

• 分层学习笔记：个人技术沉淀，记录知识点、踩坑经验、优化方案，用于长期学习复盘。

总结：

整套计算机项目架构遵循「从底层支撑到上层落地、从技术底座到业务价值」的闭环逻辑：

L0-L1为基础运维底座，保障服务能跑、稳跑；L2-L5为核心技术能力，支撑数据存储、业务计算、AI智能能力；L6-L7为用户交互入口，承接终端用户操作；L8为最终业务价值；L9-L10为质量与交付保障；L11为项目长期沉淀。

所有层级各司其职、层层依赖，构成一套完整、标准、可落地的互联网项目架构体系。

三、小/中型项目 技术选型取舍

前面是完整顶配架构（大厂标准），但我们平时做毕设、个人项目、中小企业开发，完全不需要全上。这里是我总结的真实落地取舍规则。

1. 小型项目（毕设、个人demo、轻量网站、单业务系统）

场景：用户量少、并发低、功能简单、单人/小团队开发

✅ 必须保留的核心组件

• 基础设施：ECS服务器、DNS域名、基础安全组（够用）

• 存储：MySQL必备，简单文件上传可用服务器本地存储替代OSS

• 后端：CRUD、JWT登录、全局异常、统一返回格式

• 前端：Vue/React、Axios、基础UI组件

• 部署：简单Git管理、手动/简单脚本发布

❌ 可以直接砍掉的组件（完全没必要）

• K8s集群、节点池、命名空间（小题大做）

• Redis缓存、MQ消息队列（没并发、没耗时任务）

• ES搜索引擎、时序数据库、分库分表

• 向量数据库、RAG大数据计算

• 完整CI/CD流水线、灰度发布、自动扩缩容

• 复杂监控告警、镜像安全扫描

小型项目最简架构公式：服务器 + MySQL + 前后端基础服务 + 简单部署

2. 中型项目（企业业务系统、商用网站、用户量1w-10w）

场景：有一定用户量、存在并发、有搜索/文件/定时任务需求、团队协作开发

✅ 必须新增的组件（在小型项目基础上升级）

• 性能优化：Redis缓存（优化查询速度）

• 异步解耦：MQ消息队列（处理短信、日志、解析等耗时任务）

• 文件存储：OSS/MinIO（统一管理图片附件）

• 搜索能力：ES搜索引擎（商品/知识库搜索）

• 运维部署：Docker打包、简单CI/CD、基础监控

• 安全管控：API网关、权限系统、数据备份

• 多端适配：按需开通小程序/APP端

❌ 中型项目依旧可以不用的组件

• K8s全套集群（单/多台服务器部署即可，无需集群调度）

• 自动扩缩容、复杂灰度发布

• 向量数据库、大数据ETL（无AI业务不需要）

• 分库分表（数据量没超单表极限无需拆分）

3. 判断规则

• 没并发、没大数据、没AI = 不用缓存、不用队列、不用向量库

• 单项目、小团队 = 不用K8s、不用复杂DevOps

• 有搜索需求才上ES，有文件需求才上对象存储

• 只有大型高并发/AI项目，才需要全套顶配架构

四、适用人群与学习建议

• 新手入门：通过生活化类比快速建立架构认知，告别碎片化学习；

• 开发工程师：梳理各组件层级关系，解决开发中组件混用、架构认知模糊的问题；

• 面试备考：可直接作为架构面试背诵模板，逻辑完整、话术通俗、覆盖面全；

• 运维/AI开发者：精准定位本职工作对应的架构层级，理清上下游依赖。

写在最后：这套11层架构是标准完整项目体系，用于帮我们建立全局认知。实际开发中按需取舍、轻量化落地才是最合理的，不要盲目堆砌技术栈。架构学习不用死记硬背，建立分层思维、理清组件职责，就能轻松吃透全栈技术体系。本文全程干货无废话，建议点赞收藏复盘，持续夯实架构基础！