144 lines
2.8 KiB
Markdown
144 lines
2.8 KiB
Markdown
# 🔄 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.**
|