Senior Fullstack

Desenvolvedor Fullstack Sênior

Skill de desenvolvimento fullstack com scaffolding de projetos e ferramentas de análise de qualidade de código.

Sumário

• Frases de Ativação
• Ferramentas
• Workflows
• Guias de Referência

Frases de Ativação

Use esta skill quando ouvir:

• "criar scaffolding de um novo projeto"
• "criar um app Next.js"
• "configurar FastAPI com React"
• "analisar qualidade de código"
• "verificar problemas de segurança na base de código"
• "qual stack devo usar"
• "configurar um projeto fullstack"
• "gerar boilerplate de projeto"

Ferramentas

Project Scaffolder

Gera estruturas de projeto fullstack com código boilerplate.

Templates Suportados:

• nextjs - Next.js 14+ com App Router, TypeScript, Tailwind CSS
• fastapi-react - Backend FastAPI + Frontend React + PostgreSQL
• mern - MongoDB, Express, React, Node.js com TypeScript
• django-react - Django REST Framework + Frontend React

Uso:

# Listar templates disponíveis
python scripts/project_scaffolder.py --list-templates

# Criar projeto Next.js
python scripts/project_scaffolder.py nextjs my-app

# Criar projeto FastAPI + React
python scripts/project_scaffolder.py fastapi-react my-api

# Criar projeto MERN stack
python scripts/project_scaffolder.py mern my-project

# Criar projeto Django + React
python scripts/project_scaffolder.py django-react my-app

# Especificar diretório de saída
python scripts/project_scaffolder.py nextjs my-app --output ./projects

# Saída JSON
python scripts/project_scaffolder.py nextjs my-app --json

Parâmetros:

A saída inclui:

• Estrutura do projeto com todos os arquivos necessários
• Configurações de pacotes (package.json, requirements.txt)
• Configuração TypeScript
• Setup de Docker e docker-compose
• Templates de arquivo de ambiente
• Próximos passos para executar o projeto

Analisador de Qualidade de Código

Analisa bases de código fullstack em busca de problemas de qualidade.

Categorias de Análise:

• Vulnerabilidades de segurança (segredos hardcoded, riscos de injeção)
• Métricas de complexidade de código (complexidade ciclomática, profundidade de aninhamento)
• Saúde de dependências (pacotes desatualizados, CVEs conhecidos)
• Estimativa de cobertura de testes
• Qualidade de documentação

Uso:

# Analisar diretório atual
python scripts/code_quality_analyzer.py .

# Analisar projeto específico
python scripts/code_quality_analyzer.py /path/to/project

# Saída detalhada com achados completos
python scripts/code_quality_analyzer.py . --verbose

# Saída JSON
python scripts/code_quality_analyzer.py . --json

# Salvar relatório em arquivo
python scripts/code_quality_analyzer.py . --output report.json

Parâmetros:

A saída inclui:

• Score geral (0-100) com nota em letra
• Problemas de segurança por severidade (crítico, alto, médio, baixo)
• Arquivos de alta complexidade
• Dependências vulneráveis com referências CVE
• Estimativa de cobertura de testes
• Completude de documentação
• Recomendações priorizadas

Exemplo de Saída:

============================================================
RELATÓRIO DE ANÁLISE DE QUALIDADE DE CÓDIGO
============================================================

Score Geral: 75/100 (Nota: C)
Arquivos Analisados: 45
Total de Linhas: 12.500

--- SEGURANÇA ---
  Crítico: 1
  Alto: 2
  Médio: 5

--- COMPLEXIDADE ---
  Complexidade Média: 8.5
  Arquivos de Alta Complexidade: 3

--- RECOMENDAÇÕES ---
1. [P0] SEGURANÇA
   Problema: Possível segredo hardcoded detectado
   Ação: Remover ou proteger dados sensíveis na linha 42

Workflows

Workflow 1: Iniciar Novo Projeto

1. Escolha a stack adequada com base nos requisitos (consulte a Matriz de Decisão de Stack)
2. Crie o scaffolding da estrutura do projeto
3. Verifique o scaffold: confirme que package.json (ou requirements.txt) existe
4. Execute verificação de qualidade inicial — resolva quaisquer problemas P0 antes de prosseguir
5. Configure o ambiente de desenvolvimento

# 1. Criar scaffolding do projeto
python scripts/project_scaffolder.py nextjs my-saas-app

# 2. Verificar se o scaffold foi criado
ls my-saas-app/package.json

# 3. Navegar e instalar
cd my-saas-app
npm install

# 4. Configurar ambiente
cp .env.example .env.local

# 5. Executar verificação de qualidade
python ../scripts/code_quality_analyzer.py .

# 6. Iniciar desenvolvimento
npm run dev

Workflow 2: Auditar Base de Código Existente

1. Execute análise de qualidade de código
2. Revise achados de segurança — corrija todos os problemas P0 (críticos) imediatamente
3. Re-execute o analyzer para confirmar que os problemas P0 foram resolvidos
4. Crie tickets para problemas P1/P2

# 1. Análise completa
python scripts/code_quality_analyzer.py /path/to/project --verbose

# 2. Gerar relatório detalhado
python scripts/code_quality_analyzer.py /path/to/project --json --output audit.json

# 3. Após corrigir problemas P0, re-executar para verificar
python scripts/code_quality_analyzer.py /path/to/project --verbose

Workflow 3: Seleção de Stack

Use o guia de tech stack para avaliar opções:

1. SEO Obrigatório? → Next.js com SSR
2. Backend intenso em API? → FastAPI ou NestJS separado
3. Funcionalidades em tempo real? → Adicionar camada WebSocket
4. Expertise da equipe → Combine a stack com as habilidades da equipe

Veja references/tech_stack_guide.md para comparação detalhada.

Guias de Referência

Padrões de Arquitetura (references/architecture_patterns.md)

• Arquitetura de componentes frontend (Atomic Design, Container/Presentational)
• Padrões backend (Clean Architecture, Repository Pattern)
• Design de API (convenções REST, design de schema GraphQL)
• Padrões de banco de dados (connection pooling, transações, read replicas)
• Estratégias de cache (cache-aside, HTTP cache headers)
• Arquitetura de autenticação (JWT + refresh tokens, sessions)

Workflows de Desenvolvimento (references/development_workflows.md)

• Configuração de desenvolvimento local (Docker Compose, configuração de ambiente)
• Workflows Git (trunk-based, conventional commits)
• Pipelines CI/CD (exemplos GitHub Actions)
• Estratégias de testes (unit, integration, E2E)
• Processo de revisão de código (templates de PR, checklists)
• Estratégias de implantação (blue-green, canary, feature flags)
• Monitoramento e observabilidade (logging, métricas, health checks)

Guia de Tech Stack (references/tech_stack_guide.md)

• Comparação de frameworks frontend (Next.js, React+Vite, Vue)
• Frameworks backend (Express, Fastify, NestJS, FastAPI, Django)
• Seleção de banco de dados (PostgreSQL, MongoDB, Redis)
• ORMs (Prisma, Drizzle, SQLAlchemy)
• Soluções de autenticação (Auth.js, Clerk, JWT customizado)
• Plataformas de implantação (Vercel, Railway, AWS)
• Recomendações de stack por caso de uso (MVP, SaaS, Enterprise)

Referência Rápida

Matriz de Decisão de Stack

Problemas Comuns