SellSync - Requisitos Funcionais Detalhados¶
Versão: 2.0
Migrado de: _archive/legacy-2024/prd-01 a prd-08.md
Data: 2025-12-25
Visão Geral¶
Este documento consolida os 106 requisitos funcionais detalhados dos PRDs legacy com critérios de aceitação explícitos.
Módulo 1: Central do Analista¶
RF001: Login de Analista¶
Prioridade: P0 (bloqueante)
Como analista, quero fazer login com email e senha, para acessar a plataforma.
Critérios de Aceitação: - [ ] Formulário de login com email e senha - [ ] Validação de credenciais - [ ] Sessão persistente (JWT 15min + refresh token 7d) - [ ] Mensagem de erro clara se credenciais inválidas - [ ] Link "Esqueci minha senha"
RF002: Recuperação de Senha¶
Prioridade: P1
Como analista, quero recuperar minha senha via email, para acessar a plataforma caso esqueça.
Critérios de Aceitação: - [ ] Formulário com input de email - [ ] Email enviado com link de reset (expira em 1h) - [ ] Página de definir nova senha (min 8 chars, 1 maiúscula, 1 número) - [ ] Feedback visual de sucesso
RF003: Visão Consolidada de Sellers¶
Prioridade: P0
Como analista, quero ver métricas consolidadas de todos os meus sellers, para ter overview rápido de performance.
Critérios de Aceitação: - [ ] Dashboard exibe cards com métricas principais: - Vendas (R$) - ACOS (%) - TACOS (%) - Lucro Líquido (R$) - Pedidos (#) - Margem (%) - [ ] Dados atualizados a cada 6h (sync em background) - [ ] Comparação com período anterior (delta %) - [ ] Loading skeleton enquanto carrega
RF004: Filtros Avançados¶
Prioridade: P0
Como analista, quero filtrar dados por múltiplos critérios, para análise segmentada.
Critérios de Aceitação: - [ ] Filtro por seller (multi-select) - [ ] Filtro por marketplace (ML, Shopee, Amazon) - [ ] Filtro por país (BR, AR, MX, CL, CO) - [ ] Filtro por período (hoje, 7d, 30d, custom range) - [ ] Filtros persistem na URL (compartilhável) - [ ] Botão "Limpar filtros"
RF005: Tabela de Sellers¶
Prioridade: P0
Como analista, quero ver tabela com todos os sellers, para identificar rapidamente quem precisa de atenção.
Critérios de Aceitação: - [ ] Colunas: Nome, Marketplace, Vendas, ACOS, TACOS, Lucro, Status - [ ] Ordenação por qualquer coluna (asc/desc) - [ ] Busca por nome do seller - [ ] Paginação (20 por página) - [ ] Clique na linha leva para detalhes do seller - [ ] Indicador visual de status (verde/amarelo/vermelho)
RF006: Detalhes do Seller¶
Prioridade: P1
Como analista, quero ver detalhes de um seller específico, para análise profunda.
Critérios de Aceitação: - [ ] Métricas detalhadas do seller - [ ] Gráfico de evolução (últimos 30 dias) - [ ] Lista de campanhas ativas - [ ] Lista de produtos top/flop - [ ] Botão "Voltar para lista"
Módulo 2: Automação de Ads¶
RF007: Criar Regra de Automação¶
Prioridade: P0
Como analista, quero criar regras de automação baseadas em métricas, para otimizar performance automaticamente.
Critérios de Aceitação: - [ ] Formulário com: - Nome da regra - Tipo (ACOS, TACOS, Lucro) - Operador (>, <, =) - Valor threshold - Ação (aumentar bid, diminuir bid, pausar, ativar) - Percentual de ajuste (para bids) - Modo (híbrido/full-auto) - [ ] Validação de campos obrigatórios - [ ] Preview do que a regra fará - [ ] Confirmação antes de salvar
RF008: Modo Híbrido¶
Prioridade: P0
Como analista, quero aprovar automações de alto impacto, para manter controle.
Critérios de Aceitação: - [ ] Se impacto >= R$ 500: vai para fila de aprovação - [ ] Se impacto < R$ 500: executa automaticamente - [ ] Notificação in-app de ação pendente - [ ] Botões Aprovar/Rejeitar - [ ] Campo para justificativa (opcional) - [ ] Timeout: se não aprovado em 24h, expira
RF009: Lista de Regras¶
Prioridade: P1
Como analista, quero ver todas as regras criadas, para gerenciar automações.
Critérios de Aceitação: - [ ] Tabela: Nome, Tipo, Threshold, Ação, Status, Última execução - [ ] Toggle para ativar/desativar - [ ] Botão editar - [ ] Botão excluir (com confirmação) - [ ] Filtro por seller
RF010: Log de Automações¶
Prioridade: P1
Como analista, quero ver histórico de automações executadas, para auditoria.
Critérios de Aceitação: - [ ] Tabela: Data, Produto, Regra, Ação, Bid anterior, Bid novo, Status - [ ] Filtro por período - [ ] Filtro por status (executado, aprovado, rejeitado) - [ ] Exportar para Excel - [ ] Mostrar reasoning da ação
Módulo 3: Analytics Essencial¶
RF011: Dashboard de Métricas¶
Prioridade: P0
Como analista, quero ver gráficos de evolução, para identificar tendências.
Critérios de Aceitação: - [ ] Gráfico de linha: Vendas últimos 30 dias - [ ] Gráfico de linha: ACOS/TACOS últimos 30 dias - [ ] Comparação com período anterior (linha pontilhada) - [ ] Tooltip com valores ao passar o mouse - [ ] Responsivo (mobile-friendly)
RF012: Top/Flop Produtos¶
Prioridade: P1
Como analista, quero ver produtos que mais/menos performam, para priorizar ações.
Critérios de Aceitação: - [ ] Tabela Top 10 por lucro - [ ] Tabela Flop 10 por ACOS - [ ] Métricas: Vendas, ACOS, Lucro, Margem - [ ] Link para detalhes do produto
RF013: Comparação de Períodos¶
Prioridade: P1
Como analista, quero comparar métricas entre períodos, para medir evolução.
Critérios de Aceitação: - [ ] Seletor de período 1 e período 2 - [ ] Tabela comparativa com delta (%) - [ ] Highlight verde (melhora) ou vermelho (piora) - [ ] Exportar comparação
Módulo 4: Sistema de Alertas¶
RF014: Configurar Alertas¶
Prioridade: P1
Como analista, quero configurar alertas personalizados, para ser notificado de problemas.
Critérios de Aceitação: - [ ] Tipos de alerta: - Variação de métrica > X% - ACOS acima do limite - Produto sem estoque com ads ativo - Automação executada - [ ] Canais: Email, In-app, WhatsApp (futuro) - [ ] Frequência: Imediato, Diário, Semanal - [ ] Toggle ativar/desativar por tipo
RF015: Visualizar Alertas¶
Prioridade: P1
Como analista, quero ver alertas recentes, para tomar ação.
Critérios de Aceitação: - [ ] Ícone de sino no header com badge (count) - [ ] Dropdown com últimos 10 alertas - [ ] Marcar como lido - [ ] Link "Ver todos" - [ ] Página de alertas com filtros
Módulo 5: Gestão de Custos¶
RF016: Upload de Planilha de Custos¶
Prioridade: P0 (bloqueante para lucro)
Como analista, quero fazer upload de planilha com custos, para calcular lucro líquido.
Critérios de Aceitação: - [ ] Aceita CSV e Excel - [ ] Colunas obrigatórias: SKU, Custo - [ ] Validação de formato - [ ] Preview antes de confirmar - [ ] Log de uploads anteriores - [ ] Mensagem de erro clara se formato inválido
RF017: Input Manual de Custos¶
Prioridade: P1
Como analista, quero editar custo de produto manualmente, para corrigir dados.
Critérios de Aceitação: - [ ] Busca por SKU ou nome - [ ] Campo de custo editável - [ ] Histórico de alterações - [ ] Confirmação antes de salvar
Módulo 6: Histórico de Mudanças¶
RF018: Log de Ações¶
Prioridade: P2
Como analista, quero ver histórico de todas as ações no sistema, para auditoria.
Critérios de Aceitação: - [ ] Tipos: Automação, Aprovação, Config, Upload, Login - [ ] Colunas: Data, Usuário, Ação, Detalhes - [ ] Filtro por tipo e período - [ ] Exportar para Excel
Módulo 7: Relatórios¶
RF019: Gerar Relatório¶
Prioridade: P1
Como analista, quero gerar relatório para enviar ao seller, para comunicar resultados.
Critérios de Aceitação: - [ ] Templates: Executivo, Detalhado, Automações - [ ] Seleção de período - [ ] Seleção de seller(s) - [ ] Formato: PDF ou Excel - [ ] White-label (logo/cores customizáveis) - [ ] Enviar por email (opcional)
RF020: Histórico de Relatórios¶
Prioridade: P2
Como analista, quero ver relatórios gerados anteriormente, para reenviar se necessário.
Critérios de Aceitação: - [ ] Lista: Data, Seller, Template, Formato - [ ] Download - [ ] Reenviar por email - [ ] Excluir (com confirmação)
Módulo 8: Onboarding de Sellers¶
RF021: Adicionar Novo Seller¶
Prioridade: P0
Como analista, quero adicionar novo seller ao sistema, para começar a gerenciar.
Critérios de Aceitação: - [ ] Botão "Adicionar Seller" - [ ] OAuth com Mercado Livre - [ ] Configuração inicial: - Limites de ACOS/TACOS - Modo de automação (híbrido/manual) - Regras padrão - [ ] Primeira sincronização automática - [ ] Feedback de sucesso
RF022: Tutorial de Primeira Utilização¶
Prioridade: P2
Como novo analista, quero um tour guiado, para aprender a usar a plataforma.
Critérios de Aceitação: - [ ] Tour guiado em 5 passos - [ ] Highlights nos elementos principais - [ ] Botão "Pular tour" - [ ] Opção de refazer tour em Configurações
Resumo por Módulo¶
| Módulo | RFs | Prioridade P0 | Status |
|---|---|---|---|
| 1. Central do Analista | 6 | 4 | Documentado |
| 2. Automação de Ads | 4 | 2 | Documentado |
| 3. Analytics | 3 | 1 | Documentado |
| 4. Alertas | 2 | 0 | Documentado |
| 5. Custos | 2 | 1 | Documentado |
| 6. Histórico | 1 | 0 | Documentado |
| 7. Relatórios | 2 | 0 | Documentado |
| 8. Onboarding | 2 | 1 | Documentado |
| TOTAL | 22 | 9 | - |
Nota: Este documento contém os RFs principais. Os PRDs completos em _archive/legacy-2024/ têm 106 RFs detalhados com mais critérios de aceitação.
Changelog¶
| Data | Mudança |
|---|---|
| 2025-12-14 | RFs originais em PRDs separados |
| 2025-12-25 | Consolidado para estrutura nova |