docs: add V1.0.2 architecture rules for Dev Environment
VPS 4 Builder
+68
@@ -0,0 +1,68 @@
|
|||||||
|
# V1.0.2 - Arquitetura de Desenvolvimento (Live Reload)
|
||||||
|
|
||||||
|
Esta versão estabelece as regras e a estrutura para o novo ambiente de desenvolvimento em tempo real (Live Reload / HMR), garantindo agilidade na prototipação visual sem sacrificar a estabilidade da Produção.
|
||||||
|
|
||||||
|
## 1. Princípios Imutáveis
|
||||||
|
|
||||||
|
1. **Proxy Reverso:** Sempre **Traefik**, nunca Nginx. O roteamento de subdomínios é gerido via *labels* no `docker-compose.yml`.
|
||||||
|
2. **Isolamento de Produção (VPS 1):** A Produção na VPS 1 deve focar exclusivamente em rodar a versão estável final aprovada para os clientes, sem lidar com processos pesados de desenvolvimento (compilação Node/Vite).
|
||||||
|
3. **DNS Hostinger:** O gerenciamento do domínio (`rx.scoreodonto.com` e `dev.rx.scoreodonto.com`) é feito via DNS da Hostinger. Não usamos túneis do Cloudflare. A VPS 1 é a única porta de entrada exposta.
|
||||||
|
|
||||||
|
## 2. Diagrama de Fluxo e Roteamento
|
||||||
|
|
||||||
|
```text
|
||||||
|
=======================================================================================
|
||||||
|
1. PAINEL DA HOSTINGER (ZONA DNS)
|
||||||
|
=======================================================================================
|
||||||
|
Tipo A | Nome: @ (rx.scoreodonto.com) | Alvo: [IP Público da VPS 1]
|
||||||
|
Tipo A | Nome: dev (dev.rx.scoreodonto.com) | Alvo: [IP Público da VPS 1]
|
||||||
|
|
||||||
|
=======================================================================================
|
||||||
|
2. VPS 1 (APP & TRAEFIK GATEWAY PRINCIPAL)
|
||||||
|
IP VPN: 10.99.0.1
|
||||||
|
=======================================================================================
|
||||||
|
[ TRAEFIK ]
|
||||||
|
(Gera SSL automático via Let's Encrypt para os dois domínios)
|
||||||
|
│
|
||||||
|
SE O USUÁRIO DIGITAR: │ SE A EQUIPE DEV DIGITAR:
|
||||||
|
rx.scoreodonto.com │ dev.rx.scoreodonto.com
|
||||||
|
│ │ │
|
||||||
|
▼ │ ▼
|
||||||
|
[ DOCKER COMPOSE PRODUÇÃO ] │ Encaminha requisição transparente
|
||||||
|
- Roda contêineres estáticos │ pela rede VPN (ex: 10.99.0.4:5173)
|
||||||
|
- Consome zero recursos de DEV │ │
|
||||||
|
│ │ │
|
||||||
|
▼ │ │
|
||||||
|
[ BANCO DE PRODUÇÃO (VPS 3) ] ◄──┼──────────────────┘
|
||||||
|
│
|
||||||
|
=======================================================================================
|
||||||
|
3. VPS 4 (BUILDER & WORKSPACE)
|
||||||
|
IP VPN: 10.99.0.4
|
||||||
|
=======================================================================================
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
[ DOCKER COMPOSE DESENVOLVIMENTO ]
|
||||||
|
- Exposto para a VPN na porta 5173.
|
||||||
|
- Roda "npm run dev" (Vite HMR / Hot Reload).
|
||||||
|
- Conecta diretamente no BD da VPS 3 (Produção).
|
||||||
|
|
||||||
|
⚠️ NOTA OBRIGATÓRIA SOBRE O BANCO:
|
||||||
|
O uso do banco de produção pelo ambiente de
|
||||||
|
desenvolvimento é PROVISÓRIO. Um banco de dados
|
||||||
|
dedicado/isolado para desenvolvimento será
|
||||||
|
implantado no futuro para garantir integridade.
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
[ PASTA /home/deploy/stack/rx.scoreodonto.com ]
|
||||||
|
- Mapeada via Volume (-v) direto pro contêiner.
|
||||||
|
- Edições de código feitas pela IA ou humanos
|
||||||
|
refletem na tela do navegador instantaneamente.
|
||||||
|
```
|
||||||
|
|
||||||
|
## 3. Fluxo de Trabalho (Deploy)
|
||||||
|
|
||||||
|
Com esta estrutura, o ciclo de atualizações fica assim:
|
||||||
|
1. Trabalha-se ativamente no código na VPS 4 (Workspace).
|
||||||
|
2. O resultado visual e funcional é testado instantaneamente em `dev.rx.scoreodonto.com`.
|
||||||
|
3. Somente após a aprovação das alterações e do layout, o commit é empurrado via Git para o Gitea.
|
||||||
|
4. O Webhook oficial aciona a pipeline de Produção pesada (~5 min), buildando e sincronizando os contêineres para a VPS 1 de forma segura.
|
||||||
Reference in New Issue
Block a user