Argos

Controle eletrônico de faltas do Corpo de Alunos — EEAR

Projeto do CIDIT · Esquadrão Prata

---

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

• 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

---

_{Corpo de Alunos · Esquadrão Prata · EEAR}