atlas.txt
Projetos

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

Mapa das integrações do AtlasO Atlas fica no centro. À esquerda, o WinThor (TOTVS) alimenta a API de integração própria, e o repositório de notas envia XML. Acima, SEFAZ e SUFRAMA. Abaixo, BI e o portal externo. À direita, o banco de dados, as notificações e as filas das áreas.

O que entra e o que sai do Atlas

  1. entradaWinThor (TOTVS) para API de integração (própria)Consultas ao banco do ERP.
  2. entradaAPI de integração para AtlasNotas de entrada, títulos a pagar e estoque.
  3. entradaRepositório de notas para AtlasXML de NF-e e CT-e.
  4. entradaSEFAZ para AtlasDatas de desembaraço.
  5. entradaSUFRAMA para AtlasTaxa TCIF.
  6. entradaBI (arquivos exportados) para AtlasBase do estoque crítico.
  7. entradaPortal externo para AtlasPedidos de agendamento de transportadores e indústrias.
  8. ida e voltaAtlas e de volta para Banco de dados (PostgreSQL)Registros e histórico.
  9. saídaAtlas para NotificaçõesAvisos das rotinas.
  10. 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
Lê o ERP por API própria, recebe notas, vendas e dados públicos e devolve ao ERP um arquivo pronto para importar.

02Abordagem

  1. 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.

  2. 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.

  3. 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.

Agendamentos: a agenda do centro de distribuição, com as cargas previstas de cada dia.
Registro de Notas de Uso e Consumo e Imobilizado: o que chegou, o que falta registrar e o que já está registrado.
Cadastro de Tributação: a classificação fiscal dos produtos, que vira o arquivo de cadastro do ERP.

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.

    Tecnologias e técnicas: Next.js · JWT · PostgreSQL

  • 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.

    Tecnologias e técnicas: auditoria · Prisma

  • 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.

    Tecnologias e técnicas: Node.js · PostgreSQL

  • 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.

    Tecnologias e técnicas: TypeScript · Zod · certificado digital

  • 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.

    Tecnologias e técnicas: Next.js · HMAC · upload seguro

  • 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 e técnicas: Vitest · Playwright · Docker · GitHub Actions

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