Contexto
O AgillePro é uma plataforma SaaS empresarial desenvolvida para centralizar a gestão de documentos, apoiar processos de conformidade e organizar informações corporativas em ambientes com múltiplas empresas e usuários.
A solução reúne gestão documental, versionamento, revisão e aprovação, auditoria, Lista Mestre, edição colaborativa de arquivos Office e um assistente de inteligência artificial capaz de pesquisar e responder perguntas a partir do conteúdo documental autorizado.
Desafio
Sistemas de gestão documental precisam combinar controle, rastreabilidade e facilidade de uso sem comprometer a segurança das informações.
O projeto exige coordenar documentos e suas versões, diferentes níveis de acesso, fluxos de revisão e aprovação, armazenamento de arquivos, edição online e isolamento entre empresas. A inteligência artificial acrescenta outro requisito importante: utilizar o conhecimento dos documentos sem permitir que a IA amplie o acesso que o usuário já possui na aplicação.
Além das regras de negócio, a plataforma precisa suportar processamento assíncrono, indexação de documentos e evolução contínua da infraestrutura sem adicionar complexidade desnecessária.
Solução
O AgillePro foi estruturado como uma aplicação web com frontend React e TypeScript e backend modular desenvolvido em Go. Os dados de domínio são mantidos em PostgreSQL, enquanto os arquivos são armazenados em infraestrutura compatível com S3.
O módulo documental controla pastas, versões, acessos, comentários, revisão, aprovação, auditoria, arquivamento e Lista Mestre. A integração com Collabora Online permite editar documentos Office diretamente pela plataforma usando o protocolo WOPI.
A camada de inteligência artificial mantém uma projeção própria e reconstruível do acervo documental. Alterações nos documentos são enviadas para processamento assíncrono, passando por extração de conteúdo, divisão em trechos e geração de embeddings. Nas perguntas ao assistente, a aplicação combina busca semântica e textual para recuperar conteúdo relevante antes de gerar a resposta.
A autorização documental permanece como regra central: cada pergunta realiza uma nova recuperação considerando empresa, usuário e acesso aos documentos, evitando que o histórico da conversa seja utilizado para contornar permissões.
Engenharia
- Frontend SPA com React, TypeScript e Vite.
- Backend modular em Go com APIs REST.
- PostgreSQL como fonte principal dos dados e pgvector para busca semântica.
- Arquitetura multiempresa com validação de tenant e acesso documental.
- Armazenamento de arquivos em S3 com uploads por URLs pré-assinadas.
- Versionamento, revisão, aprovação, auditoria e Lista Mestre.
- Edição de documentos Office com Collabora Online e WOPI.
- Busca híbrida combinando pgvector e full-text do PostgreSQL.
- RAG com recuperação documental autorizada a cada pergunta.
- Indexação assíncrona com outbox transacional, filas e workers.
- Redis/Valkey para sessões, revogação e locks.
- Infraestrutura AWS com CloudFront, S3, ECS/Fargate, RDS e ElastiCache.
Evolução
O AgillePro evolui de forma incremental, mantendo a gestão documental como núcleo da plataforma e adicionando novas capacidades conforme os processos de negócio são consolidados.
A arquitetura foi preparada para permitir que API, processamento assíncrono, inteligência artificial, banco de dados e cache evoluam de forma independente. Novos módulos de gestão também fazem parte da evolução do produto, preservando a estratégia de reutilizar a arquitetura existente antes de introduzir novos serviços ou tecnologias.
Publicação responsável
O case apresenta as capacidades técnicas e funcionais comprovadas do AgillePro sem divulgar informações internas de clientes, volumes de utilização, custos, credenciais ou detalhes sensíveis de infraestrutura.
Funcionalidades em planejamento ou evolução não são apresentadas como recursos já disponíveis. A descrição se concentra na arquitetura, nos desafios de engenharia e nas capacidades efetivamente implementadas na plataforma.