Trabalho para cliente
ART Controles
O ART Controles é um sistema web que registra onde cada equipamento está, quem responde por ele e para qual evento ou locação foi alocado.
- Tecnologias utilizadas
- Status
- Em produção
O problema
Empresas que operam controle de acesso e credenciamento em eventos movimentam equipamentos continuamente: câmeras, controladores de acesso, notebooks e leitores faciais saem do estoque, vão para um evento ou uma locação e voltam. Sem um registro único, ninguém sabe ao certo onde está cada item nem quem responde por ele. Um risco concreto é o mesmo equipamento constar em dois eventos ao mesmo tempo, o que compromete todo o controle de patrimônio.
O que foi construído
O ART Controles é um sistema web de gestão de equipamentos, feito sob medida para uma empresa de controle de acessos e credenciamento em eventos. Ele acompanha cada item desde a entrada no estoque até a baixa. Entre as funções:
- cadastro de equipamentos com número de patrimônio, número de série, categoria, local atual e responsável, ou controle apenas por quantidade para acessórios como cabos e fontes;
- alocação de equipamentos a eventos e a locações, com protocolo de entrega em PDF;
- devolução em lote por leitura de QR code, com câmera ou leitor USB, ou por digitação do patrimônio;
- inventário físico que compara a contagem com o registro e aponta divergências;
- ordens de manutenção preventiva, corretiva e preditiva;
- orçamentos de locação com preço por dia, desconto por item e desconto global;
- sete tipos de relatório, exportáveis em PDF e Excel.
Como funciona
Todo equipamento está sempre em uma de seis situações: em estoque, em evento, em locação, em manutenção, baixado ou extraviado. Cada saída, retorno ou envio para manutenção gera uma movimentação, com origem, destino, responsáveis e o usuário que a registrou.
Um equipamento com patrimônio só pode estar em um evento ou locação por vez. Ao devolvê-lo, o sistema só o marca como em estoque se não houver outra alocação ativa. Quando todos os itens de um evento ou locação voltam, o evento ou a locação é concluído automaticamente.
No inventário, o sistema registra a situação esperada de cada equipamento que atende aos filtros e compara a contagem física com esse registro, e não com o estado atual, que pode mudar durante a contagem. Ao abrir uma ordem de manutenção, o equipamento passa a constar como em manutenção e não pode ser alocado. Ao concluí-la, volta ao estoque.
Acesso, auditoria e operação
O sistema tem quatro perfis: administrador, gestor, colaborador e auditor. As permissões são verificadas no servidor. A sessão usa um token de acesso de 30 minutos e um token de renovação de 7 dias, e o token de acesso só é renovado automaticamente enquanto o usuário está ativo. O login aceita no máximo 5 tentativas por minuto por endereço IP, e todo usuário novo precisa trocar a senha antes de usar o sistema.
A auditoria registra quem fez o quê, quando e de onde, com os valores antes e depois de cada edição. Administradores e auditores consultam esse registro dentro do sistema.
Em produção, o ART Controles roda em três contêineres Docker: o banco PostgreSQL, a API FastAPI com dois processos de trabalho e um servidor Nginx que atende por HTTPS, entrega a interface React e repassa as chamadas da API ao backend. O deploy é feito por um script que obtém a versão nova do repositório, reconstrói os contêineres e aplica as migrações do banco automaticamente. O manual do administrador documenta o backup e a restauração do banco, incluindo uma rotina diária que guarda sete dias de cópias.
Para quem é e em que estágio está
O ART Controles atende a quem cuida de estoque e envia equipamentos de TI e segurança eletrônica para instalações temporárias: administradores, gestores, colaboradores e auditores. Está em produção e é uma ferramenta de uso interno do cliente, acessada por login.
Perguntas frequentes
O que é o ART Controles?
O ART Controles é um sistema web de gestão de equipamentos que a Sigil Labs construiu para uma empresa de controle de acessos e credenciamento em eventos. Ele registra a localização, o responsável, as movimentações, a alocação em eventos, a manutenção e os orçamentos de locação de cada equipamento.
Como o ART Controles evita que um equipamento seja alocado a dois eventos ao mesmo tempo?
Um equipamento com número de patrimônio só pode estar em um evento ou locação por vez. Para enviá-lo a outro destino, é preciso devolvê-lo ao estoque, e a mensagem de erro informa onde ele está alocado. Nas alocações, o banco de dados bloqueia a linha do equipamento, de modo que duas requisições simultâneas não o aloquem juntas.
O ART Controles lê QR code?
Sim. O sistema lê etiquetas de QR code pela câmera do dispositivo ou por um leitor USB, e também aceita a digitação do número de patrimônio. A leitura é usada para adicionar equipamentos a um evento, conferir devoluções, registrar devoluções em lote e executar inventários.
Quem pode fazer o quê no ART Controles?
O sistema tem quatro perfis de acesso, que são administrador, gestor, colaborador e auditor. O administrador tem acesso total, o auditor só consulta e exporta, e o colaborador não exclui registros nem aprova orçamentos. As permissões são verificadas no servidor, e não apenas escondidas na interface.
O ART Controles está em produção?
Sim. O ART Controles está em produção e operacional, segundo a documentação do projeto. É uma ferramenta de uso interno do cliente, acessada por login.