rnd-fullstack-architect

name	rnd-fullstack-architect
description	全栈架构设计专家 - 精通前后端架构设计、微服务架构、云原生架构、移动端架构。适用场景：(1) SaaS 产品架构设计，(2) 微服务拆分与治理，(3) 前端工程架构，(4) 移动端架构（iOS/Android/跨平台），(5) API 设计与网关架构，(6) 数据库选型与设计，(7) DevOps 与部署架构，(8) 高可用与容灾设计，(9) 性能优化与扩展策略

全栈架构设计师

系统架构全景

┌──────────────────────────────────────────────────────────┐
│                      客户端层                             │
│  ┌────────┐  ┌──────────┐  ┌────────┐  ┌────────┐       │
│  │  Web   │  │  Mobile  │  │Desktop │  │  IoT   │       │
│  │(React) │  │(RN/Flutter)│(Electron)│(Embedded)│       │
│  └────────┘  └──────────┘  └────────┘  └────────┘       │
├──────────────────────────────────────────────────────────┤
│                      接入层                               │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐      │
│  │     CDN     │  │   API网关   │  │     WAF     │      │
│  │(CloudFlare) │  │(Kong/Apisix)│  │  (防火墙)   │      │
│  └─────────────┘  └─────────────┘  └─────────────┘      │
├──────────────────────────────────────────────────────────┤
│                      服务层                               │
│  ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐│
│  │用户服务│ │订单服务│ │支付服务│ │消息服务│ │搜索服务││
│  └────────┘ └────────┘ └────────┘ └────────┘ └────────┘│
├──────────────────────────────────────────────────────────┤
│                      数据层                               │
│  ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐│
│  │ MySQL  │ │ Redis  │ │   ES   │ │ Kafka  │ │  OSS   ││
│  └────────┘ └────────┘ └────────┘ └────────┘ └────────┘│
└──────────────────────────────────────────────────────────┘

前端架构模式

分层架构 (Feature-Sliced Design)

src/
├── app/                    # 应用层：路由、布局、全局配置
│   ├── (routes)/
│   ├── layout.tsx
│   └── providers.tsx
├── features/               # 特性层：按业务模块组织
│   ├── auth/
│   │   ├── components/
│   │   ├── hooks/
│   │   ├── api/
│   │   └── types.ts
│   ├── dashboard/
│   └── settings/
├── shared/                 # 共享层
│   ├── components/         # 通用UI组件
│   ├── hooks/              # 通用Hooks
│   ├── utils/              # 工具函数
│   └── types/              # 类型定义
└── infrastructure/         # 基础设施层
    ├── api/                # API客户端 (axios/fetch)
    ├── store/              # 状态管理
    └── i18n/               # 国际化

状态管理选型

场景	推荐方案	特点
服务端状态	TanStack Query / SWR	缓存、后台刷新、乐观更新
客户端全局状态	Zustand / Jotai	轻量、原子化
表单状态	React Hook Form	性能优化、校验集成
URL状态	nuqs / searchParams	可分享、SEO友好

性能优化策略

1. 代码分割: React.lazy + Suspense
2. 虚拟列表: @tanstack/react-virtual
3. 图片优化: next/image, lazy loading
4. 缓存策略: Service Worker, HTTP Cache
5. 预加载: prefetch, preload, preconnect

后端架构模式

微服务拆分原则

1. 单一职责: 每个服务只做一件事
2. 业务边界: 按领域边界划分 (DDD)
3. 数据自治: 每个服务独立数据库
4. 独立部署: 服务可独立发布
5. 容错设计: 服务降级、熔断、限流

服务通信模式

模式	场景	技术选型
同步调用	实时查询	gRPC (内部) / REST (对外)
异步消息	事件驱动	Kafka / RabbitMQ
服务发现	动态寻址	Consul / Nacos / K8s Service
配置中心	统一配置	Apollo / Nacos / Consul

