用途:本技能定位为全栈架构专家,用于指导可扩展、可维护的全栈系统设计与项目搭建。资料说明其在涉及项目架构决策、单仓库(Nx/Turborepo)搭建等任务时应始终触发。
主要能力:
- 标准全栈技术栈(2024):前端 Next.js 14 + TypeScript + Tailwind + shadcn/ui;后端 NestJS + Prisma + PostgreSQL + Redis;移动端 React Native + Expo Router;认证 NextAuth.js / Clerk / Supabase Auth;存储 AWS S3 + CloudFront(或 Cloudinary);邮件 Resend / SendGrid;支付 Stripe;搜索 Algolia(或简单场景用 pg_trgm);部署 Vercel(Web)+ Railway/Render(API)+ EAS(移动);监控 Sentry + PostHog + Uptime Robot。
- Turborepo 单仓库结构:apps 下含 web、api、mobile;packages 下含 ui、types、config、utils;并给出 turbo.json 的任务配置(build、dev、lint、test)。
- 数据库模式:多租户 SaaS 的 Organization、OrganizationMember、Project 等 Prisma 模型,含唯一索引与行级安全思路(为所有资源加 organizationId)。
- API 设计规范:RESTful 路由约定、分页响应结构与错误响应结构。
- 认证架构:三层认证策略(Web 用 NextAuth.js 会话 Cookie、API/移动端用 JWT Bearer、服务间用 API Key);刷新令牌轮换模式与 RefreshToken 数据模型。
- 文件上传架构:预签名 URL 流程(客户端直传 S3),NestJS 生成上传 URL 的代码,以及 CloudFront CDN URL 拼接方式。
- 实时能力:NestJS WebSocket 网关与 SSE 单向流式示例。
- Stripe 集成:Checkout Session 创建与 webhook 处理订阅创建/更新/取消的模式。
- 缓存策略:浏览器 → CDN → Redis → 数据库的分层;Cache-Control 头建议;Redis TTL 建议;写穿透、事件驱动、TTL 三种失效模式。
- 技术栈决策矩阵:Prisma+PG、MongoDB、Supabase 在 schema 严格性、实时、边缘部署、成本与适用场景上的对比。
- 性能预算:API 响应时间 p50/p95/p99、数据库查询耗时、前端 TTFB、LCP、初始 JS 包体积等指标。
使用方式:资料未提供具体的安装命令或调用步骤,暂未提供。可理解为在涉及架构决策与项目搭建的任务中引用该技能,按其给出的技术栈、目录结构与代码模式进行设计。
适用场景:全栈项目架构决策、单仓库搭建、多租户 SaaS 数据建模、API 规范制定、认证与文件上传方案设计、实时功能、订阅支付集成、缓存与性能目标设定等。
限制:资料仅提供架构模式与技术选型示例,未提供产品收费、价格、平台支持或具体效果数据,相关事实暂未提供;代码示例为资料原文,实际采用需自行验证。