Procesos y Sistemas Automáticos — CreaRack Pro

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

RepoURLContenidoQuién lo usa
CreaRack-Progithub.com/CreaRackSL/CreaRack-ProCódigo fuente de la aplicaciónEdu + Dani
CreaRackSL-workspacegithub.com/CreaRackSL/CreaRackSL-workspaceContexto IA, procesos, documentación equipoEdu + Dani + Txell

3. Sistemas Automáticos en Producción

3.1 Backups (3 niveles)

SistemaFrecuenciaQué haceRetención
pg_dumpDiario 3:00 AMBackup completo de la base de datos14 días local, 30 días offsite
WAL archivingCada 15 minSync incremental para recuperación precisaEn Object Storage
pg_basebackupDomingo 4:00 AMBackup físico completo de PostgreSQLEn Object Storage
Hetzner snapshotsSemanal (auto)Imagen completa del servidor3 snapshots
Backup per-tenantDiario 3:30 AMZIP 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

SistemaQué monitorizaFrecuenciaAlertas
UptimeRobotcrearack.com/health (web + DB + cache)Cada 5 minEmail a edudomo@gmail.com
Sentinel ModeDispositivos de red del cliente (SNMP/ping)15s-5minCNS insights + ITSM
PrometheusMétricas internas Django (/metrics)Continuo

3.3 CI/CD

EventoQué pasa
Push a mainGitHub Actions ejecuta tests + linting
Push a main (sin [skip ci])Dokploy recibe webhook → build → deploy automático
Push con [skip ci] en mensajeCI se salta, Dokploy también salta el deploy

3.4 Tareas Automáticas (Huey)

TareaHoraQué hace
Backup per-tenant3:30 AMZIP de datos por organización
Purge orgs eliminadas4:00 AMElimina orgs soft-deleted >90 días
Integrity check4:30 AMDetecta anomalías cross-tenant
Métricas agregaciónPeriódicaAgrega samples horarios
Transcoding vídeoOn-demandH.264/H.265 para Digital Signage
Proof-of-playPeriódicaRecolecta datos de reproducción

3.5 Firewall

CapaGestiónQué protege
Hetzner Cloud FirewallPanel web HetznerPuertos SSH, HTTP, HTTPS
iptables DOCKER-USERScript en servidorDokploy port 3000, GitHub webhooks
Django middlewareCódigoRate limiting, CSP, admin IP restriction
RLS (PostgreSQL)Base de datosAislamiento de datos entre organizaciones

4. Servidores

ServidorIPTipoRolCoste
Producción116.203.31.166CCX (4 vCPU, 16GB)App en producción~€30/mes
Staging178.104.131.173CX23 (1 vCPU, 4GB)Testing/staging~€4.5/mes
Object Storagenbg1S3-compatibleBackups 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

DocumentoRepoCuándoQuién
RELEASE_NOTES.mdCreaRack-ProCada commit funcionalClaude del dev que trabaja
CHANGELOG.mdCreaRack-ProCada feature/fix técnicoClaude del dev que trabaja
WORKLOG.mdWorkspaceFinal de cada sesión significativaClaude del dev que trabaja

5.2 Documentos de referencia (se actualizan cuando cambia algo)

DocumentoRepoPropósito
FEATURE_CATALOG.mdCreaRack-ProInventario completo de funcionalidades (punto cero 07-04-2026)
Documentation/INDEX.mdCreaRack-ProÍndice de 60+ documentos técnicos
AI_WORKFLOW.mdWorkspaceCómo funciona la infraestructura de Claude
Este documentoWorkspaceSistemas automáticos y procesos del equipo

5.3 Convención de commits

Tipo de cambioPushNota
Código (bug fix, feature)InmediatoDispara CI + auto-deploy
Solo documentaciónDiferido o con [skip ci]No dispara deploy
Mixto (código + docs)InmediatoDispara CI + deploy

6. Trabajo con Claude

6.1 Herramientas por persona

