initial: Backend Auth Module + Design System + Complete Documentation
- Setup NestJS with TypeScript, ConfigModule, JWT authentication - Implemented Auth Module with signup, login, logout endpoints - Created DTOs with validation (SignupDto, LoginDto) - JWT Strategy with Passport integration for token validation - JwtAuthGuard for route protection with Bearer tokens - CurrentUser decorator for dependency injection - Supabase integration for user management and auth - Complete API documentation (API.md) with all endpoints - Design System for Web (Next.js + Tailwind) and Mobile (Flutter) - Comprehensive project documentation and roadmap - Environment configuration with Joi schema validation - Ready for Tasks Module and RLS implementation
This commit is contained in:
Erik Silva
238
docs/instrucoes-gerais.md
Normal file
238
docs/instrucoes-gerais.md
Normal file
@@ -0,0 +1,238 @@
|
||||
# 📱 TASK MANAGER - Plano de Desenvolvimento
|
||||
|
||||
## 🎯 Objetivo
|
||||
|
||||
Criar uma aplicação **multi-plataforma sincronizada em tempo real** de gerenciamento de tarefas para estudar desenvolvimento fullstack moderno com TypeScript.
|
||||
|
||||
---
|
||||
|
||||
## 🛠️ Stack Tecnológica
|
||||
|
||||
### Backend
|
||||
- **NestJS** - Framework Node.js com TypeScript
|
||||
- **Supabase** (`https://supabase.stackbackup.cloud`) - PostgreSQL + Auth + Realtime
|
||||
- **PostgreSQL** - Banco de dados relacional
|
||||
- **Docker** - Containerização
|
||||
|
||||
### Frontend Web
|
||||
- **Next.js 14** - Framework React com App Router
|
||||
- **TailwindCSS** - Framework CSS utility-first
|
||||
- **TypeScript** - Linguagem principal
|
||||
- **Supabase Client** - Cliente JavaScript
|
||||
|
||||
### Mobile
|
||||
- **Flutter** - Framework multi-plataforma (Android/iOS)
|
||||
- **Dart** - Linguagem do Flutter
|
||||
- **Provider** - State management
|
||||
- **Supabase Flutter** - Cliente Dart
|
||||
|
||||
### Ferramentas
|
||||
- **Git/GitHub** - Controle de versão
|
||||
- **VS Code** - IDE
|
||||
|
||||
---
|
||||
|
||||
## 📋 Funcionalidades (MVP)
|
||||
|
||||
### Autenticação
|
||||
- [ ] Cadastro de usuário (email + senha)
|
||||
- [ ] Login
|
||||
- [ ] Logout
|
||||
- [ ] Recuperação de senha
|
||||
- [ ] Sessão persistente
|
||||
|
||||
### Gerenciamento de Tarefas (CRUD)
|
||||
- [ ] Criar tarefa (título + descrição opcional)
|
||||
- [ ] Listar tarefas do usuário
|
||||
- [ ] Marcar como concluída/pendente
|
||||
- [ ] Editar tarefa
|
||||
- [ ] Deletar tarefa
|
||||
- [ ] Filtrar (Todas/Ativas/Concluídas)
|
||||
|
||||
### Sincronização em Tempo Real
|
||||
- [ ] Supabase Realtime (WebSockets)
|
||||
- [ ] Sincronização instantânea entre web e mobile
|
||||
- [ ] Atualização automática em múltiplos dispositivos
|
||||
|
||||
---
|
||||
|
||||
## 🗄️ Banco de Dados
|
||||
|
||||
### Tabela: `tasks`
|
||||
```
|
||||
id (UUID) - Chave primária
|
||||
user_id (UUID) - Referência ao usuário (RLS habilitado)
|
||||
title (TEXT) - Título da tarefa
|
||||
description (TEXT) - Descrição opcional
|
||||
completed (BOOLEAN) - Status da tarefa
|
||||
created_at (TIMESTAMP) - Data de criação
|
||||
updated_at (TIMESTAMP) - Data de atualização
|
||||
```
|
||||
|
||||
### Segurança
|
||||
- Row Level Security (RLS) habilitado
|
||||
- Usuário só acessa suas próprias tarefas
|
||||
|
||||
---
|
||||
|
||||
## 📦 Estrutura do Projeto
|
||||
|
||||
```
|
||||
task-manager/
|
||||
├── backend/
|
||||
│ ├── src/
|
||||
│ │ ├── auth/
|
||||
│ │ ├── tasks/
|
||||
│ │ ├── common/
|
||||
│ │ └── main.ts
|
||||
│ ├── .env
|
||||
│ ├── Dockerfile
|
||||
│ └── package.json
|
||||
├── frontend-web/
|
||||
│ ├── src/
|
||||
│ │ ├── app/
|
||||
│ │ ├── components/
|
||||
│ │ ├── lib/
|
||||
│ │ └── styles/
|
||||
│ ├── .env.local
|
||||
│ └── next.config.js
|
||||
├── mobile/
|
||||
│ ├── lib/
|
||||
│ │ ├── models/
|
||||
│ │ ├── services/
|
||||
│ │ ├── screens/
|
||||
│ │ ├── widgets/
|
||||
│ │ └── main.dart
|
||||
│ └── pubspec.yaml
|
||||
├── docker-compose.yml
|
||||
└── README.md
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Roadmap de Desenvolvimento
|
||||
|
||||
### Fase 1: Backend (NestJS + Supabase)
|
||||
- [ ] Configurar projeto NestJS com TypeScript
|
||||
- [ ] Integrar Supabase SDK
|
||||
- [ ] Criar módulo de Autenticação
|
||||
- [ ] Criar módulo de Tarefas
|
||||
- [ ] Implementar RLS no banco
|
||||
- [ ] Documentar API
|
||||
- [ ] Dockerfile para backend
|
||||
|
||||
### Fase 2: Frontend Web (Next.js)
|
||||
- [ ] Criar projeto Next.js 14
|
||||
- [ ] Configurar Supabase Client
|
||||
- [ ] Implementar layout e componentes
|
||||
- [ ] Integrar autenticação
|
||||
- [ ] Criar páginas de tarefas
|
||||
- [ ] Implementar Realtime
|
||||
- [ ] Responsividade com Tailwind
|
||||
- [ ] Dockerfile para frontend
|
||||
|
||||
### Fase 3: Mobile (Flutter)
|
||||
- [ ] Criar projeto Flutter
|
||||
- [ ] Integrar Supabase Flutter SDK
|
||||
- [ ] Implementar autenticação
|
||||
- [ ] Criar telas de tarefas
|
||||
- [ ] State management com Provider
|
||||
- [ ] Sincronização em tempo real
|
||||
- [ ] Build para Android e iOS
|
||||
|
||||
### Fase 4: DevOps e Deploy
|
||||
- [ ] Docker Compose para local
|
||||
- [ ] CI/CD pipeline
|
||||
- [ ] Deploy backend (Railway/Render)
|
||||
- [ ] Deploy frontend (Vercel)
|
||||
- [ ] Deploy mobile (App Store/Play Store)
|
||||
|
||||
---
|
||||
|
||||
## 📚 Conhecimentos a Adquirir
|
||||
|
||||
### TypeScript
|
||||
- [ ] Tipos básicos e avançados
|
||||
- [ ] Interfaces e tipos genéricos
|
||||
- [ ] Decoradores (usado no NestJS)
|
||||
|
||||
### NestJS
|
||||
- [ ] Módulos e Providers
|
||||
- [ ] Controllers e Services
|
||||
- [ ] Middleware e Guards
|
||||
- [ ] Integração com banco de dados
|
||||
|
||||
### Supabase
|
||||
- [ ] Row Level Security (RLS)
|
||||
- [ ] Autenticação com JWT
|
||||
- [ ] Realtime Subscriptions
|
||||
- [ ] Migrations SQL
|
||||
|
||||
### Next.js 14
|
||||
- [ ] App Router vs Pages Router
|
||||
- [ ] Server Components e Client Components
|
||||
- [ ] API Routes
|
||||
- [ ] Deployment na Vercel
|
||||
|
||||
### Flutter
|
||||
- [ ] Widgets e layouts
|
||||
- [ ] State management (Provider)
|
||||
- [ ] HTTP client
|
||||
- [ ] Navegação
|
||||
|
||||
---
|
||||
|
||||
## ⚙️ Variáveis de Ambiente
|
||||
|
||||
### Backend (.env)
|
||||
```
|
||||
SUPABASE_URL=https://supabase.stackbackup.cloud
|
||||
SUPABASE_KEY=[SUPABASE_ANON_KEY]
|
||||
JWT_SECRET=[SEU_JWT_SECRET]
|
||||
DATABASE_URL=[CONNECTION_STRING]
|
||||
```
|
||||
|
||||
### Frontend Web (.env.local)
|
||||
```
|
||||
NEXT_PUBLIC_SUPABASE_URL=https://supabase.stackbackup.cloud
|
||||
NEXT_PUBLIC_SUPABASE_ANON_KEY=[SUPABASE_ANON_KEY]
|
||||
```
|
||||
|
||||
### Mobile (flutter_dotenv)
|
||||
```
|
||||
SUPABASE_URL=https://supabase.stackbackup.cloud
|
||||
SUPABASE_ANON_KEY=[SUPABASE_ANON_KEY]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔗 Referências Úteis
|
||||
|
||||
- **Supabase**: https://supabase.stackbackup.cloud
|
||||
- **NestJS Docs**: https://docs.nestjs.com
|
||||
- **Next.js Docs**: https://nextjs.org/docs
|
||||
- **Flutter Docs**: https://flutter.dev/docs
|
||||
- **Supabase Flutter**: https://supabase.com/docs/reference/flutter/introduction
|
||||
|
||||
---
|
||||
|
||||
## ✅ Checklist de Início
|
||||
|
||||
- [ ] Criar repositório GitHub
|
||||
- [ ] Clonar e configurar localmente
|
||||
- [ ] Testar acesso ao Supabase
|
||||
- [ ] Instalar dependências
|
||||
- [ ] Executar docker-compose
|
||||
- [ ] Rodar servidor local
|
||||
- [ ] Validar fluxo de autenticação
|
||||
|
||||
---
|
||||
|
||||
## 📌 Próximos Passos
|
||||
|
||||
1. **Hoje**: Revisar este plano
|
||||
2. **Amanhã**: Começar pelo Backend (NestJS)
|
||||
3. **Depois**: Frontend Web (Next.js)
|
||||
4. **Então**: Mobile (Flutter)
|
||||
|
||||
Tudo em TypeScript, tudo integrado, tudo em tempo real! 🔥
|
||||
Reference in New Issue
Block a user