Repositórios da stack Lorentz VPS¶

Layout esperado na VPS: ~/omnichannel/ com repositórios irmãos.

Mapa de diretórios¶

~/omnichannel/
├── lorentz-vps-stack/     ← este repo (Docker, scripts, portal, config)
├── supervisor/            ← PHP Supervisor + Operador Web (cliente/)
├── lorentz-webphone/      ← softphone web (profile webphone)
├── lorentz-energy/        ← gestão energia (profile energy, opcional)
├── server/                ← fontes .NET (build local → zip em resources/)
│   ├── LorentzCTI/
│   ├── LorentzDB.Worker/
│   └── Lorentz.Licenca.Api/
├── client/                ← LorentzCliente desktop (referência; não no compose)
├── ura/                   ← IVR VB.NET (Windows; fora do Docker Linux)
└── issabel4-docker/         ← PBX Issabel (deploy separado, rede host)

Repositórios Git¶

Repo	Caminho local/VPS	Remote (padrão)	Branch VPS	Papel na stack
lorentz-vps-stack	`lorentz-vps-stack/`	araguaci/lorentz-vps-stack	`main`	Orquestração Docker, portal, monitor, templates `.env`
supervisor	`supervisor/`	araguaci/lorentz-supervisor	`lorentz-vps`	Supervisor PHP (Orbitall/Hostinger); legado Oncoguia: `oncoguia-vps`
lorentz-webphone	`lorentz-webphone/`	araguaci/lorentz-webphone	`main`	Webphone PWA + CTI (container `lorentz-webphone`)
lorentz-energy	`lorentz-energy/`	araguaci/lorentz-energy	`main`	App Energy (profile opcional)
issabel4-docker	`issabel4-docker/`	araguaci/issabel4-docker (upstream: Vasqs/issabel4-docker)	`main`	Issabel PBX / WebRTC WSS (fora do compose principal)

Artefatos binários (não vêm do `git clone`)¶

Gerados no PC de build e enviados para lorentz-vps-stack/resources/:

Artefato	Origem (monorepo `omnichannel/`)	Script build
`resources/net9.0.zip`	`server/LorentzCTI/`	`scripts/build-lorentz-cti-zip.sh`
`resources/basehistorica.zip`	`server/LorentzDB.Worker/`	`scripts/build-lorentz-basehistorica-zip.sh`
`resources/licenca.zip`	`server/Lorentz.Licenca.Api/`	`scripts/build-lorentz-licenca-zip.sh`
`resources/supervisor.tar.gz`	`supervisor/`	`scripts/build-dist-package.sh`

Repositórios do ecossistema Omnichannel (fora do compose VPS)¶

Repo / pasta	Uso
`client/LorentzCliente/`	Cliente desktop VB.NET (legado)
`client/LorentzCliente/docs/`	Planos paridade webphone
`ura/`	URA / IVR Windows Service
`license-system/`	Laravel licenças comercial
`gerador-licenca/`	Gerador desktop `.lic`
`projetos/`	Referências (waha, chatbot, etc.)

Serviços Docker × origem¶

Container	Código-fonte
`lorentz-sqlserver`	Imagem Microsoft (sem repo)
`lorentz-cti`	`resources/net9.0.zip` ← `server/LorentzCTI`
`lorentz-basehistorica`	`resources/basehistorica.zip`
`lorentz-supervisor`	bind `../supervisor/`
`lorentz-portal`	`lorentz-vps-stack/portal/`
`lorentz-monitor`	`lorentz-vps-stack/docker/monitor/`
`lorentz-webphone`	build `../lorentz-webphone/`
`lorentz-energy`	build `../lorentz-energy/`
`lorentz-licenca`	`resources/lorentz-licenca-publish/`
Issabel	`~/issabel4-docker/` (script `deploy-issabel.sh`)

Clone completo (VPS nova)¶

Base típica Hostinger (root): /root/omnichannel. AWS/ubuntu: /home/ubuntu/omnichannel.

mkdir -p /root/omnichannel && cd /root/omnichannel

git clone -b main https://github.com/araguaci/lorentz-vps-stack.git
git clone -b lorentz-vps https://github.com/araguaci/lorentz-supervisor.git supervisor
git clone -b main https://github.com/araguaci/lorentz-webphone.git lorentz-webphone

# Opcionais
git clone -b main https://github.com/araguaci/lorentz-energy.git lorentz-energy
git clone --depth 1 -b main https://github.com/araguaci/issabel4-docker.git /root/issabel4-docker

Ou, com o stack já clonado:

cd /root/omnichannel/lorentz-vps-stack
chmod +x scripts/*.sh
./scripts/setup-vps-git-remotes.sh --clone-missing

Atualizar código na VPS (`git pull`)¶

Passo	Onde	Comando
1	PC dev	Commit + `git push origin main` (este repo)
2	VPS	`./scripts/setup-vps-git-remotes.sh` (1ª vez ou se origin errado)
3	VPS	`./scripts/pull-stack-on-vps.sh --render`
4	VPS	(se mudou Docker/nginx) `./scripts/pull-stack-on-vps.sh --rebuild`

Remotes padrão (HTTPS, sem token — repos public):

Pasta	`origin`	Branch
`lorentz-vps-stack/`	`https://github.com/araguaci/lorentz-vps-stack.git`	`main`
`supervisor/`	`https://github.com/araguaci/lorentz-supervisor.git`	`lorentz-vps`
`lorentz-webphone/`	`https://github.com/araguaci/lorentz-webphone.git`	`main`
`lorentz-energy/`	`https://github.com/araguaci/lorentz-energy.git`	`main`
`issabel4-docker/`	`https://github.com/araguaci/issabel4-docker.git`	`main`

Legado: supervisor-php branch oncoguia-vps (deploy Oncoguia antigo). Variável .env: SUPERVISOR_GIT_BRANCH=lorentz-vps.

Repo privado: configure deploy key ou git config credential.helper na VPS, ou use sync-lab-to-vps-safe.sh do PC.

Clone completo (legado — supervisor-php)¶

git clone https://github.com/araguaci/supervisor-php.git supervisor
# branch legado Oncoguia: oncoguia-vps

Ver também: INSTALACAO-SUPORTE.md, 32-instalar-apps-core.md, 38-vps-hostinger-passo-a-passo.md.