plataformas
Atlas
Plataforma web interna de uma distribuidora em Manaus que automatiza processos e atividades e na qual Controladoria, Fiscal, Contabilidade, Logística e Compras fazem suas rotinas e reaproveitam o que outra área já registrou. Funciona ao lado do WinThor, o ERP da TOTVS, e conversa com serviços públicos como SEFAZ e SUFRAMA.
- Situação
- Em uso
- Autoria
- Projeto individual, da especificação à publicação, desenvolvido com apoio de agentes de IA.
01Cenário
Uma distribuidora na Zona Franca de Manaus depende de prazos fiscais e de informação que passa de uma área para outra. Cada equipe mantinha o próprio controle, e várias áreas acompanhavam a mesma informação em controles paralelos.
- Nota fiscal recebida e não registrada pode virar crédito de imposto perdido e prazo de contestação vencido.
- Um único item recusado no arquivo de cadastro fazia o ERP parar a importação ali, e nada do que vinha depois entrava.
- Pedidos entre áreas, como devoluções e remessas, circulavam por e-mail e de mão em mão, sem rastro.
- Compras montava à mão, a partir de seis bases diferentes, a previsão de quanto o estoque ainda dura.
Ecossistema do Atlas
O que entra e o que sai do Atlas
- entradaWinThor (TOTVS) para API de integração (própria)Consultas ao banco do ERP.
- entradaAPI de integração para AtlasNotas de entrada, títulos a pagar e estoque.
- entradaRepositório de notas para AtlasXML de NF-e e CT-e.
- entradaSEFAZ para AtlasDatas de desembaraço.
- entradaSUFRAMA para AtlasTaxa TCIF.
- entradaBI (arquivos exportados) para AtlasBase do estoque crítico.
- entradaPortal externo para AtlasPedidos de agendamento de transportadores e indústrias.
- ida e voltaAtlas e de volta para Banco de dados (PostgreSQL)Registros e histórico.
- saídaAtlas para NotificaçõesAvisos das rotinas.
- saídaAtlas para ÁreasFilas por área: Controladoria, Fiscal, Logística e Compras.
- fonte externa
- serviço próprio
- plataforma
- banco de dados
- etapa
- pessoa ou área
02Abordagem
levantamento e modelagem
Módulos a partir da rotina real
Planilhas e fluxos de cada área viraram módulos, cada um com uma especificação curta antes do código.
integração de sistemas
Integrações e rotinas automáticas
Leitura do ERP pela API própria, repositório de notas fiscais, SEFAZ com certificado digital e SUFRAMA, com rotinas diárias que preenchem os dados.
implantação
Publicação contínua
Cada versão passa por testes automatizados e roteiros de navegador e é publicada sozinha no servidor da empresa, com o manual de cada módulo dentro do próprio sistema.
03Áreas atendidas
O dado registrado por uma área chega pronto à próxima: o pedido do portal vira agendamento, o agendamento vira operação de doca e a solicitação de Compras segue para o Fiscal.
Atlas
Fiscal
Classifica produtos, confere as notas recebidas, fecha o mês e apura créditos.
Contabilidade
Apropria despesas pagas adiantadas e confere o balancete.
Logística e CD
Agenda e recebe cargas, controla as docas e pede notas de devolução.
Compras
Acompanha o estoque crítico, pede remessas e solicita a tributação de produtos.
Controladoria
Acompanha atividades e projetos e administra perfis e acessos.
Parceiros externos
Transportadoras e indústrias pedem a data de entrega pelo portal.
04O que a plataforma entrega
6 áreas
e os parceiros externos trabalhando na mesma base
Um controle só, no lugar dos controles que cada área mantinha em paralelo sobre a mesma coisa.
15 módulos
de negócio, cada um nascido de uma rotina real
Cada área trabalha no mesmo sistema, em vez de manter o próprio controle.
4 integrações
externas: ERP, notas fiscais, SEFAZ e SUFRAMA
Os dados chegam direto da fonte, sem consulta manual.
5 rotinas
automatizadas, que rodam todo dia com trava e registro de cada execução
Preenchem os dados sozinhas e avisam no sino o que mudou.
≈ 80 permissões
combinadas em perfis que o administrador ajusta
O acesso muda junto com a função da pessoa, sem mexer no código.
≈ 2.900 testes
automáticos sobre as regras do sistema
Cada mudança é conferida antes de chegar a quem usa.
Ganhos na operação
- As áreas trabalham sobre a mesma informação, sem controles paralelos.
- Dados do ERP, das notas fiscais, da SEFAZ e da SUFRAMA chegam por rotinas diárias, sem consulta manual.
- Pendências fiscais têm responsável, motivo e histórico.
- O arquivo de cadastro do ERP sai só com os itens completos e mostra o que ficou de fora e por quê.
- Cada perfil vê e edita só o que cabe à sua área.
- Manual e novidades de cada módulo ficam dentro do próprio sistema.
05Destaques técnicos
Controle de acesso por perfil
Perfis gravados no banco e editáveis pelo administrador definem menu, telas e ações; se o banco não responder, o sistema nega o acesso em vez de abrir.
Trilha de auditoria
Campo, valor anterior, valor novo, autor, data e origem (pessoa, importação ou rotina) ficam registrados em todas as áreas que mexem no mesmo dado.
Rotinas automáticas com controle de concorrência
As rotinas diárias rodam dentro da própria aplicação, com trava contra execução dupla; nunca sobrescrevem o que alguém registrou e abrem um conflito para revisão.
Integração com sistemas externos
ERP, notas fiscais, SEFAZ e SUFRAMA têm limites de chamada, certificado digital e login próprios; cada integração respeita a cota e recupera os dias que faltam.
Portal para parceiros externos
Transportadoras e indústrias entram por link assinado e código, numa área separada; cada anexo é checado pelo conteúdo real do arquivo, não só pelo nome.
Testes e entrega contínua
Testes automatizados e roteiros de navegador conferem cada mudança; a publicação roda sozinha em contêiner, com a atualização do banco sem perda de dados.
Tecnologias
- Linguagens
- TypeScript
- SQL
- PowerShell
- Frameworks e bibliotecas
- Next.js
- React
- Zod
- Web
- Tailwind CSS
- Banco de dados e ORM
- Prisma
- PostgreSQL
- Runtime e contêineres
- Docker
- Testes e qualidade
- Playwright
- Vitest
- Versionamento e CI/CD
- GitHub Actions
Termos desta página
- WinThor
- O ERP da TOTVS usado pela empresa
- ERP
- Sistema de gestão usado por toda a empresa
- SEFAZ
- Secretaria da Fazenda do Amazonas
- SUFRAMA
- Órgão que administra a Zona Franca de Manaus
- Zona Franca de Manaus
- Região com regras fiscais próprias
- API
- Ponte para um sistema consultar outro
- Uso e consumo
- Material comprado para uso da própria empresa
- Imobilizado
- Bem durável da empresa, como uma máquina
- Contêiner
- Pacote que leva o sistema pronto para rodar