Servidor e nuvem

Onde os eventos chegam

Um servidor em Python, sem nenhuma dependência externa, guarda o histórico e as fotos e oferece o painel de administração. No protótipo ele faz o papel da API do sistema hospitalar. Desde 08/11/2026 roda numa VM em São Paulo com HTTPS.

Rotas da API

A câmera fala com /api/device/*; o painel, com /api/admin/*.

RotaQuem chamaPara quê
POST /api/device/eventscâmeraentrega um evento; repetir o mesmo identificador não duplica
POST /api/device/photocâmerafoto JPEG de até 256 KB, só para evento de acesso autorizado
POST /api/device/heartbeatcâmerasinal de vida a cada 10 s, com fila e perdas; devolve a hora do servidor
GET /api/device/commandcâmerabusca comando pendente (troca de senha pedida no painel)
POST /api/device/command-resultcâmeraconfirma que o Mega aplicou ou recusou o comando
GET /api/admin/overviewpainelúltimos 200 eventos, pessoas, comandos e estado do aparelho
GET /api/admin/photopainelfoto de um evento
POST /api/admin/resetpainelpede nova senha de 6 dígitos para um ID; fica pendente até o Mega confirmar

A troca de senha nunca é aplicada pelo servidor: ele cria um comando, a câmera leva ao Mega, o Mega confere se a senha é única e responde. O painel mostra "pendente" até essa resposta chegar. Comando sem resposta em 24 h expira e a senha guardada nele é apagada.

Banco de dados

TabelaGuarda
eventscada evento com identificador, sessão, tipo, pessoa, método, motivo, horário do aparelho e horário de chegada
photoso JPEG de cada acesso autorizado, ligado ao evento
usersIDs conhecidos e se estão ativos
commandspedidos de troca de senha e o resultado
devicesúltimo sinal de vida, fila e contadores de perda acumulados entre reinícios da câmera

Segurança

Hospedagem

Uma VM pequena, HTTPS automático e custo vigiado.

ESP32-CAMchave do aparelho Navegadorsenha + PIN Caddy (porta 443)certificado Let's Encryptsenha no painel server.py (127.0.0.1:8080)SQLite com eventos e fotosbackup diário, 14 dias HTTPSsó local

Painel

O painel fica atrás de duas camadas: a senha que o navegador pede (Caddy) e o PIN de 10 dígitos do sistema. Ele não é público, e este site não publica o endereço dele.

Testar o servidor sem a placa

O script scripts/testar-servidor.py confia só nas raízes gravadas na câmera, mantém a conexão aberta como ela e usa apenas pedidos que não gravam nada. Medido contra a VM: negociação TLS 1.3 em cerca de 300 ms e cada pedido seguinte entre 22 e 50 ms. Contra um site com certificado de outra autoridade, ele acusa a falha, que é exatamente o que a câmera faria.

DEVICE_KEY=... python3 scripts/testar-servidor.py https://<domínio>
AnteriorFirmwarePróximaGabinete