TI Conecta

Contexto

A área fiscal do Grupo Pluma precisa gerar arquivos SAFX (SAFX13 e SAFX82) e controlar quem pode ver e gerar o quê, por empresa e por filial. O TI Conecta é o portal interno que faz as duas coisas.

O que construí

• Geração, listagem, download e exclusão de arquivos SAFX13 e SAFX82, com o arquivo produzido por um workflow do n8n.
• Login com sessão por cookies e menu montado a partir das permissões de cada pessoa.
• Controle de acesso por papéis (RBAC) com escopo por empresa e filial, e uma área administrativa para criar usuários e listar perfis.

Decisões técnicas

• A regra de acesso vive no banco. As permissões são aplicadas com Row Level Security e funções SQL, não apenas na interface; esconder um botão não é segurança.
• Mudança de permissão com prazo conhecido. O cache de autorização tem tempo de vida configurável, então uma alteração de permissão passa a valer num prazo previsível.
• Nada do banco entra sem validação. Toda resposta do banco passa por esquemas Zod antes de chegar à tela.
• Scripts SQL idempotentes, em ordem documentada, para reaplicar sem medo.
• Sem configuração, o app avisa. Sem as chaves do Supabase o sistema sobe e mostra um aviso de configuração pendente, em vez de quebrar.

Resultados

• 160 testes automatizados e deploy em Docker.
• Arquivos fiscais gerados por workflow, em vez de montados à mão.