🎨 Design Brief
Paleta de cores, tipografia, componentes, wireframes e specs visuais
Ver Design Brief →
1. Resumo Executivo
Plataforma web B2B que permite a empresas brasileiras navegar por um catálogo de máquinas, equipamentos, ferramentas, insumos e matéria-prima disponíveis para importação da China, visualizar fichas técnicas detalhadas e simular o custo total de importação.
A Importools atua como facilitadora — conectando fornecedores chineses a compradores brasileiros e cuidando de logística, consultoria e processo de importação legalizada.
2. Problema
Situação atual
- Empresas brasileiras que querem importar máquinas/equipamentos da China enfrentam falta de visibilidade sobre o que está disponível e quanto custaria a operação completa.
- Plataformas existentes (Alibaba, Made-in-China, Global Sources) são genéricas, em inglês, não calculam custos de importação para o Brasil e exigem que o comprador resolva logística e burocracia por conta própria.
- Consultorias brasileiras (China Link, Serpa China, Pindau, Método 12P) oferecem simulação de custos mas por orçamento manual — não têm catálogo navegável com autoatendimento.
🎯 Dor principal: O empresário brasileiro não consegue, em um único lugar, (1) encontrar o produto, (2) ver especificações técnicas e (3) saber quanto vai custar importar — tudo em português e com suporte completo.
3. Personas
👤 Carlos — Dono de indústria metalúrgica (PME)
Cargo: Sócio-diretor · Empresa: Metalúrgica com 30-80 funcionários
Objetivo: Importar máquina CNC da China pra reduzir custo vs. equipamento nacional
Frustração: Não sabe por onde começar; tem medo de ser enganado; não fala inglês
Comportamento: Pesquisa no Google, pede indicação, quer ver preço total antes de decidir
👤 Fernanda — Engenheira de compras
Cargo: Engenheira / Compradora técnica · Empresa: Indústria de médio porte
Objetivo: Encontrar equipamento com especificações técnicas exatas e comparar custo importado vs. nacional
Frustração: Catálogos genéricos sem dados técnicos; precisa justificar a compra com números pro diretor
Comportamento: Navega por specs técnicas, baixa fichas, precisa de dados concretos
👤 Roberto — Empresário do setor de alimentos
Cargo: Proprietário · Empresa: Fábrica de alimentos / frigorífico
Objetivo: Importar insumos e equipamentos de processamento com melhor custo-benefício
Frustração: Não entende a burocracia de importação; quer alguém que cuide de tudo
Comportamento: Quer ver preço final "na porta da fábrica"; valoriza atendimento consultivo
4. Necessidades do Usuário
| Tipo | Necessidade |
|---|
| Funcional | Encontrar produto específico disponível pra importação da China |
| Funcional | Ver especificações técnicas detalhadas (peso, cubagem, capacidade) |
| Funcional | Saber quanto custaria importar esse produto pro Brasil (simulação) |
| Funcional | Iniciar processo de importação com suporte completo |
| Emocional | Sentir segurança de que a importação é legalizada e confiável |
| Social | Poder apresentar dados concretos (simulação) pra diretoria/sócios |
5. Requisitos Funcionais
Epic 1 — Catálogo de Produtos ESSENCIAL
- RF-01: Navegação por categorias e subcategorias (multinível)
- RF-02: Página de listagem com cards de produto (imagem, nome, categoria)
- RF-03: Ficha técnica do produto (imagens, vídeos, peso, cubagem, dimensões, especificações)
- RF-04: Busca por texto livre com filtros (categoria, subcategoria)
- RF-05: Responsivo (mobile-first)
Epic 2 — Simulador de Importação ESSENCIAL
- RF-06: Botão "Simular Importação" na ficha do produto
- RF-07: Formulário de cadastro: CNPJ (auto-fill via API Receita Federal — inclui UF), e-mail, WhatsApp
- RF-08: Cálculo automático com dados pré-cadastrados pela Importools:
- Valor FOB do produto
- Frete internacional
- Custos logísticos: cubagem, peso, transporte porto, armazenagem, desembaraço
- Impostos por NCM + UF de destino (ICMS varia por estado)
- Logística por UF: porto marítimo ou seco. Se seco, soma frete marítimo → seco
- Câmbio em tempo real (API BCB)
- Quantidade mínima
- RF-09: Envio da simulação por e-mail com link de acesso
- RF-10: Página da simulação com breakdown completo de custos
⚠️ Importante: O cliente NÃO informa dados de frete/impostos — tudo é pré-carregado. O estado vem do CNPJ. Entrega: produto desembaraçado no porto (marítimo ou seco conforme UF).
Epic 3 — Gestão de Produtos e Tabelas ESSENCIAL
- RF-11: Painel administrativo para cadastrar/editar/remover produtos
- RF-12: Cadastro de categorias e subcategorias (multinível)
- RF-13: Upload de imagens e vídeos por produto
- RF-14: Cadastro de valor FOB por produto
- RF-15: Cadastro de dados de frete e logística por produto (frete internacional, cubagem, peso, transporte porto, armazenagem, desembaraço)
- RF-16: Cadastro de quantidade mínima por produto
- RF-17: Tabela de impostos por NCM e UF de destino
- RF-18: Configuração de margem/markup
- RF-19: Tabela de logística por UF (tipo de porto + frete entre portos)
Epic 4 — Gestão de Leads IMPORTANTE
- Dashboard com lista de leads (quem simulou, quando, qual produto)
- Exportação de leads (CSV/Excel)
- Notificação por e-mail/WhatsApp quando novo lead simula
- Status do lead (novo → em contato → negociando → convertido)
Epic 5 — SEO e Conteúdo IMPORTANTE
- URLs amigáveis por categoria e produto
- Meta tags dinâmicas (título, descrição, Open Graph)
- Sitemap XML automático
- Marcação estruturada (Product) para resultados ricos no Google
Epic 6 — Integrações DESEJÁVEL
- API de câmbio em tempo real (BCB)
- API de consulta CNPJ (BrasilAPI / ReceitaWS)
- Integração WhatsApp para notificação de leads
- Google Analytics / Tag Manager
Epic 7 — Reinaldo Virtual (Assistente IA) IMPORTANTE
- Chat flutuante em todas as páginas públicas
- Pré-cadastro obrigatório antes da primeira resposta: CNPJ, e-mail e WhatsApp
- Recomendação apenas de produtos do catálogo (fonte única da verdade: base interna)
- Dúvidas gerais de importação via FAQ oficial + RAG interno
- Sem cálculo no chat: simulação oficial exclusiva da Engine
- LLM padrão: GPT-4.1 mini
6. Requisitos Não-Funcionais
| Requisito | Especificação |
|---|
| Performance | LCP < 2.5s; INP < 200ms; CLS < 0.1; API chat P95 < 4s |
| Disponibilidade | 99.9% mensal para catálogo/simulação; 99.5% mensal para chat IA |
| Segurança | HTTPS obrigatório, criptografia em trânsito e em repouso, LGPD compliance |
| Escalabilidade | Suportar 5.000 produtos e pico de 100 usuários simultâneos sem degradação crítica |
| Acessibilidade | WCAG 2.1 nível A (mínimo) com foco visível e navegação por teclado |
| Idioma | Português BR (v1) |
| SEO | Core Web Vitals no verde e sitemap/robots/canonical ativos |
| Mobile | Mobile-first, funcional a partir de 320px |
| IA segura (Reinaldo) | Respostas ancoradas apenas em fontes internas autorizadas |
| Governança de IA | Log de grounding por resposta + bloqueio de cálculo de simulação no chat |
| SLO de incidentes | Erro > 5% por 5 min gera alerta; MTTA alvo < 15 min |
7. Escopo e Limitações
✅ Dentro do escopo (v1)
- Catálogo com 2-3 categorias iniciais e subcategorias
- Ficha técnica com imagens, vídeos, especificações
- Simulador de importação com cadastro por CNPJ
- Painel administrativo para gestão de produtos
- Captura de leads e dashboard básico
- SEO básico
- Reinaldo Virtual com pré-cadastro, recomendação de produtos e FAQ de importação (RAG interno)
❌ Fora do escopo (v1)
- Pagamento online / e-commerce
- Chat ao vivo
- Comparador de produtos lado a lado
- App mobile nativo
- Multi-idioma
- Marketplace com múltiplos fornecedores
- Rastreamento de pedidos / status de importação
- Cálculo fiscal/logístico dentro do chat IA (restrito à Engine oficial)
- Respostas do agente baseadas em fontes externas não homologadas
- Ambiente de preenchimento de carga (consolidação/packing operacional)
- Simulação gamificada com cálculo de +1 produto (multi-produto lúdico)
8. Análise Competitiva
Alibaba
- Tipo: Marketplace
- Catálogo: Imenso
- Simulador BR: Não
- Português: Parcial
- Suporte: Não
Made-in-China
- Tipo: Marketplace
- Catálogo: Grande
- Simulador BR: Não
- Português: Não
- Suporte: Não
China Link
- Tipo: Consultoria BR
- Catálogo: Sob demanda
- Simulador BR: Manual
- Português: Sim
- Suporte: Sim
Pindau
- Tipo: Trading BR
- Catálogo: Limitado
- Simulador BR: Sim
- Português: Sim
- Suporte: Sim
Método 12P
- Tipo: Consultoria
- Catálogo: Não
- Simulador BR: Manual
- Português: Sim
- Suporte: Sim
Importools
- Tipo: Plataforma B2B
- Catálogo: Curado
- Simulador BR: Automático
- Português: Sim
- Suporte: Sim
🏆 Diferencial Importools:
- Catálogo curado + simulador automático em português — ninguém oferece os dois juntos
- Foco em máquinas/equipamentos (nicho industrial)
- Dados técnicos detalhados (cubagem, peso, contêiner)
- Lead qualificado via CNPJ — empresa já chega validada
9. Métricas de Sucesso
| Indicador | Meta (6 meses) | Como medir |
|---|
| Produtos cadastrados | 100+ | Dashboard admin |
| Visitantes únicos/mês | 2.000+ | Google Analytics |
| Taxa de simulação | > 5% | Leads / Visitantes |
| Leads qualificados/mês | 100+ | Dashboard de leads |
| Conversão (lead → contato) | > 20% | Dashboard |
| Tempo na ficha do produto | > 2 min | Google Analytics |
| Core Web Vitals | Verde | PageSpeed Insights |
10. Dependências e Riscos
| Risco | Probabilidade | Impacto | Mitigação |
|---|
| Dados de frete/impostos incorretos | Alta | Alto | Validação com despachante; revisão periódica |
| Câmbio desatualizado | Média | Médio | API de câmbio em tempo real (BCB) |
| Poucas categorias no lançamento | Média | Médio | Iniciar com 2-3 categorias fortes; expandir |
| API Receita Federal fora | Baixa | Médio | Preenchimento manual como alternativa |
| LGPD — dados de CNPJ/lead | Baixa | Alto | Política de privacidade; consentimento; criptografia |
| SEO demora pra indexar | Alta | Médio | Conteúdo rico; sitemap; Google Search Console |
| Alucinação do agente IA (resposta fora da base) | Média | Alto | Guardrails de grounding + bloqueio semântica fora da base + resposta de limitação |
| Tentativa de prompt injection no chat | Média | Alto | Filtro de políticas, isolamento de instruções externas e whitelist de fontes internas |
11. Timeline / Roadmap
| Fase | Entregas | Estimativa |
|---|
| F1 — Fundação | Estrutura, stack, banco de dados, autenticação admin | 1 dia |
| F2 — Catálogo | Categorias, subcategorias, ficha de produto, busca, responsivo | 1-2 dias |
| F3 — Simulador | Cadastro CNPJ, cálculo de importação, envio por e-mail | 1-2 dias |
| F4 — Admin | Painel de gestão (produtos, categorias, frete, fiscal, UF) | 1-2 dias |
| F5 — Leads | Dashboard de leads, notificações, exportação | 1 dia |
| F6 — SEO | URLs amigáveis, meta tags, sitemap, performance | 1 dia |
| F7 — Lançamento | Deploy produção, testes iniciais, monitoramento | 1 dia |
| F8 — Testes/Ajustes/Entrega Final | Testes completos, correções, ajustes finais, entrega | 10 dias |
Total estimado atualizado: até 25 dias corridos (inclui buffer de risco)
12. Stack Confirmada (Arquitetura A)
| Camada | Tecnologia sugerida |
|---|
| Frontend | Next.js (SSR para SEO) |
| Backend | Next.js API routes + serviços internos |
| Banco de dados | Supabase (PostgreSQL) |
| Armazenamento | Supabase Storage (imagens/vídeos) |
| Autenticação | Supabase Auth (admin) |
| Deploy app | VPS do OpenClaw (mesma infraestrutura, com isolamento por serviço) |
| Reverse proxy | Nginx com HTTPS |
| Process manager | PM2 ou Docker Compose (definir na implementação) |
| E-mail | Resend (primário) + SendGrid (fallback) |
| Câmbio | BCB (primário) + fallback homologado |
| CNPJ | BrasilAPI/ReceitaWS (primário + fallback) |
| IA | GPT-4.1 mini |
13. Glossário
| Termo | Significado |
|---|
| FOB | Free on Board — preço do produto no porto de origem (China) |
| NCM | Nomenclatura Comum do Mercosul — código fiscal do produto |
| Cubagem | Volume ocupado pelo produto (m³) |
| CNPJ | Cadastro Nacional de Pessoa Jurídica |
| Lead | Empresa que simulou importação (potencial cliente) |
| CIF | Cost, Insurance and Freight — preço incluindo frete e seguro |
| Porto seco | Recinto alfandegário em cidade sem acesso marítimo |
| UF | Unidade Federativa — estado brasileiro |
| ICMS | Imposto sobre Circulação de Mercadorias e Serviços (estadual) |
| Desembaraço | Processo de liberação da mercadoria na alfândega |
14. RBAC (Acesso e Permissões)
- ADM: acesso total (configurações, usuários, produtos, tabelas, leads, logs, integrações).
- Operacional: incluir/alterar/excluir produtos e demais tabelas pelo ambiente visual (categorias, fiscal, logística, FAQ), sem gestão de usuários/permissões globais.
- Comercial: somente consulta de leads/simulações e atualização de status comercial; sem permissão de alteração estrutural.
15. Política LGPD Executável (retenção 6 meses)
15.1 Regras operacionais
- Leads e conversas do Reinaldo exigem consentimento explícito antes do envio.
- Dados pessoais de lead/chat sem conversão devem ser retidos por 6 meses e anonimizados automaticamente após o prazo.
- Simulações/snapshots técnicos podem ser mantidos para auditoria, com anonimização de dados pessoais após 6 meses quando não houver obrigação legal de retenção identificável.
- Pedido de exclusão do titular deve ser atendido em até 15 dias corridos, preservando somente dados exigidos por obrigação legal.
- Logs de segurança não devem armazenar conteúdo sensível em texto puro quando evitável.
15.2 Texto final de consentimento (UI)
“Ao continuar, você autoriza o uso de CNPJ, e-mail e WhatsApp para atendimento comercial, geração de simulação e contato da Importools, conforme a Política de Privacidade. Seus dados poderão ser armazenados por até 6 meses para fins de atendimento e auditoria, com possibilidade de solicitação de exclusão.”
15.3 Aviso jurídico obrigatório de simulação
“Os valores exibidos na simulação são estimativos e devem ser revisados pela equipe de especialistas da Importools antes de qualquer decisão final. A validação técnica/fiscal final é obrigatória para evitar divergências comerciais e disputas judiciais.”
16. Fontes Homologadas do Reinaldo (fonte da verdade)
- Catálogo de produtos publicados (nome, specs, mídia, NCM, quantidade mínima).
- Tabelas logísticas homologadas por UF.
- Tabelas fiscais homologadas por NCM + UF (versão ativa).
- FAQ oficial publicado no admin (status: publicado).
- Políticas internas oficiais (LGPD, escopo de simulação, disclaimers).
Proibido: usar web aberta, conteúdo não homologado, ou inferência sem evidência interna suficiente.
17. Pendências do Cliente (bloqueios controlados)
- Fornecer API keys de serviços externos (CNPJ, câmbio, e-mail e WhatsApp se aplicável).
- Validar formalmente com equipe fiscal/especialistas a fórmula v1 da engine antes de produção.
- Aprovar texto jurídico final da política de privacidade e do aviso de simulação.
18. Addendum de Execução (03/03/2026)
Este PRD foi atualizado para refletir os ajustes de execução validados por Arthur.
- Engine de Simulação v1: ordem oficial de cálculo, arredondamento, validade e auditoria.
- Fallback de integrações: contingência para CNPJ, câmbio e e-mail (primário/secundário/cache/retry).
- Backlog técnico: planejamento em Sprint 1 e Sprint 2 (MVP 1) + Sprint 3 (MVP 1.1).
- Regras de negócio críticas: snapshot imutável, versionamento fiscal/logístico e trilha de rastreabilidade.
- Padrão SEO v1: URL/canonical/indexação/schema/sitemap/robots/CWV.
- Design System Spec v1: tokens, estados de componentes, acessibilidade e checklist de implementação.
Documentos de apoio (workspace):
base-de-conhecimento/engine-simulacao-v1.md
base-de-conhecimento/fallback-integracoes-v1.md
base-de-conhecimento/backlog-tecnico-sprints-v1.md
base-de-conhecimento/regras-negocio-criticas-v1.md
base-de-conhecimento/seo-padrao-v1.md
base-de-conhecimento/design-system-spec-v1.md
19. Addendum — Reinaldo Virtual (03/03/2026)
- Chat flutuante em todas as páginas públicas do catálogo
- Pré-cadastro obrigatório antes da primeira resposta (CNPJ, e-mail, WhatsApp)
- Escopo: recomendação de produtos + dúvidas gerais de importação
- Fontes autorizadas: catálogo interno, FAQ oficial, tabelas e políticas internas homologadas
- Simulação de importação continua exclusiva da Engine oficial (chat não calcula)
- LLM de atendimento: GPT-4.1 mini
- Operação/monitoramento: mesma VPS do OpenClaw com logs e alertas
- Backlog técnico da feature definido em
reinaldo-user-stories-tecnicas.md
- Plano diário da Sprint 1 definido em
sprint-1-plano-diario.md
- Plano diário da Sprint 2 definido em
sprint-2-plano-diario.md
- Plano diário da Sprint 3 definido em
sprint-3-plano-diario.md
- Roadmap consolidado até 25 dias definido em
roadmap-master-25-dias.md
- Definition of Ready publicado em
definition-of-ready.html
- RBAC oficial definido (ADM/Operacional/Comercial)
- Política LGPD executável com retenção de 6 meses + texto final de consentimento
- Pendências do cliente registradas (API keys e validação fiscal por especialistas)
Guardrail principal: Se não houver base interna suficiente, Reinaldo deve declarar limitação e orientar próximo passo seguro (simulação oficial ou contato humano).
20. ⚠️ Alertas e Itens Faltantes para Início da Codificação
- PENDENTE DO CLIENTE: fornecimento das API keys (CNPJ, câmbio, e-mail e WhatsApp, se aplicável).
- PENDENTE DO CLIENTE: validação formal da fórmula fiscal da Engine v1 pela equipe de especialistas antes de produção.
- PENDENTE DO CLIENTE: aprovação jurídica final do texto de consentimento e política de privacidade.
- ALERTA DE ESCOPO: preenchimento de carga e simulação gamificada (+1 produto) permanecem fora do v1.
- ALERTA OPERACIONAL: sem fechamento dessas pendências, o início da codificação pode ocorrer em modo parcial (staging), sem go-live completo.