Procesos y Sistemas Automáticos — CreaRack Pro
Handbook del equipo: Documento de referencia para todo el staff. Describe todos los sistemas automáticos, procesos de trabajo y herramientas tanto del producto (CreaRack-Pro) como del workspace (CreaRackSL-workspace).
Audiencia: Edu, Dani, Txell — no requiere conocimientos técnicos profundos.
Última actualización: 07-04-2026
1. Vista General
CreaRack Pro tiene dos repositorios y múltiples sistemas automáticos:
CreaRackSL-workspace CreaRack-Pro
(equipo + procesos) (código + producto)
├── WORKLOG.md ←sync→ ├── RELEASE_NOTES.md
├── AI_WORKFLOW.md ├── FEATURE_CATALOG.md
├── agents/ (15 IA) ├── CHANGELOG.md
└── profiles/ (3) └── Documentation/ (60+ docs)
Producción (Hetzner)
├── crearack.com (app)
├── Backups automáticos
├── Monitorización 24/7
└── Staging server
2. Repositorios
| Repo | URL | Contenido | Quién lo usa |
|---|---|---|---|
| CreaRack-Pro | github.com/CreaRackSL/CreaRack-Pro | Código fuente de la aplicación | Edu + Dani |
| CreaRackSL-workspace | github.com/CreaRackSL/CreaRackSL-workspace | Contexto IA, procesos, documentación equipo | Edu + Dani + Txell |
3. Sistemas Automáticos en Producción
3.1 Backups (3 niveles)
| Sistema | Frecuencia | Qué hace | Retención |
|---|---|---|---|
| pg_dump | Diario 3:00 AM | Backup completo de la base de datos | 14 días local, 30 días offsite |
| WAL archiving | Cada 15 min | Sync incremental para recuperación precisa | En Object Storage |
| pg_basebackup | Domingo 4:00 AM | Backup físico completo de PostgreSQL | En Object Storage |
| Hetzner snapshots | Semanal (auto) | Imagen completa del servidor | 3 snapshots |
| Backup per-tenant | Diario 3:30 AM | ZIP por organización (14 tipos de datos) | Configurable por plan |
Destino offsite: Hetzner Object Storage (bucket crearack-backups, región nbg1)
En caso de desastre: Ver Documentation/guides/DISASTER_RECOVERY.md — procedimiento de 8 pasos para restaurar desde cero.
3.2 Monitorización
| Sistema | Qué monitoriza | Frecuencia | Alertas |
|---|---|---|---|
| UptimeRobot | crearack.com/health (web + DB + cache) | Cada 5 min | Email a edudomo@gmail.com |
| Sentinel Mode | Dispositivos de red del cliente (SNMP/ping) | 15s-5min | CNS insights + ITSM |
| Prometheus | Métricas internas Django (/metrics) | Continuo | — |
3.3 CI/CD
| Evento | Qué pasa |
|---|---|
Push a main | GitHub Actions ejecuta tests + linting |
Push a main (sin [skip ci]) | Dokploy recibe webhook → build → deploy automático |
Push con [skip ci] en mensaje | CI se salta, Dokploy también salta el deploy |
3.4 Tareas Automáticas (Huey)
| Tarea | Hora | Qué hace |
|---|---|---|
| Backup per-tenant | 3:30 AM | ZIP de datos por organización |
| Purge orgs eliminadas | 4:00 AM | Elimina orgs soft-deleted >90 días |
| Integrity check | 4:30 AM | Detecta anomalías cross-tenant |
| Métricas agregación | Periódica | Agrega samples horarios |
| Transcoding vídeo | On-demand | H.264/H.265 para Digital Signage |
| Proof-of-play | Periódica | Recolecta datos de reproducción |
3.5 Firewall
| Capa | Gestión | Qué protege |
|---|---|---|
| Hetzner Cloud Firewall | Panel web Hetzner | Puertos SSH, HTTP, HTTPS |
| iptables DOCKER-USER | Script en servidor | Dokploy port 3000, GitHub webhooks |
| Django middleware | Código | Rate limiting, CSP, admin IP restriction |
| RLS (PostgreSQL) | Base de datos | Aislamiento de datos entre organizaciones |
4. Servidores
| Servidor | IP | Tipo | Rol | Coste |
|---|---|---|---|---|
| Producción | 116.203.31.166 | CCX (4 vCPU, 16GB) | App en producción | ~€30/mes |
| Staging | 178.104.131.173 | CX23 (1 vCPU, 4GB) | Testing/staging | ~€4.5/mes |
| Object Storage | nbg1 | S3-compatible | Backups offsite | ~€5/mes |
Acceso SSH: ssh root@crearack.com (prod), ssh root@178.104.131.173 (staging)
Panel Dokploy: Puerto 3000 en cada servidor (acceso por IP autorizada)
5. Procesos de Documentación
5.1 Documentos que se actualizan con cada cambio
| Documento | Repo | Cuándo | Quién |
|---|---|---|---|
RELEASE_NOTES.md | CreaRack-Pro | Cada commit funcional | Claude del dev que trabaja |
CHANGELOG.md | CreaRack-Pro | Cada feature/fix técnico | Claude del dev que trabaja |
WORKLOG.md | Workspace | Final de cada sesión significativa | Claude del dev que trabaja |
5.2 Documentos de referencia (se actualizan cuando cambia algo)
| Documento | Repo | Propósito |
|---|---|---|
FEATURE_CATALOG.md | CreaRack-Pro | Inventario completo de funcionalidades (punto cero 07-04-2026) |
Documentation/INDEX.md | CreaRack-Pro | Índice de 60+ documentos técnicos |
AI_WORKFLOW.md | Workspace | Cómo funciona la infraestructura de Claude |
| Este documento | Workspace | Sistemas automáticos y procesos del equipo |
5.3 Convención de commits
| Tipo de cambio | Push | Nota |
|---|---|---|
| Código (bug fix, feature) | Inmediato | Dispara CI + auto-deploy |
| Solo documentación | Diferido o con [skip ci] | No dispara deploy |
| Mixto (código + docs) | Inmediato | Dispara CI + deploy |
6. Trabajo con Claude
6.1 Herramientas por persona
| Persona | Rol | Herramientas | Modelo recomendado |
|---|---|---|---|
| Txell | CEO · CFO | claude.ai + Cowork Desktop | Haiku (workspace), Sonnet (redacción) |
| Dani | CTO · Dev | Claude Code + claude.ai | Opus (código), Haiku (workspace) |
| Edu | COO · Dev | Claude Code + claude.ai + Cowork | Opus (código), Haiku (workspace) |
6.2 Connector MCP — Claude conectado al Workspace
Todos los miembros del equipo pueden conectar Claude al workspace mediante un Custom Connector. Esto permite gestionar tareas, facturas, servidores y documentación con lenguaje natural.
43 herramientas disponibles organizadas en 7 categorías:
| Categoría | Herramientas | Ejemplo |
|---|---|---|
| Tareas | crear, listar, editar, eliminar | ”Crea tarea para Dani: revisar PRs, alta prioridad” |
| Noticias/Alertas/Notas | CRUD completo | ”Publica noticia: reunión mañana a las 10” |
| Servidores | status, uptime, métricas, dashboard | ”¿Cómo están los servidores?” |
| GitHub | PRs, issues, actividad | ”¿Hay PRs abiertos?” |
| Documentación | leer guías, worklog | ”Muéstrame la guía de onboarding de Txell” |
| Holded ERP | facturas, contactos, productos, CRM, tesorería | ”Crea factura para Demo Corp, 299€ + IVA” |
Cómo conectar: Guía del Connector
6.3 Cómo funciona Claude Code (Edu, Dani)
- Al iniciar sesión, Claude lee automáticamente
CLAUDE.md+ documentos enlazados - Tiene acceso SSH a producción y staging para diagnósticos
- Sigue 13 reglas de oro (idioma, docs, git, modularización, etc.)
- Tiene memorias persistentes por desarrollador
- Connector MCP disponible via
.mcp.jsonpara interactuar con el workspace - Al final de sesión: actualiza RELEASE_NOTES, WORKLOG, y hace backup de memorias
6.4 Cómo funciona Claude para Txell
Opción principal: claude.ai (web) con Custom Connector → gestionar todo con lenguaje natural
Opción local: Claude Code en C:\dev\CreaRackSL-workspace → crear documentos, contratos, facturas
Guía completa: Onboarding Txell
6.4 Agentes IA disponibles (15)
| Área | Agentes | Uso |
|---|---|---|
| Negocio | admin-billing, legal-rgpd, legal-contracts, marketing-content, sales-outbound | Txell |
| Desarrollo | dev-backend, dev-frontend, dev-devops, dev-qa, dev-vision | Edu, Dani |
| Soporte | support-l1, support-l2, sales-demo | Rotatorio |
6.5 Memorias de Claude (per-dev, no compartidas)
Cada instancia de Claude Code tiene memorias propias:
- user_*: Perfil del desarrollador
- feedback_*: Directivas de trabajo aprendidas
- footguns_*: Errores técnicos a evitar
- infra_*: Configuraciones de infraestructura
- project_*: Estado de proyectos activos
Las memorias NO están en git. Se hace backup con claude-backup.ps1 al final de sesiones significativas.
7. Reglas de Oro (resumen)
Las 12 reglas que Claude sigue automáticamente:
| # | Regla | Para qué |
|---|---|---|
| 1 | Idioma español | Toda comunicación en español |
| 2 | No duplicar código | Reutilizar servicios existentes |
| 3 | Docs incrementales | Mantener documentación al día |
| 4 | GitHub consensuado | No push sin aprobación del dev |
| 5 | Modularización | Archivos pequeños y enfocados |
| 6 | Confirmación de planes | No ejecutar sin aprobación |
| 7 | Botones solo texto | Sin iconos en botones (UI) |
| 8 | Auto-Plan AI fijo | Gemini 3 Flash, no cambiar |
| 9 | Dependencias seguras | Verificar licencia antes de instalar |
| 10 | Subagentes Opus | Opus para tareas complejas, Sonnet para lectura |
| 11 | Release Notes | Registrar cada cambio funcional con autor |
| 12 | Worklog | Registrar actividad diaria del equipo |
8. Cuentas de Servicio
| Servicio | Propósito | Gestión |
|---|---|---|
| Hetzner Cloud | Servidores, firewall, snapshots, Object Storage | Panel web |
| GitHub (CreaRackSL) | Código, CI/CD, webhooks | github.com |
| Dokploy | Deploy automático, reverse proxy | Puerto 3000 |
| Cloudflare | DNS, CDN, SSL | Panel web |
| UptimeRobot | Monitorización uptime | Panel web |
| Resend | Email transaccional | API key en Dokploy |
| Google AI | Gemini (Auto-Plan, CNS) | API key |
| Anthropic | Claude (CNS alternativo) | API key |
| Holded | ERP: facturación, contabilidad, CRM | API key en Cloudflare Pages |
| Workspace MCP | Connector Claude ↔ Workspace (43 tools) | Tokens por usuario en Cloudflare Pages |
Credenciales y accesos documentados en las memorias de Claude (acceso restringido per-dev).
9. Qué hacer si…
| Situación | Acción |
|---|---|
| Recibo alerta de UptimeRobot | Verificar ssh root@crearack.com "docker ps" — si todos los contenedores están healthy, fue transitorio |
| Quiero ver qué hizo Dani ayer | Consultar WORKLOG.md en CreaRackSL-workspace |
| Quiero ver qué funcionalidades tiene la app | Consultar Documentation/FEATURE_CATALOG.md |
| Quiero ver los cambios recientes del producto | Consultar RELEASE_NOTES.md |
| Necesito restaurar la app desde cero | Seguir Documentation/guides/DISASTER_RECOVERY.md (8 pasos) |
| Quiero probar algo sin riesgo | Usar el staging server (178.104.131.173:8000) |
| Dani pregunta sobre seguridad | Dirigir a Documentation/guides/SECURITY_GUIDE.md |
| Dani pregunta sobre la BD | Dirigir a Documentation/guides/DATABASE_ADMIN_GUIDE.md |
| Quiero gestionar tareas desde Claude | Conectar Custom Connector → Guía |
| Quiero crear una factura desde Claude | Usar connector: “Crea factura para X por Y€ + IVA” |
| Quiero ver el estado de todo rápido | Usar connector: “Dame el dashboard completo” |
| El connector no funciona | Desconectar y reconectar. Activar TODAS las herramientas |
Mantenido por: Equipo CreaRack