33 — Checklist de teste efetivo e pendências¶

Registro consolidado para não falhar na validação do ambiente completo.
Baseado na auditoria da VPS homologação 3.93.232.33 em 13/07/2026 + pendências do stack v1.9.0.

Como usar: marque [x] conforme concluir. Execute na ordem Alta → Média → Baixa dentro de cada seção.

Resumo da auditoria (13/07/2026)¶

Resultado	Detalhe
`validate-install.sh`	26 OK · 3 avisos · 0 falhas
HTTP externo	Portal, Supervisor, Monitor, Webphone, Energy, Issabel → 200
Core no ar	6/7 (`diagnose-stack`) — Base Histórica parada
Git na VPS	Commit `51d4de0` — atrás do repo local (docs 27–33, scripts novos)

🔴 ALTA — Bloqueia teste efetivo¶

Sem estes itens, funcionalidades prometidas na v1.9 não validam de verdade.

A1. Monitor API CTI (`:8090`) — Dashboard `/cti/` sem dados¶

Sintoma na VPS: curl :8090/health falha; /api/cti/monitor/snapshot devolve HTML do hub, não JSON.
Causa: LorentzCTI.dll de 09/jun/2026 (sem Monitor API); LORENTZ_CTI_MONITOR_API_KEY ausente no .env; container sem porta 8090 publicada.

[ ] Gerar net9.0.zip atual no dev: ./scripts/build-lorentz-cti-zip.sh
[ ] Copiar resources/net9.0.zip para a VPS

[ ] No .env da VPS:

LORENTZ_CTI_MONITOR_API_KEY=ChangeMe_MonitorApi2026!
LORENTZ_CTI_PORT_MONITOR_API=8090

[ ] ./scripts/render-config.sh
[ ] ./scripts/extract-lorentz-cti-publish.sh resources/net9.0.zip
[ ] docker compose up -d --build lorentz-cti (recria container com porta 8090)
[ ] Validar: curl -fsS http://127.0.0.1:8090/health
[ ] Validar: curl -fsS -H "X-Monitor-Api-Key: ..." http://127.0.0.1:8099/api/cti/monitor/snapshot | head -c 80 → JSON, não <!DOCTYPE
[ ] Abrir http://<IP>:8099/cti/ — grid de agentes/dispositivos atualiza

Doc: 07-lorentz-cti-servidor.md · 20-portal-orbitall.md

A2. `.env` incompleto — bloqueia deploy de apps opcionais¶

Sintoma: deploy-lorentz-energy.sh falha com LORENTZ_BASEHISTORICA_API_KEY missing.
Causa: Docker Compose valida todo o arquivo, mesmo com --profile energy.

[ ] Completar .env a partir de .env.example:

LORENTZ_BASEHISTORICA_API_KEY=ChangeMe_BaseHistorica2026!
LORENTZ_LICENCA_API_KEY=ChangeMe_LicencaApi2026!
LORENTZ_CTI_MONITOR_API_KEY=ChangeMe_MonitorApi2026!

[ ] ./scripts/render-config.sh
[ ] Confirmar: grep LORENTZ_BASEHISTORICA .env não vazio

Doc: 27-instalar-app-opcional-energy.md · 32-instalar-apps-core.md

A3. Sincronizar código na VPS¶

Sintoma: Scripts lib-compose-env.sh, docs 28–33, open-aws-port-8443.sh ausentes na VPS.

