fullstack-workflow

fullstack-workflow 技能为 Next.js 环境中的功能开发提供了一套严谨且模块化的模式。专为开发复杂 Web 应用程序的工程师所设计，它强化了数据提取、服务器端变更操作与客户端 UI 状态管理之间的明确职责分离。通过使用可预测的架构，此流程能降低开发过程中的认知负荷，并确保大型代码库的一致性。此模式特别适合需要高可靠性的应用程序，例如管理电子邮件数据、身份验证与后台处理的 SaaS 产品。

• 实现以 withAuth 或 withEmailAccount 等身份验证中间件封装的 GET API 路由，以确保数据暴露的安全性。

• 利用 Prisma 进行类型安全的数据库存取，确保与 PostgreSQL 和 Redis 数据存储的可靠互动。

• 使用 next-safe-action 定义基于 Zod 输入验证的服务器操作，确保强大的服务器端安全性和错误处理。

• 整合 SWR 以进行高效的客户端数据获取、自动重新验证与缓存策略优化。

• 结合 React Hook Form 与 zodResolver，精简表单状态管理、验证与提交逻辑。

• 通过操作客户端元数据将 Sentry 仪表板标准化，以改进可观察性与错误追踪。

• 在数据完整性与类型安全性至关重要的 CRUD 作业中使用此工作流程。

• 务必以适当的中间件封装 API 路由，以强制执行身份与账户上下文。

• 将输入验证架构定义在特定的验证文件中，以保持服务器操作的专注与易于维护。

• 根据特定的权限需求使用 actionClient、actionClientUser 或 adminActionClient 上下文。

• 预期的输入包括经过验证的 Zod 对象；预期的输出为符合 TypeScript 接口要求的类型推论 JSON 响应。

• 限制条件包括严格遵守既定架构，以确保与现有中间件与记录基础设施的完全兼容。