🚀 Suporte Lorentz — comece aqui¶
Você não precisa navegar pastas no Linux. Use este site (menu à esquerda + busca) ou siga os fluxos abaixo.
Escolha seu cenário¶
| Eu preciso… | Abra | Comando principal |
|---|---|---|
| Instalar VPS nova (cliente) | Deploy VPS AWS/Hostinger | ./scripts/deploy-all.sh |
| Hostinger passo a passo | 38 — VPS Hostinger | Fases 1–12 no hPanel |
| Treinar sem VPS (Windows/WSL) | Lab local WSL/Docker | ./scripts/deploy-lab-local.sh — Desktop opcional; preferir Docker CE na distro WSL (ex. Debian) + Portainer :9000 |
| Preparar o Windows do lab | 50 — winget, Hyper-V, Sandbox, WSL | .\scripts\setup-lab-windows.ps1 -Apply (PowerShell administrador) |
| Homologar na LAN (máquina de suporte) | 47 — Windows 11 192.168.144.89 |
Mesmo script, URLs http://192.168.144.89:…. Sem Issabel |
| Subir o Laravel junto do legado | 48 — Omnichannel-System | ./scripts/deploy-omnichannel.sh — porta 8095 |
| Instalar um app opcional | Índice instalação apps | ver guia 27–31 |
| Ver o que está no ar / off | Guia scripts deploy | ./scripts/diagnose-stack.sh --brief |
| Algo quebrou após deploy | Troubleshooting | ./scripts/diagnose-stack.sh --problems |
| Aprendizado / cutover Hostinger | 39 — Lab → Hostinger | Checklist §1 + catálogo de incidentes (TLS, AWS URL, Supervisor, Portainer) |
| Preparar URA no Issabel (VPS) | 43 — Issabel URA Hostinger | Ramais 401–405 + DTMF enquanto NS500 monta |
| Lab homologação completo | 44 — CTI + Supervisor + Cliente | ≥10 ramais; URA + Server + Cliente + Supervisor |
| Download kit suporte | 45 — Operador suporte · MonitorOPS Ferramentas | Fontes + requisitos (IP allowlist) |
| Cursor ↔ SSH Hostinger | 40 — Cursor SSH Hostinger | Remote-SSH + agente lab; chave id_ed25519artesdosul; script setup-cursor-remote-vps.sh |
| Checklist completo de teste | 33 — Pendências e to-dos | marcar itens Alta → Baixa |
| Prioridades monorepo (P0/P1) | TODO-PRIORIDADES.md | Supervisor · Hotel · IoT · URA |
| MonitorOPS (painel web) | Dashboard :9090 | http://IP:9090/ |
| Entender portas e fluxos | Mapa do ambiente | — |
Fluxo VPS — passo a passo (copiar e colar)¶
cd ~/omnichannel/lorentz-vps-stack
# 1. Preparar pacote (se veio do .tar.gz de suporte)
./scripts/prepare-support-install.sh
# 2. Editar senhas e IP
nano .env
# 3. Checklist ANTES do deploy
./scripts/check-pre-install.sh
# 4. Deploy completo (1ª vez ou reinstalação — demora horas por causa do Issabel)
./scripts/deploy-all.sh
# 5. Validar
./scripts/validate-install.sh --external
Importante: deploy-all.sh não é só “ligar o que caiu”. Detalhes: Guia scripts deploy.
Fluxo lab Windows (WSL2)¶
# Confirme a distro com Docker (padrão *):
# wsl -l -v
# Terminal Cursor: Debian (ou Ubuntu com Engine). Desktop NÃO é obrigatório.
cd ~/omnichannel/lorentz-vps-stack # ou /mnt/d/omnichannel/lorentz-vps-stack
./scripts/deploy-lab-local.sh
./scripts/deploy-lab-local.sh --all-optional # webphone + energy + licenca
Sem Issabel/PABX — normal no lab.
UI Docker no lab: Portainer em http://localhost:9000 — se der timeout no 1º setup: wsl -d Debian -e docker restart portainer. Detalhes: 24 §3.1.
Apps opcionais (não entram no deploy-all)¶
./scripts/deploy-webphone.sh
./scripts/deploy-lorentz-energy.sh
./scripts/deploy-licenca.sh
./scripts/deploy-portainer.sh
Onde está o guia longo?¶
O arquivo INSTALACAO-SUPORTE.md na raiz do repositório é o manual completo (centenas de linhas).
Neste site, use o menu Instalação e operação ou a [busca 🔍] no topo.
Abrir esta documentação no PC¶
Desenvolvimento / preview:
cd lorentz-vps-stack
pip install -r requirements-docs.txt
./scripts/serve-docs.sh
# Browser: http://127.0.0.1:8000
Site publicado (quando disponível): http://lorentzdocs.orbitall.net.br/ (Portal Orbitall → Docs).