Deployment

Despliegue de GekkoCheckin.

Integrado en application/docker (recomendado)

GekkoCheckin se despliega junto a unpispas en el mismo servidor:

cd application/docker
./run-lxc.sh   # o: docker compose -f docker-compose.yml -f docker-compose.lxc.yml --profile lxc --profile gekkocheckin up -d

URLs: https://app.gekkocheckin.mywire.org, https://api.gekkocheckin.mywire.org, https://docs.gekkocheckin.mywire.org

Desarrollo (puertos directos):

cd gekkocheckin/docker
cp env.example .env
./rundocker.sh dev

Producción (nginx-proxy + Let's Encrypt):

cd gekkocheckin/docker
cp env.example .env   # editar DOMAIN, LETSENCRYPT_EMAIL, POSTGRES_PASSWORD, REDIS_URL
./rundocker.sh

Servicios: https://app.<DOMAIN>, https://api.<DOMAIN>

Variable	Descripción	Ejemplo
`DOMAIN`	Dominio base	`gekkocheckin.mywire.org`
`LETSENCRYPT_EMAIL`	Email para certificados	`admin@ejemplo.com`
`POSTGRES_PASSWORD`	Contraseña PostgreSQL	(secreto)
`REDIS_URL`	URL de Redis	`redis://redis:6379`
`DOCUMENT_ENCRYPTION_KEY`	Clave cifrado documentos (32 bytes Base64)	`openssl rand -base64 32`

# Backend
cd backend && cargo run

# Frontend
cd frontend && ionic serve

Requiere PostgreSQL y Redis corriendo localmente.

El backend escribe logs en LOG_PATH/gekkocheckin-api.php.log (por defecto /var/log/gekkocheckin).

Visor integrado (passphrase configurable con LOG_ACCESS):

https://api.<DOMAIN>/api/logger?access=controldeacceso

La documentación se sirve en https://docs.gekkocheckin.mywire.org (o docs.<DOMAIN>).

Qué	Comando
Docs local	`./scripts/regenerar-docs.sh` → `mkdocs serve` para previsualizar
Diagramas	`./scripts/regenerar-diagramas.sh`
Docker (application/docker)	`docker compose -f docker-compose.yml -f docker-compose.lxc.yml --profile gekkocheckin up -d --build gk-docs`
Docker standalone	`docker compose -f docker-compose.docs.yml up -d --build`

Ver Estrategia de backup para los volúmenes a incluir en copias de seguridad.