gkachele-saas/memoria/GITEA_WORKFLOWS.md

🔄 Gitea y Workflows - GKACHELE™

© 2025 GKACHELE™. Todos los derechos reservados.

🎯 OBJETIVO

Integrar Gitea para automatizar despliegues, workflows y gestión de repositorios por cliente.

---

📋 FUNCIONALIDADES PLANEADAS

1. Repositorios por Cliente

• Crear repo automático al registrar cliente
• Un repo por sitio del cliente
• Versionado automático de cambios
• Historial completo

2. Workflows Automáticos

Workflow: Aceptar Petición

Cliente envía sitio → Admin aprueba → Workflow Gitea:
1. Commit cambios al repo del cliente
2. Generar build del sitio
3. Desplegar automáticamente
4. Notificar al cliente

Workflow: Despliegue Automático

Cambios en customizer → Auto-commit → Auto-deploy

Workflow: Rollback

Admin selecciona versión → Workflow restaura versión anterior

3. Integración con Dashboard Admin

• Ver repositorios de clientes
• Aceptar/rechazar peticiones desde workflows
• Ver historial de cambios
• Gestionar despliegues
• Control de versiones

---

🏗️ ARQUITECTURA

Componentes:

1. Gitea Server - Gestión de repositorios
2. API Gitea - Integración con Flask
3. Workflows - Automatización
4. Dashboard Admin - Interfaz de gestión

Flujo:

Cliente → Customizer → Cambios → Gitea API → Commit → Workflow → Deploy
Admin → Dashboard → Aprobar → Gitea API → Workflow → Deploy

---

🔧 IMPLEMENTACIÓN

1. Instalación Gitea

• En Raspberry Pi o VPS
• Configurar dominio
• API habilitada

2. Integración Flask

• Cliente Gitea API
• Funciones helper para repos
• Workflows automáticos

3. Dashboard Admin

• Sección Gitea
• Ver repositorios
• Gestionar workflows
• Control de versiones

---

📝 WORKFLOWS ESPECÍFICOS

Workflow: Nuevo Cliente

1. Cliente se registra
2. Crear repo automático: cliente-{user_id}
3. Commit template inicial
4. Configurar webhook

Workflow: Aprobar Sitio

1. Admin aprueba desde dashboard
2. Workflow Gitea se activa
3. Commit cambios finales
4. Build del sitio
5. Deploy a producción
6. Notificar cliente

Workflow: Cambios en Customizer

1. Cliente guarda cambios
2. Auto-commit a repo
3. Workflow opcional: preview automático

---

🎯 BENEFICIOS

• ✅ Versionado automático
• ✅ Historial completo
• ✅ Rollback fácil
• ✅ Despliegues automáticos
• ✅ Repositorios organizados
• ✅ Integración completa

---

📋 CHECKLIST

• Instalar Gitea
• Configurar API
• Integrar con Flask
• Crear repos automáticos
• Workflow: Aprobar petición
• Workflow: Despliegue automático
• Dashboard admin: Sección Gitea
• Testing completo

---

Última actualización: 14 Enero 2025
Hash: gkachele-gitea-workflows-20250114

---

© 2025 GKACHELE™. Todos los derechos reservados.