PersonaRolHerramientasModelo recomendado
TxellCEO · CFOclaude.ai + Cowork DesktopHaiku (workspace), Sonnet (redacción)
DaniCTO · DevClaude Code + claude.aiOpus (código), Haiku (workspace)
EduCOO · DevClaude Code + claude.ai + CoworkOpus (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íaHerramientasEjemplo
Tareascrear, listar, editar, eliminar”Crea tarea para Dani: revisar PRs, alta prioridad”
Noticias/Alertas/NotasCRUD completo”Publica noticia: reunión mañana a las 10”
Servidoresstatus, uptime, métricas, dashboard”¿Cómo están los servidores?”
GitHubPRs, issues, actividad”¿Hay PRs abiertos?”
Documentaciónleer guías, worklog”Muéstrame la guía de onboarding de Txell”
Holded ERPfacturas, 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)

  1. Al iniciar sesión, Claude lee automáticamente CLAUDE.md + documentos enlazados
  2. Tiene acceso SSH a producción y staging para diagnósticos
  3. Sigue 13 reglas de oro (idioma, docs, git, modularización, etc.)
  4. Tiene memorias persistentes por desarrollador
  5. Connector MCP disponible via .mcp.json para interactuar con el workspace
  6. 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)

ÁreaAgentesUso
Negocioadmin-billing, legal-rgpd, legal-contracts, marketing-content, sales-outboundTxell
Desarrollodev-backend, dev-frontend, dev-devops, dev-qa, dev-visionEdu, Dani
Soportesupport-l1, support-l2, sales-demoRotatorio

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:

#ReglaPara qué
1Idioma españolToda comunicación en español
2No duplicar códigoReutilizar servicios existentes
3Docs incrementalesMantener documentación al día
4GitHub consensuadoNo push sin aprobación del dev
5ModularizaciónArchivos pequeños y enfocados
6Confirmación de planesNo ejecutar sin aprobación
7Botones solo textoSin iconos en botones (UI)
8Auto-Plan AI fijoGemini 3 Flash, no cambiar
9Dependencias segurasVerificar licencia antes de instalar
10Subagentes OpusOpus para tareas complejas, Sonnet para lectura
11Release NotesRegistrar cada cambio funcional con autor
12WorklogRegistrar actividad diaria del equipo

8. Cuentas de Servicio

ServicioPropósitoGestión
Hetzner CloudServidores, firewall, snapshots, Object StoragePanel web
GitHub (CreaRackSL)Código, CI/CD, webhooksgithub.com
DokployDeploy automático, reverse proxyPuerto 3000
CloudflareDNS, CDN, SSLPanel web
UptimeRobotMonitorización uptimePanel web
ResendEmail transaccionalAPI key en Dokploy
Google AIGemini (Auto-Plan, CNS)API key
AnthropicClaude (CNS alternativo)API key
HoldedERP: facturación, contabilidad, CRMAPI key en Cloudflare Pages
Workspace MCPConnector 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ónAcción
Recibo alerta de UptimeRobotVerificar ssh root@crearack.com "docker ps" — si todos los contenedores están healthy, fue transitorio
Quiero ver qué hizo Dani ayerConsultar WORKLOG.md en CreaRackSL-workspace
Quiero ver qué funcionalidades tiene la appConsultar Documentation/FEATURE_CATALOG.md
Quiero ver los cambios recientes del productoConsultar RELEASE_NOTES.md
Necesito restaurar la app desde ceroSeguir Documentation/guides/DISASTER_RECOVERY.md (8 pasos)
Quiero probar algo sin riesgoUsar el staging server (178.104.131.173:8000)
Dani pregunta sobre seguridadDirigir a Documentation/guides/SECURITY_GUIDE.md
Dani pregunta sobre la BDDirigir a Documentation/guides/DATABASE_ADMIN_GUIDE.md
Quiero gestionar tareas desde ClaudeConectar Custom Connector → Guía
Quiero crear una factura desde ClaudeUsar connector: “Crea factura para X por Y€ + IVA”
Quiero ver el estado de todo rápidoUsar connector: “Dame el dashboard completo”
El connector no funcionaDesconectar y reconectar. Activar TODAS las herramientas

Mantenido por: Equipo CreaRack