O que é o Argos
O Argos substitui a chamada de presença em papel por um sistema eletrônico simples. O militar responsável abre a chamada, marca presença ou falta de cada aluno e o sistema já gera o registro com data, hora e protocolo — sem planilha, sem papel, sem retrabalho.
O nome vem da vigia constante do efetivo, como o gigante da mitologia grega que nunca dormia — Argos Panoptes, "o que tudo vê", coberto de olhos que vigiavam sem descanso.
Como funciona, em resumo
Passo a passo de cada tela, com imagens, na Wiki do projeto.
- Painel de Comando — onde comandantes, encarregados e auxiliares abrem retiradas de falta, consultam o efetivo e tiram relatórios. Cada cargo vê só o que precisa (o comando de esquadrão vê seu esquadrão; o CA vê tudo).
- Grupos especiais (como o próprio CIDIT) — para atividades que cruzam esquadrões, fora da chamada normal por esquadrilha.
- API — para uso futuro por aplicativo, com chave de acesso própria.
- Painel técnico — administração do sistema: backups, chaves de API e usuários.
Tecnologia
PHP + MySQL, hospedado na Hostinger. Sem frameworks — simples de manter e de dar continuidade.
O sistema não busca nada na internet pra funcionar — fontes, gráficos (Chart.js) e leitor de QR (jsQR) são servidos por ele mesmo, pra poder rodar na intranet da escola. As bibliotecas de terceiros ficam em web/vendor/, web/app/vendor/ e web/fonts/, com as licenças ao lado.
Desenvolvimento e publicação
O repositório principal fica no Forgejo; o GitHub é espelho.
Toda mudança passa por feat/<nome> → develop → release → main, com lint e testes automáticos em cada push.
Uma tag vX.Y.Z na main publica a versão em produção (backup do banco, migrations e smoke test incluídos).
Detalhes — branches, testes, como lançar, rollback e migrations — em docs/CI-CD.md. Como a API decide quem pode o quê: docs/SEGURANCA-API.md.
Pra subir um Argos completo só com dados fictícios e testar as três interfaces: docs/dev/COMO-TESTAR.md (os alunos de teste e seus QR codes estão em docs/dev/SEED-QRCODES.md).
Equipe do projeto
| Nome | Função |
|---|
| AL 26/3138 SIN Simioni | Encarregado do projeto |
| AL 26/3119 SIN Santana | Desenvolvedor |
| AL 26/3103 SIN Menezes | Desenvolvedor |
| AL 26/3118 SIN Gabriel | Desenvolvedor |
