Visão geral
O TermoPortal (Portal B2B da Termotubos) é o canal de autoatendimento dos clientes empresariais. Ele existe para tirar do WhatsApp o que o cliente consegue resolver sozinho, como consultar produtos, montar uma cotação, ver o status de um pedido ou achar uma fatura, e para deixar o time comercial livre para a venda consultiva.
O portal não tem checkout nem pagamento. O cliente monta uma cotação com os itens, o endereço, o frete e o cupom, e envia. A partir daí o time comercial assume: aprova ou não a cotação e conduz a venda fora do portal.
Quem usa
| Público | Quem é | O que faz no portal |
|---|---|---|
| Cliente B2B | Pessoa (tipo = cliente) vinculada a uma ou mais empresas clientes, identificadas por CNPJ ou CPF | Navega no catálogo, monta cotações, acompanha pedidos e faturas da empresa ativa, abre sugestões e fala com um atendente |
| Colaborador Termotubos | Pessoa (tipo = termotubos), em geral importada do RH | Atua por qualquer empresa, pode abrir a visão consolidada de todas as empresas e, conforme o perfil, administra o backoffice |
O que cada pessoa vê é decidido pelo perfil dela: um conjunto de permissões de ver, criar, editar e excluir por módulo (Dashboard, Pedidos, Financeiro, Catálogo, Cotações, Demandas, Assistente, Ajuda e Configurações). Os perfis master e administrador são perfis elevados, com acesso total. Detalhes em Entrada e acesso .
O que o portal faz
- Entrada e acesso — Login pelo TermoAuth, primeiro acesso por convite, empresa ativa, visão consolidada e perfis de permissão.
- Catálogo — Produtos, grupos de atacado, kits, boletins técnicos, avaliações, favoritos e compre junto.
- Cotação — Carrinho em cinco etapas, frete, cupom, recálculo no servidor, status e recompra.
- Pedidos e financeiro — Rastreio de pedidos por número ou nota fiscal e consulta de faturas da empresa.
- Atendimento — Central de Dúvida com atendente humano pelo Chatwoot, sugestões e demandas.
- Backoffice — Configurações: cadastros, catálogo, importação da API Termotubos, regras de venda e integrações.
O caminho de uma cotação
1. A pessoa entra
Sem sessão, o portal manda a pessoa para o TermoAuth, o login central da Termotubos. Na volta, o portal valida o token, encontra a pessoa cadastrada e abre uma sessão própria. Quem não tem cadastro no portal não entra.
2. Escolhe a empresa
Tudo o que o cliente vê e cria pertence à empresa ativa. Quem tem uma só empresa já entra nela; quem tem várias escolhe no seletor. O colaborador Termotubos pode escolher qualquer empresa ativa ou, com permissão, a visão consolidada.
3. Monta o carrinho pelo catálogo
O cliente navega pelos produtos, grupos de atacado e kits e adiciona itens ao carrinho. O carrinho fica no navegador, separado por empresa.
4. Envia a cotação
No carrinho, o cliente passa pelas etapas de itens, endereço, entrega, condições comerciais e revisão. Ao enviar, o backend recalcula preço, estoque, frete, cupom e total a partir do banco e grava a cotação como esperando_aprovacao.
5. O comercial assume
A equipe interna conduz a venda e muda o status da cotação para concluido, nao_aprovado ou em_transporte; hoje essa mudança é feita pela API, sem tela no portal. Os pedidos e as faturas da empresa ficam disponíveis para consulta em Rastrear Pedidos e Financeiro.
Princípios que valem para todo o portal
- O backend é a barreira real. A tela esconde o que a pessoa não pode ver, mas quem decide é a API em Rust: toda rota tem um requisito explícito, e rota sem requisito é negada.
- O cliente só enxerga as próprias empresas. Toda leitura e escrita de cotação, pedido, fatura, demanda, endereço e contato passa pelo escopo da empresa. Registro de outra empresa responde
404, para não revelar que existe. - O preço que vale é o do banco. O navegador informa o que viu, mas a cotação é recalculada no servidor; se o preço ou o total divergirem, ela é recusada em vez de gravada com outro valor.
- O catálogo vem da API Termotubos. O portal importa e enriquece os produtos; divergência de preço ou estoque em produto já importado vira conflito para alguém conciliar, nunca sobrescrita silenciosa.
- Nada é apagado. Toda exclusão é lógica: o registro fica marcado como deletado e sai das consultas, mas continua no banco.
O que já existe e o que ainda é protótipo
O backend em Rust e o frontend em SvelteKit substituíram o antigo app em Next.js, removido do repositório em 2026-09-25. A maior parte das telas já lê e grava pela API; algumas ainda são protótipos de interface, sem dados reais.
| Parte | Situação |
|---|---|
| Login pelo TermoAuth, sessão, convite, perfis e escopo por empresa | Implementado |
| Catálogo: produtos, grupos de atacado, kits, boletins, avaliações, favoritos, compre junto | Implementado |
| Importação de produtos da API Termotubos e conciliação de conflitos | Implementado |
| Carrinho e cotação com frete, cupom e recálculo no servidor | Implementado |
| Consulta de pedidos e faturas | Implementado, com os dados gravados no próprio portal; não há integração que os preencha a partir do ERP |
| Central de Dúvida com atendente humano pelo Chatwoot | Implementado |
| Demandas e sugestões | Implementado |
| Cadastros de empresas (com verificação no Tiny), pessoas, colaboradores do RH, perfis e grupos de cliente | Implementado |
| Dashboard | Protótipo com dados de exemplo |
| Assistente IA e Pedido por texto | Protótipo de interface, com respostas prontas e sem backend |
| Programa de tiers | Protótipo: a configuração fica só no navegador |