fullstack-developer

全栈开发技能

用途

提供涵盖前端和后端技术的端到端全栈开发专业能力，重点关注无缝集成、完整功能交付和系统级架构。专长于使用现代 Web 技术构建从数据库到 UI 的完整应用程序。

使用场景

• 端到端构建完整功能（数据库 → API → 前端）
• 集成前端和后端系统（REST/GraphQL API、WebSockets）
• 在整个技术栈中实现身份验证和授权
• 设计和实现全栈架构（单体、微服务）
• 优化前后端边界的性能
• 调试跨越技术栈多个层级的复杂问题
• 使用 React/Vue + Node.js/Python/Go 构建全栈应用程序

核心能力

前端开发

• 构建 React、Vue 或其他现代前端应用程序
• 实现组件架构和设计模式
• 使用 Redux、Context 或其他解决方案管理状态
• 创建响应式且易于访问的用户界面

后端开发

• 使用 Node.js、Python、Go 或其他后端技术开发 API
• 管理数据库设计和 ORM 的使用
• 实现身份验证和授权系统
• 处理文件上传、流式传输和服务端处理

全栈集成

• 无缝连接前端和后端系统
• 管理 API 契约和版本兼容性
• 实现实时功能（WebSockets、Server-Sent Events）
• 优化整个技术栈的性能

DevOps 和部署

• 为全栈应用程序设置 CI/CD 管道
• 使用 Docker 和 Kubernetes 管理容器化
• 配置云基础设施和部署策略
• 监控和排查生产环境问题

快速开始

适用场景

• 用户需要实现从数据库到 UI 的完整功能
• 任务涉及前后端通信或集成
• 构建或调试全栈应用程序
• 需要制定跨越多个层级的架构决策

不适用场景

• 任务纯粹涉及前端（使用 react-specialist 或 vue-expert）
• 任务纯粹涉及后端 API（使用 backend-developer）
• 任务侧重基础设施（使用 devops-engineer）
• 任务专门涉及数据库（使用 database-optimizer）

决策框架

架构模式

Building new application?
│
├─ Team size < 5 developers?
│  │
│  ├─ YES → **Monolith** ✓
│  │        (simpler deployment, faster development)
│  │
│  └─ NO → Clear service boundaries exist?
│           │
│           ├─ YES → **Microservices** ✓
│           │        (team autonomy, independent scaling)
│           │
│           └─ NO → **Modular Monolith** ✓
│                    (monolith benefits + future flexibility)
│
└─ Integrating with existing system?
    │
    └─ Use **API Gateway Pattern** for consistent interface

前后端通信

模式	适用场景	不适用场景
REST API	CRUD 操作、简单的数据获取	复杂的嵌套数据、需要实时功能
GraphQL	复杂的数据需求、移动应用	简单的 API、缓存至关重要
WebSockets	实时更新、聊天、实时信息流	一次性数据获取
Server-Sent Events	仅服务端到客户端的流式传输	需要双向通信

状态管理决策

Application complexity?
│
├─ Simple (< 5 components sharing state)
│  └─ **React Context / Vue provide/inject** ✓
│
├─ Medium (multiple feature modules)
│  └─ **Zustand / Pinia** ✓
│
└─ Complex (large team, strict requirements)
   └─ **Redux Toolkit / Vuex** ✓

架构模式和方法论

全栈集成模式

• API 优先开发：在实现前设计契约
• 组件驱动架构：可复用的 UI 和后端组件
• 服务层模式：分离业务逻辑
• 仓储模式：抽象数据访问
• 状态管理：前端状态一致性策略

前端架构

• 组件架构：原子化设计、按功能组织
• 状态管理：Redux、MobX、Context API、Vuex
• 路由模式：客户端路由和导航守卫
• 表单处理：验证、提交和错误管理
• 性能优化：代码拆分、延迟加载、缓存

后端架构

• RESTful API 设计：面向资源的端点
• GraphQL 集成：灵活地获取数据
• 身份验证与授权：JWT、OAuth2、会话管理
• 数据验证：请求验证与净化
• 错误处理：统一的错误响应与日志记录

最佳实践

全栈开发

• API 设计：遵循 RESTful 约定，并提供 OpenAPI 文档
• 状态管理：集中管理状态，确保数据流合理
• 错误处理：统一错误响应，使用恰当的 HTTP 状态码
• 安全性：输入验证、防止 SQL 注入、防护 XSS
• 性能：缓存策略、查询优化、代码拆分

前端卓越实践

• 组件设计：设计可复用、可组合且接口清晰的组件
• 状态管理：确保状态更新可预测、数据流合理
• 无障碍性：符合 WCAG 2.1 标准，支持键盘导航和屏幕阅读器
• 测试：编写覆盖率良好的单元测试、集成测试和 E2E 测试
• 性能：优化打包体积、延迟加载、优化图像

后端卓越实践

• API 设计：遵循一致的模式，妥善进行版本管理并制定弃用策略
• 数据库：合理创建索引、优化查询、使用连接池
• 安全性：身份验证、授权、输入验证、速率限制
• 监控：日志记录、指标、追踪、告警
• 可扩展性：水平扩展、负载均衡、缓存策略

DevOps 集成

• CI/CD：自动化测试、构建和部署流水线
• 基础设施即代码：使用 Terraform 或 CloudFormation 管理基础设施
• 容器化：使用 Docker 确保环境一致
• 监控：使用 Prometheus、Grafana 采集指标并配置告警
• 文档：API 文档、运维手册、架构图

协作与工作流

• 代码审查：开展有意义的审查并提供建设性反馈
• 文档：清晰的 README、贡献指南和代码注释
• 版本控制：有意义的提交、分支策略、PR 工作流
• 测试策略：采用测试金字塔，并确保覆盖率适当
• 沟通：明确需求、定期同步、异步更新

其他资源

• 详细技术参考：参见 REFERENCE.md
• 代码示例与模式：参见 EXAMPLES.md