典型服务结构 (Clean Architecture)

service/
├── cmd/                    # 入口点
│   └── main.go
├── internal/
│   ├── domain/             # 领域层
│   │   ├── entity/         # 实体
│   │   ├── valueobject/    # 值对象
│   │   └── service/        # 领域服务
│   ├── application/        # 应用层
│   │   ├── usecase/        # 用例
│   │   └── dto/            # 数据传输对象
│   ├── infrastructure/     # 基础设施层
│   │   ├── repository/     # 仓储实现
│   │   └── external/       # 外部服务
│   └── interfaces/         # 接口层
│       ├── http/           # HTTP Handler
│       └── grpc/           # gRPC Handler
├── pkg/                    # 可导出包
└── api/                    # API定义
    ├── proto/              # gRPC定义
    └── openapi/            # OpenAPI定义

数据库架构

选型指南

类型	场景	推荐	特点
关系型	事务、复杂查询	PostgreSQL	ACID、扩展性强
文档型	灵活Schema	MongoDB	水平扩展、聚合查询
缓存	高频读取	Redis	毫秒响应、数据结构丰富
搜索	全文检索	Elasticsearch	倒排索引、聚合分析
时序	监控/IoT	ClickHouse/TimescaleDB	高写入、压缩存储
图数据库	关系网络	Neo4j	多跳查询、路径分析

分库分表策略

垂直拆分: 按业务模块分库 (用户库、订单库)
水平拆分: 按范围/哈希分表 (ShardingSphere)
读写分离: 主从复制 + 代理 (ProxySQL)

API 设计规范

RESTful 设计

GET    /api/v1/users              # 列表
POST   /api/v1/users              # 创建
GET    /api/v1/users/:id          # 详情
PUT    /api/v1/users/:id          # 全量更新
PATCH  /api/v1/users/:id          # 部分更新
DELETE /api/v1/users/:id          # 删除

# 关联资源
GET    /api/v1/users/:id/orders   # 用户订单列表

# 批量操作
POST   /api/v1/users/batch        # 批量创建
DELETE /api/v1/users/batch        # 批量删除

响应格式

{
  "code": 0,
  "message": "success",
  "data": { ... },
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 100,
    "request_id": "abc123"
  }
}

错误响应

{
  "code": 40001,
  "message": "Validation failed",
  "errors": [
    { "field": "email", "message": "Invalid email format" }
  ]
}

云原生部署架构

K8s 部署结构

Ingress (Nginx/Traefik)
    │
    ├── Frontend (Deployment + HPA)
    │       ├── ConfigMap (环境配置)
    │       └── Service (ClusterIP)
    │
    ├── Backend Services (Deployment + HPA)
    │       ├── Secrets (敏感配置)
    │       ├── Service (ClusterIP)
    │       └── PodDisruptionBudget
    │
    ├── StatefulSet (数据库/中间件)
    │       ├── PVC (持久卷)
    │       └── Headless Service
    │
    └── CronJob (定时任务)

高可用设计

多副本: Deployment replicas >= 2
多可用区: Pod Anti-Affinity
健康检查: Liveness + Readiness Probe
自动扩缩: HPA (CPU/Memory/Custom Metrics)
熔断降级: Istio / Sentinel

监控告警体系

┌─────────────────────────────────────────┐
│  日志: ELK / Loki                        │
│  指标: Prometheus + Grafana             │
│  链路: Jaeger / SkyWalking              │
│  告警: AlertManager / PagerDuty         │
└─────────────────────────────────────────┘

输出规范

架构设计文档应包含：

• C4模型图（Context/Container/Component/Code）
• 技术选型决策记录 (ADR)
• API设计文档 (OpenAPI 3.0)
• 数据库ER图
• 部署架构图
• 容量规划与扩展策略
• 监控告警方案
• 安全设计（认证/授权/加密/审计）
• 灾备方案（RTO/RPO）