| name | project-architect |
| description | 项目架构与选型技能。当用户开始新项目、需要技术选型、系统设计、或遇到架构问题时自动激活。
触发词：新项目、技术选型、架构设计、系统设计、高并发、高可用、
微服务、数据库设计、项目结构、技术方案、重构、性能瓶颈、
架构评审、系统重构、高可用设计、容量规划、系统架构、架构咨询、性能瓶颈分析。
|
项目架构与选型技能
技术选型决策树
新项目
├── 纯前端展示？
│ ├── 需要SEO？ → Next.js(SSR) / Nuxt.js(SSR)
│ ├── 管理后台？ → React+Ant Design / Vue+Element Plus
│ └── 营销H5？ → Vue3+Vant+GSAP
│
├── 需要后端？
│ ├── 快速MVP？ → Supabase + Vercel (零后端代码)
│ ├── 中等复杂度？ → NestJS + Prisma + PostgreSQL
│ ├── 企业级？ → Spring Boot + MyBatis-Plus + MySQL
│ └── 高性能？ → Go + Gin + PostgreSQL
│
├── 需要移动端？
│ ├── 小程序为主？ → uni-app (一套代码多端)
│ ├── APP为主？ → React Native / Flutter
│ └── 鸿蒙原生？ → ArkTS + ArkUI
│
└── 需要AI能力？
├── 国内直连？ → DeepSeek / 通义千问 / 火山方舟
├── 海外？ → Gemini / Mistral / OpenAI
└── 开源模型？ → HuggingFace Inference API
数据库选型
| 场景 | 推荐数据库 | 理由 |
|---|
| 通用业务 | PostgreSQL | 功能最强，JSONB/全文搜索/扩展 |
| 国内传统项目 | MySQL 8.0 | 生态成熟，运维资源多 |
| 缓存/会话/队列 | Redis 7 | 内存KV，性能极高 |
| 文档/日志 | MongoDB | 灵活Schema，聚合管道 |
| 搜索引擎 | Elasticsearch | 全文检索/日志分析 |
| 时序数据 | ClickHouse | OLAP分析，列式存储 |
架构模式选择
单体架构 (项目初期推荐)
适用：用户<10万，团队<5人，快速验证
优点：开发快、部署简单、调试方便
缺点：后期扩展受限
技术：Next.js全栈 / NestJS单体
微服务架构 (中后期演进)
适用：用户>50万，团队>10人，业务复杂
优点：独立部署、技术异构、故障隔离
缺点：运维复杂、分布式事务
技术：Spring Cloud / NestJS Microservices + gRPC
Serverless架构 (低频/事件驱动)
适用：流量波动大、事件驱动、成本敏感
优点：按量付费、零运维、自动扩缩
缺点：冷启动、调试困难、供应商锁定
技术：Vercel Edge / Cloudflare Workers / AWS Lambda
高并发方案
用户请求 → CDN(静态资源)
→ 负载均衡(Nginx/SLB)
→ API网关(限流/鉴权/路由)
→ 服务集群(水平扩展)
→ Redis缓存(热点数据)
→ 消息队列(削峰填谷)
→ 数据库(读写分离+分库分表)
项目启动流程
- 需求分析 → 确定核心功能(MVP)
- 技术选型 → 用上面的决策树
- 数据库设计 → ER图 + 表结构
- API设计 → OpenAPI文档 + Mock服务
- 前端开发 → 组件库 + 页面开发
- 后端开发 → 接口实现 + 单元测试
- 联调测试 → E2E测试 + 性能测试
- 部署上线 → Docker + CI/CD + 监控
- 迭代优化 → 数据驱动 + A/B测试
ADR 架构决策记录模板
# ADR-001: 选择 NestJS 作为后端框架
## 状态：已采纳
## 背景
项目需要同时支持Web端和小程序端，团队熟悉TypeScript
## 决策
采用 NestJS + Prisma + PostgreSQL
## 理由
1. 前后端统一TypeScript，降低沟通成本
2. NestJS模块化架构，适合中大型项目
3. Prisma类型安全ORM，开发效率高
4. PostgreSQL功能全面，JSONB支持灵活数据
## 后果
- 优点：开发效率高，类型安全，生态好
- 缺点：NestJS学习曲线较陡，运行时性能不如Go
