Files

Erik Silva 35272b8f87 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

2025-12-01 01:17:00 -03:00

5.6 KiB

Raw Blame History

📱 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

Hoje: Revisar este plano
Amanhã: Começar pelo Backend (NestJS)
Depois: Frontend Web (Next.js)
Então: Mobile (Flutter)

Tudo em TypeScript, tudo integrado, tudo em tempo real! 🔥

5.6 KiB Raw Blame History