Coolify Architect Guidance

Skill: Orientación Arquitectónica para Coolify

Propósito

Este skill te guía en la construcción de arquitecturas de despliegue reproducibles en Coolify, partiendo de la metodología documentada en directo_coolify.md. Asegura que cada solución que generes siga el principio: "push a GitHub y despliegue automático en Coolify a la primera" sin intervención manual recurrente.

---

1. Modelo de Referencia: Coolify + Docker Compose

Arquitectura Objetivo

┌─────────────────────────────────────────────────────────┐
│ GitHub Repository (Source of Truth)                     │
│ ├── docker-compose.yml (base, Coolify-ready)           │
│ ├── .github/workflows/ (CI/CD triggers)                │
│ └── Dockerfile(s) y código                             │
└──────────────────────┬──────────────────────────────────┘
                       │ push + tag
                       ▼
┌─────────────────────────────────────────────────────────┐
│ Coolify Panel (217.216.81.73:8000)                      │
│ ├── Detecta cambios en GitHub (webhook)                │
│ ├── Build remoto (docker build)                        │
│ └── Deploy automático                                  │
└──────────────────────┬──────────────────────────────────┘
                       │ enrutamiento
                       ▼
┌─────────────────────────────────────────────────────────┐
│ Traefik (gestionado por Coolify)                        │
│ ├── Routing HTTP/HTTPS                                 │
│ ├── TLS (Cloudflare origins)                           │
│ └── Reverse proxy a contenedores                       │
└──────────────────────┬──────────────────────────────────┘
                       │ local network
                       ▼
┌─────────────────────────────────────────────────────────┐
│ Contenedores Docker (stacks multi-servicio)            │
│ ├── web (frontend)          expose: 8080               │
│ ├── api (backend)           expose: 3000               │
│ ├── db (PostgreSQL)         expose: 5432 (solo interno)│
│ ├── cache (Redis)           expose: 6379 (solo interno)│
│ └── worker (async tasks)    expose: N/A                │
│                                                         │
│ Volúmenes persistentes: db_data, uploads, config       │
└─────────────────────────────────────────────────────────┘

                       ▲
                       │ flujo público
                       │
┌─────────────────────────────────────────────────────────┐
│ Cloudflare (DNS + Proxy)                                │
│ ├── portal.da-tica.com → 217.216.81.73                 │
│ ├── api.da-tica.com → 217.216.81.73                    │
│ └── HTTPS, DDoS, cache                                 │
└─────────────────────────────────────────────────────────┘
                       ▲
                       │
                    Internet