35272b8f87
- 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
238 lines
5.6 KiB
Markdown
238 lines
5.6 KiB
Markdown
# 📱 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! 🔥 |