# 🤖 AiWorker

AI Agent Orchestration Platform - Automatización del ciclo completo de desarrollo con agentes Claude Code.

**Estado**: Infraestructura HA completa ✅ | Backend en desarrollo 🚧

---

## 🚀 Quick Start

```bash
# Acceso al cluster
export KUBECONFIG=~/.kube/aiworker-config
kubectl get nodes

# Desarrollo backend
cd backend && bun run dev

# Verificar servicios
kubectl get pods -n control-plane

# Ver CI/CD
open https://git.fuq.tv/admin/aiworker-backend/actions
```

---

## 📚 Documentación

### Esenciales (Start Here)
| Documento | Descripción |
|-----------|-------------|
| **[DEVELOPMENT-WORKFLOW.md](DEVELOPMENT-WORKFLOW.md)** | Flujo completo: Git → Build → Deploy |
| **[GITEA-GUIDE.md](GITEA-GUIDE.md)** | API, Registry, Auth, CI/CD |
| **[K8S-CLUSTER.md](K8S-CLUSTER.md)** | Cluster info, IPs, componentes |
| **[NEXT-SESSION.md](NEXT-SESSION.md)** | Próximos pasos (actualizado cada sesión) |
| **[QUICK-REFERENCE.md](QUICK-REFERENCE.md)** | Comandos y URLs de 1 línea |

### Operacional
| Documento | Descripción |
|-----------|-------------|
| **[ROADMAP.md](ROADMAP.md)** | Plan general y progreso (26%) |
| **[TROUBLESHOOTING.md](TROUBLESHOOTING.md)** | Solución de problemas |
| **[AGENT-GUIDE.md](AGENT-GUIDE.md)** | Para agentes IA operar el cluster |
| **[CLAUDE.md](CLAUDE.md)** | Para Claude Code entender el repo |

### Detallada
- **[docs/](docs/)** - 40+ archivos técnicos organizados
- **[past-sessions/](past-sessions/)** - Historial de desarrollo por sesión

---

## 🏗️ Arquitectura

```
Internet → DNS (*.fuq.tv) → Load Balancers → Nginx Ingress → Pods
                                ↓
                    K8s Cluster (Houston)
                    3 CP + 3 Workers + Storage HA
                                ↓
                    MariaDB + Redis + Gitea
```

**Flujo de trabajo**:
```
Tarea → Agente Claude → Código → PR → Preview → Aprobación → Staging → Production
```

---

## 💻 Stack

| Layer | Tech | Versión |
|-------|------|---------|
| Runtime | Bun | 1.3.6 |
| Backend | Bun.serve() + Drizzle | - |
| Frontend | React + TailwindCSS | 19.2 + 4.x |
| Database | MariaDB | 11.4 LTS |
| Cache | Redis | 7 |
| Git/Registry | Gitea | 1.25.3 |
| K8s | K3s | v1.35.0+k3s1 |
| Storage | Longhorn | v1.8.0 (3 réplicas HA) |
| Ingress | Nginx + Cert-Manager | TLS automático |
| GitOps | ArgoCD | Instalado, no configurado |
| CI/CD | Gitea Actions | Activo |

---

## ✅ Completado

**Infraestructura**:
- Cluster K8s HA (8 servidores, $148/mes)
- Storage distribuido Longhorn (3 réplicas)
- TLS automático (Let's Encrypt)
- DNS: *.fuq.tv con round-robin HA

**Plataforma**:
- MariaDB 11.4 LTS + Redis 7
- Gitea 1.25.3 + Container Registry
- Gitea Actions Runner (CI/CD)
- ArgoCD (pendiente config)

**Backend** (20%):
- Estructura + Bun 1.3.6
- Database schema (projects, agents, tasks)
- Auto-migrations
- Dockerfile + CI/CD workflow

---

## 🚧 En Desarrollo

- [ ] Backend API routes
- [ ] MCP Server
- [ ] Frontend React 19.2
- [ ] Agentes Claude Code
- [ ] Preview environments

**Ver**: `NEXT-SESSION.md` para pasos exactos

---

## 🌐 URLs

| Servicio | URL | Credenciales |
|----------|-----|--------------|
| Gitea | https://git.fuq.tv | admin/admin123 |
| ArgoCD | https://argocd.fuq.tv | admin/LyPF4Hy0wvp52IoU |
| Longhorn | https://longhorn.fuq.tv | admin/aiworker2026 |
| Docs Repo | https://git.fuq.tv/admin/aiworker | - |
| Backend Repo | https://git.fuq.tv/admin/aiworker-backend | - |

**Más info**: `QUICK-REFERENCE.md`

---

## 📖 Aprende Más

- **Workflow de desarrollo**: `DEVELOPMENT-WORKFLOW.md`
- **Uso de Gitea**: `GITEA-GUIDE.md`
- **Cluster K8s**: `K8S-CLUSTER.md`
- **Historial de sesiones**: `past-sessions/`
- **Docs técnicas**: `docs/`

---

## 🎯 Progreso

```
Infraestructura:  ████████████████████ 100%
Backend:          ████░░░░░░░░░░░░░░░░  20%
Frontend:         ░░░░░░░░░░░░░░░░░░░░   0%
Agentes:          ░░░░░░░░░░░░░░░░░░░░   0%
Total:            ██████░░░░░░░░░░░░░░  26%
```

---

**Siguiente paso**: Lee `NEXT-SESSION.md` y continúa donde lo dejaste.