๐ป Introducao: Construcao do SaaS
Visao geral da construcao. Panorama dos 6 temas que serao aprofundados nos modulos seguintes.
Sistema completo de autenticacao: login, registro, JWT, protecao de rotas e fluxo de onboarding para novos usuarios.
Auth e a porta de entrada do seu SaaS. Sem auth seguro, nada mais importa.
Supabase Auth, JWT, OAuth, protecao de rotas, onboarding flow, social login.
Design e implementacao do dashboard principal: layout, componentes essenciais, navegacao e responsividade.
O dashboard e onde o usuario passa 90% do tempo. UX ruim = churn alto.
Layout design, conversation-centered UI, information architecture, mobile-first.
Configuracao de system prompts de producao, pipeline de processamento e validacao de output.
O system prompt define a personalidade e qualidade do seu produto IA. E o diferencial competitivo.
System prompts de producao, pipeline I/O, temperature, contexto dinamico, guardrails.
Sistema de upload e processamento de multiplos tipos de arquivo: PDF, imagens, video e audio.
SaaS com IA que aceita apenas texto e limitado. Multimodal e o padrao em 2026.
Upload patterns, processamento de PDF/imagem, chunking, indexacao RAG.
Gerenciamento dos 4 estados do sistema (idle, loading, success, error) e persistencia de historico.
Apps IA tem latencia alta. Estados bem gerenciados transformam espera em experiencia.
4 estados, loading states para IA, error recovery, historico de conversas, persistencia.
Exercicio integrador: conectar auth + dashboard + AI + upload em um SaaS funcional end-to-end.
Teoria sem pratica nao constroi nada. Este exercicio cria o MVP funcional do seu SaaS.
Integracao de modulos, fluxo completo, polishing, testes de integracao, demo day.
๐ Autenticacao e Onboarding
Supabase Auth, JWT, protecao de rotas, onboarding flow e social login.
Configuracao completa do Supabase Auth: projeto, providers, email templates, redirect URLs.
Supabase Auth elimina semanas de trabalho. Setup correto evita dores de cabeca futuras.
Supabase project setup, auth providers, email confirmation, redirect config.
Como JWT funciona: access token, refresh token, expiracao, renovacao automatica.
Entender JWT previne bugs de sessao expirada e vulnerabilidades de seguranca.
JWT structure, access vs refresh tokens, token storage, session management.
Middleware de autenticacao, rotas publicas vs privadas, redirect para login, role-based access.
Rotas desprotegidas sao a vulnerabilidade #1 em SaaS. Uma rota aberta e um vazamento de dados.
Auth middleware, route guards, public vs private, RBAC, Next.js middleware.
Fluxo pos-registro: coleta de dados, personalizacao, primeiro uso guiado, time to value.
40-60% dos usuarios abandonam apps sem onboarding. Primeiros 5 minutos definem retencao.
Onboarding steps, progressive disclosure, first-run experience, personalizacao.
Login com Google, GitHub, etc. OAuth 2.0 flow, configuracao de providers, account linking.
Social login aumenta conversao em 20-50%. Menos friccao = mais signups.
OAuth 2.0, Google/GitHub providers, consent screen, account linking, PKCE flow.
Implementar auth completo: registro, login, social auth, protecao de rotas e onboarding flow.
Auth e a fundacao. Sem ele funcionando, nada mais pode ser construido.
Implementacao end-to-end, teste de fluxos, edge cases, checklist de seguranca.
๐ Dashboard e Interface Principal
Layout design, conversation-centered UI, componentes essenciais, navegacao e responsividade.
Padroes de layout especificos para apps com IA: sidebar + main area, chat-centric, split view.
Layout de app IA e diferente de SaaS tradicional. O output da IA precisa de espaco e contexto.
Layout patterns IA, sidebar navigation, main content area, streaming output area.
Dois paradigmas de UI para IA: chat/conversa (ChatGPT-style) vs transacao/formulario (SaaS tradicional).
Escolher o paradigma errado cria fricao. Nem todo app IA precisa ser um chatbot.
Chat UI, form UI, hybrid approach, quando usar cada um, exemplos reais.
Os componentes que todo dashboard IA precisa: input area, output display, history sidebar, settings panel.
Componentes reutilizaveis aceleram o desenvolvimento e garantem consistencia visual.
Component library, input/output areas, history, settings, status indicators.
Estrutura de navegacao: hierarquia de paginas, breadcrumbs, tabs, sidebar vs top nav.
Usuarios se perdem em apps sem navegacao clara. IA architecture e nao-linear por natureza.
IA (information architecture), navigation patterns, page hierarchy, user mental models.
Adaptacao do dashboard para mobile: breakpoints, sidebar collapsible, touch targets, bottom nav.
60%+ do trafego e mobile. Dashboard que nao funciona em mobile perde metade dos usuarios.
Mobile-first, Tailwind breakpoints, touch UX, responsive patterns para apps IA.
Construir o dashboard completo: layout, componentes, navegacao, responsividade e integracao com auth.
Dashboard funcional e o coracao do SaaS. Depois deste exercicio, o app tem cara de produto real.
Implementacao completa, Tailwind components, integracao auth, teste mobile.
โ๏ธ System Prompts e Fluxo da Aplicacao
Anatomia de system prompts, pipeline de processamento, temperature, contexto dinamico e guardrails.
Estrutura de system prompts profissionais: role, constraints, output format, examples, fallbacks.
System prompt amador = output inconsistente. System prompt profissional = produto confiavel.
Role definition, constraints, output schema, few-shot examples, edge case handling.
O pipeline completo: sanitizacao de input, montagem do prompt, chamada API, parsing de output.
Cada etapa do pipeline pode falhar. Entender o fluxo completo previne bugs silenciosos.
Input validation, prompt assembly, API call, response parsing, error handling.
Temperature, top_p, max_tokens, frequency_penalty e como cada um afeta o output.
Parametros errados geram output imprevisivel. Temperature 0 para dados, 0.7+ para criatividade.
Temperature scale, top_p sampling, token limits, penalty params, presets por use case.
Adicionar dados do usuario, historico e contexto externo no prompt em runtime.
IA sem contexto da respostas genericas. Contexto dinamico personaliza e melhora qualidade 3-5x.
Template variables, user context injection, RAG context, conversation history window.
Validacao de output: schema check, content filtering, fallback responses, retry logic.
LLMs podem gerar output inesperado. Guardrails protegem o usuario e a reputacao do produto.
Output schema validation, content filters, retry with fallback, structured output (JSON mode).
Implementar pipeline completo: system prompt, input processing, API call, output validation, error handling.
Pipeline integrado e o motor do SaaS. Cada peca isolada nao tem valor sem integracao.
End-to-end pipeline, system prompt tuning, guardrails config, teste de edge cases.
๐ Upload Multimodal
Upload de PDF, imagem, video e audio. Processamento, chunking e indexacao para RAG.
Panorama dos 4 tipos de upload multimodal: cada um com pipeline de processamento diferente.
Usuarios querem interagir com IA usando seus proprios documentos e midias, nao so texto.
File types, MIME types, size limits, processing pipelines por tipo, storage strategy.
Extracao de texto de PDF: OCR, parsing estruturado, tabelas, metadados.
PDF e o formato mais comum em contexto profissional. 80% dos uploads em SaaS B2B sao PDFs.
PDF parsing libraries, OCR, text extraction, table extraction, metadata handling.
Vision API: enviar imagens para LLMs multimodais, compressao, formatos, limites de tamanho.
GPT-4V, Claude Vision e Gemini transformam imagens em dados estruturados. Poder enorme.
Vision APIs, image encoding (base64), compression, multi-image prompts, cost per image.
Drag and drop, progress indicators, file preview, error messages, batch upload.
Upload ruim frustra usuarios. Boa UX de upload transmite confianca e profissionalismo.
Drag-drop zone, progress bar, file preview, error states, chunked upload.
Dividir documentos em chunks, gerar embeddings, indexar para busca semantica (RAG).
RAG transforma documentos estaticos em conhecimento consultavel pela IA. E o padrao em 2026.
Chunking strategies, embeddings, vector store, semantic search, retrieval pipeline.
Implementar upload completo: drag-drop UI, processamento server-side, chunking e integracao RAG.
Upload funcional conecta o mundo real ao seu SaaS. Sem ele, a IA so trabalha com texto digitado.
Full upload pipeline, storage config, processing queue, RAG integration, teste end-to-end.
๐ Estados do Sistema e Historico
Os 4 estados (idle, loading, success, error), loading states para IA, historico e persistencia.
Todo componente interativo tem 4 estados. Mapear cada um evita telas em branco e UX quebrada.
Apps sem tratamento de estados parecem quebrados. Usuarios nao sabem se esta carregando ou travou.
State machine, 4 estados universais, transicoes, UI para cada estado.
Loading especifico para IA: streaming tokens, skeleton screens, progress estimation, cancelamento.
IA demora 2-30 segundos. Sem feedback visual, usuario acha que travou e fecha o app.
Token streaming, typing indicators, skeleton UI, cancel button, time estimation.
Tratamento de erros: rate limits, timeout, API down, output invalido, retry automatico.
APIs de IA falham. Rate limits, timeouts e erros 500 sao comuns. Resiliencia e obrigatoria.
Error types, user-friendly messages, retry logic, exponential backoff, fallback responses.
Armazenar e exibir historico: conversation threads, busca, exportacao, limites de contexto.
Historico transforma interacoes isoladas em experiencia continua. Usuarios esperam poder voltar.
Conversation storage, thread management, search, context window management, export.
Salvar estado da sessao: draft messages, scroll position, configuracoes, preferencias do usuario.
Perder trabalho em progresso e frustrante. Persistencia de sessao e diferencial de qualidade.
LocalStorage, session recovery, auto-save, user preferences, state hydration.
Implementar todos os 4 estados, streaming, error handling, historico e persistencia de sessao.
Sistema de estados completo transforma prototipo em produto. E o polish que diferencia amador de pro.
State management completo, streaming integration, error recovery, history persistence.
๐ SaaS Funcional (Exercicio Integrador)
Integracao completa: Auth + Dashboard + AI. Fluxo do usuario, polishing, testes e demo day.
Conectar os 3 pilares: usuario autenticado acessa dashboard que interage com IA personalizada.
Pecas isoladas nao fazem produto. A integracao e onde a maioria dos projetos trava.
Auth context propagation, user-scoped AI, data flow architecture, session management.
Jornada end-to-end: landing > signup > onboarding > dashboard > core feature > resultado > retorno.
Testar o fluxo completo revela gaps invisiveis. Cada transicao e um ponto potencial de abandono.
User journey mapping, transition points, friction analysis, time-to-value optimization.
Micro-interacoes, animacoes, tipografia, espacamento, cores consistentes, empty states.
Polish transforma "funciona" em "impressiona". 10% de esforco que gera 50% da percepcao de qualidade.
Micro-interactions, transitions, typography scale, consistent spacing, attention to detail.
Testes pragmaticos: happy path, edge cases criticos, fluxo de auth, erro de API, mobile.
Nao precisa de 100% coverage. 5 testes bem escolhidos cobrem 80% dos bugs criticos.
Happy path testing, critical edge cases, manual test checklist, smoke tests.
Otimizacoes essenciais: bundle size, lazy loading, image optimization, API response caching.
App lento = usuario frustrado. 3 segundos de load time perde 53% dos usuarios mobile.
Core Web Vitals, lazy loading, code splitting, caching strategy, Lighthouse audit.
Preparar e apresentar o SaaS funcional: demo script, screen recording, feature walkthrough.
Saber apresentar seu produto e tao importante quanto construi-lo. Demo day treina essa skill.
Demo script, screen recording, feature highlights, storytelling, feedback collection.