Protector ISAPI Manager v4.0

Gestão completa de terminais Hikvision Face Recognition via ISAPI
Desenvolvido por Protector Sistemas

---

Sobre

O Protector ISAPI Manager é uma ferramenta desktop para gestão centralizada de terminais de reconhecimento facial Hikvision (Ultra Series). Permite cadastro de pessoas, clonagem entre terminais, backup/restore completo, controle de acesso, auditoria e manutenção remota — tudo via protocolo ISAPI.

Projetado para integradores de segurança eletrônica que precisam gerenciar frotas de terminais com rastreabilidade, método e agilidade.

---

Funcionalidades Principais

Gestão de Terminais e Clientes

Cadastro de clientes com múltiplos terminais, discovery automático na rede, monitoramento de status/ping, import/export via JSON e Excel.

Cadastros e Biometria

Gestão completa de pessoas, faces, cartões e digitais. Busca avançada com filtros por status, foto, regra de acesso. Sincronização entre terminais com preview e exportação Excel/JSON.

Clonagem Facial

Clonagem single (1→1) e multi-dispositivo (1→N) com monitor visual em tempo real, progress bar, backoff adaptativo e resume automático após queda.

Backup & Restore v4.0

Backup completo em ZIP com manifest SHA256: usuários, cartões, fotos faciais e configuração do dispositivo. Restore com validação de integridade e verificação de serial.

Sistema de Sessões

Cada operação cria um SessionID único (SID-XXXX-XXXX-XXXX) com isolamento total. Lock por serial impede operações concorrentes no mesmo equipamento. Checkpoint/resume para operações longas.

Regras de Acesso

Visualização e edição de templates de horário, planos semanais e feriados. Cópia de regras entre terminais e comparação lado a lado.

Eventos e Auditoria

Coleta de eventos por período com tradução PT-BR. Filtros por tipo (facial, negados). Auditoria cruzada entre terminais com relatório de discrepâncias.

Manutenção Remota

Status completo do equipamento, controle de porta (abrir/fechar/manter), reboot, ajuste de hora/NTP, reset de fábrica. Auto-refresh a cada 30s.

Relatórios

Geração de relatórios em Excel, PDF e CSV com filtros por terminal e período. Relatório completo (snapshot do terminal) e relatório de eventos.

Auto-Update

Verificação automática de atualizações ao abrir o app via GitHub Releases. Download e instalação com um clique.

---

Instalação

Via Instalador (Recomendado)

1. Baixe o instalador na página de releases
2. Execute Protector_ISAPI_Manager_v4.0.0_Setup.exe
3. Siga o assistente de instalação
4. O app será instalado em C:\Program Files\Protector ISAPI Manager

O instalador cria atalhos na área de trabalho e no menu Iniciar. Atualizações futuras são detectadas automaticamente.

Via Código Fonte (Desenvolvimento)

git clone https://github.com/ProtectorAnalytics/protector-isapi-manager.git
cd protector-isapi-manager
pip install -r requirements.txt
python app.py

Gerar Executável

python build_release.py --clean --installer

Requer: Python 3.8+, PyInstaller, Inno Setup 6 (para o instalador).

---

Requisitos

Requisito	Especificação
Sistema Operacional	Windows 10/11 (64-bit)
Rede	Acesso HTTP aos terminais Hikvision
Terminais	Hikvision Face Recognition Ultra Series
Protocolo	ISAPI via HTTP/HTTPS com Digest Auth

---

Estrutura do Projeto

protector_isapi_manager_v4/
├── app.py                 # Aplicação principal (GUI CustomTkinter)
├── version.py             # Versão e metadados
├── requirements.txt       # Dependências Python
├── build.spec             # Configuração PyInstaller
├── build_release.py       # Pipeline de build automatizado
├── installer.iss          # Script Inno Setup (instalador)
├── core/                  # Módulos backend
│   ├── isapi_client.py    # Cliente ISAPI (todas as APIs)
│   ├── models.py          # Modelos de dados
│   ├── backup.py          # Sistema de backup ZIP v4.0
│   ├── session.py         # Gerenciamento de sessões
│   ├── reports.py         # Geração de relatórios
│   └── updater.py         # Auto-update via GitHub
├── tests/                 # Testes unitários
├── docs/                  # Documentação
├── assets/                # Ícones e logos
└── scripts/               # Scripts auxiliares Windows

---

Documentação

Documento	Descrição
Manual do Usuário	Guia completo de uso do aplicativo
Manual Técnico	Arquitetura, API e referência técnica
Changelog	Histórico de alterações por versão

---

Screenshots

Em breve

---

Tecnologias

• Python 3.8+ — Linguagem principal
• CustomTkinter — Interface gráfica moderna (dark mode)
• ISAPI/HTTP — Protocolo de comunicação com terminais
• Digest Authentication — Autenticação segura
• PyInstaller — Empacotamento em executável
• Inno Setup 6 — Instalador profissional Windows
• GitHub Releases API — Sistema de auto-update

---

Licença

Software proprietário — Protector Sistemas © 2026. Todos os direitos reservados.

---

_{Desenvolvido com dedicação por Protector Sistemas — Engenharia aplicada à segurança eletrônica}