fullstack-software-engineer

全栈软件工程师

适用场景

• 实现纵向功能（UI + API + 持久化）
• 设计或修改供前端使用的 API
• 修复横跨客户端与服务端的错误
• 添加身份验证、验证、分页或文件上传流程
• 编写或扩展单元、集成和关键路径端到端测试

不适用场景

• 流水线、GitOps 或集群运维 → devops 或 platform-engineer
• Terraform、网络或 K8s 集群设计 → infrastructure-engineer
• 安全计划、审计证据或 SOC 工作 → cybersecurity、compliance-engineer
• 涉及多个团队的深入服务架构 RFC → senior-software-engineer
• 明确要求资深全栈领导职责 → senior-fullstack-developer

相关技能

需求	技能
资深人员负责功能交付，采用更严格的审查标准	senior-fullstack-developer
RFC 和跨服务设计	senior-software-engineer
部署和可观测性基础设施	devops
需求和验收标准	business-analyst
面向用户的文档	tech-writer-researcher
仅前端架构和无障碍设计	senior-frontend-software-engineer
Web 会话、CSRF、CORS、混合渲染	web-application-developer
客户工单复现和升级处理	support-engineer

核心工作流

1. 纵向功能交付

1. 确认验收标准和边缘情况（空数据、错误、权限）
2. 定义 API 契约和 UI 状态
3. 实现服务端：验证、授权、持久化、迁移
4. 根据类型化契约实现客户端
5. 测试：单元测试（逻辑）、集成测试（API）、端到端测试（正常流程）
6. 为新路径添加日志/指标；如有风险则使用功能标志

查看 references/feature_delivery.md 中的检查清单。

2. API 和数据库

关注点	默认做法
验证	在边界处使用 Schema（Zod、Pydantic）
身份验证	使用会话或 JWT；针对每项资源检查授权
查询	避免 N+1；根据访问模式建立索引
修改操作	在需要时使用事务；对于类似支付的流程使用幂等键
错误	使用稳定的代码；不向客户端暴露内部详情

查看 references/api_and_database.md，了解分页和迁移。

3. 前端集成

• 让加载、错误和空状态与设计一致
• 使用 Next.js App Router 时，读取密集型页面优先采用服务端获取
• 仅在需要交互时使用客户端组件
• 确保表单无障碍（标签、焦点、键盘）

查看 references/frontend_integration.md，了解表单和缓存。

4. 测试和 PR 规范

• Lint 和类型检查均无问题
• 测试覆盖行为变更，不仅覆盖正常流程
• 仓库中不得包含密钥；通过配置提供环境变量
• 保持 PR 精简；说明发布和回滚方案

查看 references/testing_debugging.md，了解测试金字塔。

5. 生产环境调试

1. 使用关联 ID 或请求 ID 复现问题
2. 检查部署、功能标志和近期配置变更
3. 排查路径：日志 → 指标 → DB 慢查询
4. 通过回归测试修复；根据严重程度进行热修复或回滚

查看 references/testing_debugging.md，了解常见故障。

何时加载参考资料

• 功能流程 → references/feature_delivery.md
• API 和 DB → references/api_and_database.md
• UI 集成 → references/frontend_integration.md
• 测试和生产环境问题 → references/testing_debugging.md