[ ] git pull em ~/omnichannel/lorentz-vps-stack na VPS
[ ] chmod +x scripts/*.sh
[ ] ./scripts/render-config.sh

A4. Senhas padrão em homologação¶

Risco: credenciais de ENTREGA-V1.9 ainda ativas.

[ ] Trocar MONITOR_ADMIN_PASSWORD no .env → docker compose up -d monitor
[ ] Trocar senha admin do Supervisor (8080)
[ ] Trocar MSSQL_SA_PASSWORD se ainda for exemplo (requer replanejar conexões)

Doc: ENTREGA-V1.9.md · 17-dashboard-monitoramento.md

🟠 MÉDIA — Core incompleto ou integração degradada¶

M1. Base Histórica (`lorentz-basehistorica` :8091)¶

Status VPS: container não existe; publish ausente.

[ ] ./scripts/build-lorentz-basehistorica-zip.sh (dev)
[ ] Transferir basehistorica.zip → VPS
[ ] ./scripts/extract-lorentz-basehistorica-publish.sh
[ ] docker compose up -d --build lorentz-basehistorica
[ ] curl -fsS http://127.0.0.1:8091/health
[ ] UI Supervisor att_basehistorica.php (repo supervisor) — testar quando disponível

Doc: 32-instalar-apps-core.md#3-base-historica

M2. AMI Asterisk — CTI sem eventos recentes¶

Sintoma: validate-install avisa CTI sem AMI / sem sessões.

[ ] Revisar manager_custom.conf no Issabel — permitir rede Docker (172.16.0.0/12 ou bridge do compose)
[ ] Confirmar CTI_Impacta_Ip / AMI user no LorentzCTI.ini
[ ] ./scripts/test-ami.py ou MonitorOPS → Diagnóstico
[ ] Log CTI: docker logs lorentz-cti --tail 100 — eventos AMI

Doc: 09-integracao-e-redes.md · 12-troubleshooting.md

M3. PWA Portal — teste completo em estação Windows¶

Status VPS: HTTPS :8443 responde 200.

[ ] Security Group: porta 8443 aberta (./scripts/open-aws-port-8443.sh)
[ ] Estação Windows: irm http://<IP>:8099/assets/install-portal-cert.ps1 | iex
[ ] Abrir https://<IP>:8443/ — botão ⊕ Instalar App visível
[ ] Instalar PWA e abrir app standalone

Doc: 20-portal-orbitall.md

M4. Webphone — teste de chamada real¶

Status VPS: container healthy, HTTP 200.

[ ] Issabel WSS configurado: ./scripts/configure-issabel-wss.sh
[ ] Ramal WebRTC criado no Issabel
[ ] WEBRTC_EXTENSION / WEBRTC_PASSWORD no .env → render-config.sh
[ ] Abrir http://<IP>:8081/ — registro SIP + chamada de teste
[ ] Áudio bidirecional OK

Doc: 29-instalar-webphone.md · 14-issabel-webrtc-wss.md

M5. Autostart após reboot¶

[ ] sudo ./scripts/install-systemd-stack.sh
[ ] sudo reboot (janela de manutenção)
[ ] Após voltar: docker compose ps + Issabel systemctl status issabel
[ ] ./scripts/validate-install.sh --external

Doc: 11-operacao-e-manutencao.md

🟡 BAIXA — Opcionais e cosmético¶

B1. Licença API (profile `licenca`)¶

Status VPS: parado — esperado se não implantado.

[ ] ./scripts/build-lorentz-licenca-zip.sh (dev)
[ ] ./scripts/extract-lorentz-licenca-publish.sh
[ ] ./scripts/deploy-licenca.sh
[ ] UI: http://<IP>:8099/licenca/ — gerar .lic de teste
[ ] Validar .lic no CTI/URA

Doc: 30-instalar-licenca.md · 23-plano-licenca-api-linux.md

B2. Portainer (`:9443` unhealthy)¶

Sintoma: health unhealthy — timeout de senha admin (não impede uso após restart).

[ ] docker restart lorentz-portainer
[ ] Abrir https://<IP>:9443/ em 5 min — criar senha admin
[ ] Restringir SG ao IP da TI

Doc: 31-instalar-portainer.md

B3. Lorentz Energy — já OK na VPS¶

Status: healthy; app real (<title>Lorentz Energy).

[ ] Confirmar link no hub Orbitall (portal.apps.json)
[ ] Teste externo: http://<IP>:8082/
[ ] (Opcional) ./scripts/deploy-lorentz-energy.sh --pull após releases

Doc: 27-instalar-app-opcional-energy.md

B4. Tema Issabel lorentzpbx¶

[ ] ./scripts/deploy-issabel-theme.sh ou MonitorOPS → Ferramentas
[ ] Limpar cache Smarty se visual não atualizar

Doc: README — seção Tema Issabel

Checklist de teste por app (marque todos)¶

Use após corrigir itens Alta.

#	App	URL / teste	OK
1	SQL Server	`docker compose ps sqlserver` healthy	[ ]
2	Lorentz CTI Concentre	TCP `:3000`	[ ]
3	Lorentz CTI Agentes	TCP `:8000`	[ ]
4	Monitor API	`curl :8090/health`	[ ]
5	Base Histórica	`curl :8091/health`	[ ]
6	Supervisor	`http://<IP>:8080/login.php` 200	[ ]
7	Portal HTTP	`http://<IP>:8099/` 200	[ ]
8	Portal HTTPS/PWA	`https://<IP>:8443/` + Instalar App	[ ]
9	CTI Dashboard	`/cti/` com dados JSON ao vivo	[ ]
10	MonitorOPS	`http://<IP>:9090/` login	[ ]
11	Webphone	`http://<IP>:8081/` + chamada	[ ]
12	Energy	`http://<IP>:8082/` 200	[ ]
13	Issabel	`https://<IP>/` 200	[ ]
14	Issabel SIP	registro ramal / tronco	[ ]
15	Licença UI	`/licenca/` (se implantado)	[ ]
16	Portainer	`https://<IP>:9443/` (se implantado)	[ ]

Comando único:

./scripts/validate-install.sh --external
./scripts/diagnose-stack.sh --problems

Roadmap — não bloqueia homologação atual¶

Item	Prioridade negócio	Doc
Licença API Fase 3 (persistência SQL + golden tests)	Média	23
UI Base Histórica no Supervisor	Média	monorepo `att_basehistorica.php`
Domínio `orbitall.app` + Let's Encrypt	Média	22
Planta B Impacta CSTA	Baixa	21
Publicar docs MkDocs em nginx (`site/`)	Baixa	26
Integrar `build-docs.sh` no pacote dist	Baixa	15
Commit/push alterações locais do stack	Alta (dev)	git status local

Ordem de execução recomendada (copiar)¶

# === Na VPS ===
cd ~/omnichannel/lorentz-vps-stack
git pull
chmod +x scripts/*.sh

# 1. .env completo
nano .env   # A2 — chaves BASEHISTORICA, MONITOR, LICENCA

# 2. CTI com Monitor API
./scripts/render-config.sh
./scripts/extract-lorentz-cti-publish.sh resources/net9.0.zip
docker compose up -d --build lorentz-cti

# 3. Base Histórica (se zip disponível)
./scripts/extract-lorentz-basehistorica-publish.sh resources/basehistorica.zip
docker compose up -d --build lorentz-basehistorica

# 4. Validar
./scripts/validate-install.sh --external
./scripts/diagnose-stack.sh --problems

# 5. Opcionais
./scripts/deploy-licenca.sh      # se tiver licenca.zip
docker restart lorentz-portainer # Portainer

Histórico¶

Data	Evento
2026-07-13	Criado após auditoria SSH VPS 3.93.232.33 + consolidação pendências v1.9