create project with react and next.js
Atue como um Arquiteto Frontend Sênior especializado em React, Next.js, TypeScript, Clean Architecture, SOLID, Design System, Performance Web e aplicações escaláveis.
Crie um projeto completo utilizando Next.js seguindo todos os requisitos abaixo.
# Objetivo do Projeto
[DESCREVA O PROJETO]
Exemplo:
Sistema web para gerenciamento financeiro com autenticação, dashboard, relatórios, gráficos e controle de usuários.
# Stack Tecnológica
- Next.js (App Router)
- React
- TypeScript
- Tailwind CSS
- Shadcn/UI
- React Hook Form
- Zod
- TanStack Query (React Query)
- Axios
- Zustand
- Jest
- React Testing Library
- Playwright
- ESLint
- Prettier
- Husky
- Docker
# Requisitos Funcionais
[LISTAR FUNCIONALIDADES]
Exemplo:
- Login
- Cadastro
- Recuperação de senha
- Dashboard
- CRUD de usuários
- CRUD de produtos
- Paginação
- Filtros
- Busca
- Relatórios
- Exportação de dados
# Requisitos Não Funcionais
- Alta performance
- SEO otimizado
- Responsividade
- Acessibilidade (WCAG)
- Escalabilidade
- Componentização
- Código desacoplado
- Testabilidade
- Internacionalização preparada
- Dark Mode
# Arquitetura
Utilize:
- Clean Architecture
- Feature-Based Structure
- SOLID
- Separation of Concerns
- Dependency Injection quando necessário
- Service Layer
- Custom Hooks
- Context API apenas quando apropriado
- Zustand para estado global
Estrutura esperada:
src/
├── app/
├── features/
│ ├── auth/
│ ├── dashboard/
│ └── users/
├── components/
│ ├── ui/
│ ├── layout/
│ └── shared/
├── hooks/
├── services/
├── lib/
├── providers/
├── stores/
├── types/
├── schemas/
├── constants/
├── utils/
├── config/
├── assets/
└── tests/
# Next.js
Utilizar:
- App Router
- Server Components
- Client Components apenas quando necessário
- Server Actions quando apropriado
- Middleware
- Route Handlers
- Dynamic Routes
- Loading UI
- Error Boundaries
- Suspense
# Design System
Implementar:
- Design Tokens
- Tipografia
- Espaçamentos
- Cores
- Breakpoints
- Componentes reutilizáveis
Criar:
- Button
- Input
- Select
- Modal
- Drawer
- Card
- Table
- Badge
- Tooltip
- Alert
- Skeleton
- Pagination
Todos documentados.
# Formulários
Utilizar:
- React Hook Form
- Zod
Implementar:
- Validações
- Máscaras
- Tratamento de erros
- Feedback visual
# Comunicação com API
Criar:
- Axios Instance
- Interceptors
- Tratamento global de erros
- Refresh Token automático
- Retry Strategy
Estrutura:
services/
├── api.ts
├── auth.service.ts
├── user.service.ts
# Gerenciamento de Estado
Utilizar Zustand para:
- Usuário autenticado
- Preferências
- Dados globais
Evitar estado global desnecessário.
# Autenticação
Implementar:
- JWT
- Refresh Token
- Controle de sessão
- Middleware de proteção de rotas
- Controle de permissões
- Controle de papéis (RBAC)
Exemplo:
- Admin
- Manager
- User
# Performance
Implementar:
- Lazy Loading
- Dynamic Imports
- Image Optimization
- Memoização quando necessário
- Cache Strategy
- React Query Cache
Otimizar:
- Core Web Vitals
- Lighthouse
- SEO
# SEO
Implementar:
- Metadata API
- Open Graph
- Twitter Cards
- Sitemap
- Robots.txt
- Structured Data
# Testes
Criar:
## Unitários
- Componentes
- Hooks
- Utils
Utilizar:
- Jest
- React Testing Library
## E2E
Utilizar:
- Playwright
Cobrir:
- Login
- Logout
- Fluxos principais
- CRUD completo
# Qualidade de Código
Configurar:
- ESLint
- Prettier
- Husky
- lint-staged
- Commitlint
# Docker
Gerar:
- Dockerfile
- docker-compose.yml
- .dockerignore
# CI/CD
Criar GitHub Actions para:
- Instalar dependências
- Executar lint
- Executar testes unitários
- Executar testes E2E
- Gerar build
- Publicar artefatos
# Variáveis de Ambiente
Gerar:
.env.example
Exemplo:
NEXT_PUBLIC_API_URL=
NEXT_PUBLIC_APP_NAME=
# Observabilidade
Preparar estrutura para:
- Logs
- Monitoramento
- Analytics
- Error Tracking
# Segurança
Implementar:
- CSP Headers
- XSS Protection
- CSRF Strategy
- Secure Cookies
- Sanitização de Inputs
# Documentação
Gerar:
- README.md completo
- Guia de instalação
- Guia de desenvolvimento
- Guia de deploy
- Padrões arquiteturais
- Convenções do projeto
# Entrega
Forneça:
1. Estrutura completa de pastas.
2. Explicação da arquitetura.
3. Fluxo de dados da aplicação.
4. Fluxo de autenticação.
5. Fluxo de permissões.
6. Todos os arquivos necessários.
7. Código completo de cada arquivo.
8. Configurações do projeto.
9. Configurações de testes.
10. Configurações de CI/CD.
11. Comandos de execução local.
12. Comandos para Docker.
13. Boas práticas adotadas.
14. Justificativas técnicas das decisões arquiteturais.
Utilize TypeScript com strict mode habilitado.
Priorize:
- Escalabilidade
- Manutenibilidade
- Performance
- Segurança
- Testabilidade
Siga padrões utilizados por equipes de engenharia de software em ambientes enterprise.