37-用AI从零搭建AI聚合平台的架构心得

用 AI 从零搭了一个企业级全栈项目——AI 朋友圈（AI 聚合管理平台），后端 webman + PostgreSQL + Redis，前端 Vue3 + Arco Design，一共 5 个模块，从立项到上线比预期快了一倍多。这篇记录用 AI 做架构设计的心得。

1. 让 AI 当架构师，而不是打字员

很多人用 AI 只让它写函数、写页面，这是浪费。架构阶段才是 AI 价值最大的地方——你给它约束，它能给你一版像样的整体设计，而且比人脑考虑得更全。

立项时我直接让 AI 出方案：

我要做一个 AI 内容生成平台，核心功能：
1. AI 生成文案/海报/视频
2. 用户作品管理、会员系统、积分奖励、模板管理
技术栈：后端 PHP，要求高性能常驻内存；前端 Vue3；数据库 PostgreSQL + Redis 缓存。
请给我：
- 模块划分和目录结构
- 数据库表设计（重点：会员、积分、模板）
- 后端分层架构规范
- 部署方案（要求 Docker）

AI 给了一版相当完整的方案，我在上面改了两轮就定了。最后落地的架构：

backend/    # API 服务（webman，REST API，PostgreSQL/Redis）
frontend/   # 后台管理 SPA（Vue3 + Vite + Arco Design）
web/        # 官网首页（纯静态，SEO 落地页）
h5/         # 移动端子站（React，App 内嵌/微信分享）
invite/     # 邀请页面（纯静态，调后端接口）

心得：AI 是很好的架构师，前提是你给它足够的业务约束。约束越具体，方案越靠谱。

2. 分层架构：让 AI 按规范产出，代码才不乱

PHP 项目最怕写着写着变成一坨。立项时就让 AI 定分层规范，之后所有功能都按这个骨架生成：

1	Controller → Logic → Service → Model

Controller：只做参数接收和响应返回
Logic：业务编排
Service：核心业务逻辑
Model：数据访问

每让 AI 写一个接口，都要求它按这个分层拆，结果就是几千行代码下来结构依然清晰，后面加功能、改需求都很快。

心得：AI 写代码本身不产生架构，规范才产生架构。规范定在前，AI 只是执行者。

3. 让 AI 同时生成前后端，契约先行

传统开发最痛的是前后端联调：接口对不上、字段名不一致、返回结构不统一。用 AI 之后，我让 AI 先把接口契约定死：

1
2
3

请设计"作品列表"接口：
- 请求参数、响应结构、错误码、分页字段
- 同时给出后端路由定义和前端 TypeScript 类型定义

后端按契约实现，前端按同一份契约写类型，联调时基本一遍过。数据库表结构也让 AI 同步生成迁移文件和 Model，字段名全程统一。

心得：AI 做”翻译”很弱，但做”契约生成”很强。让同一份描述同时产出前后端代码，等于自动对齐了接口。

4. 常驻进程框架的坑：AI 默认按”请求-响应”思维写

webman 是常驻内存框架，和传统 PHP（php-fpm）的思维完全不同。AI 一开始经常写出这样的问题代码：

在类属性里缓存用户数据（常驻进程下会串数据）；
用全局变量存临时状态（下一个请求还留着）；
不知道进程里定时任务、队列、WebSocket 是长期运行的，写了死循环式轮询。

解决方式：在项目文档里写明框架特性，并让 AI 生成代码时遵守：

注意：本项目使用 webman 常驻内存框架。
- 禁止在类属性/全局变量中存储请求级数据
- 涉及用户上下文的数据必须从请求对象获取
- 后台任务使用 process 进程，不要用 sleep 轮询

心得：给 AI 的上下文里，框架特性比代码示例更重要。它不懂的框架，你得先喂规则。

5. AI 生成静态页是降维打击

5 个模块里，web（官网）和 invite（邀请页）是纯静态页面，这两个模块 AI 基本一把梭：我给它产品卖点、文案风格、配色，它直接生成完整页面，还自带 SEO 标签（OG 标签、Schema.org JSON-LD、站点地图）。

这类”没有复杂逻辑、只有展示”的页面，AI 产出质量非常高，人工只需要调调细节。

心得：把项目里”简单重复”的部分识别出来交给 AI，把精力留给”有业务深度”的部分。

6. 让 AI 帮写部署脚本

项目上线要 Docker 化，Dockerfile、docker-compose、Jenkins 这些我以前都是复制粘贴改，这次直接让 AI 写：

请为这个 webman 项目写 Dockerfile：
- PHP 8.2 环境，装好 pdo_pgsql、redis 扩展
- 多阶段构建，安装 composer 依赖
- 顺便给一份 docker-compose.yml，包含 postgres 和 redis 服务

出来的脚本可以直接跑，节省了大量时间。

总结

用 AI 做全栈项目的正确姿势，是把 AI 放在”设计-生成-校验”的循环里：

你定架构、定契约、定规范，AI 负责把每一块高质量落地。人机各干各擅长的。