aiworker/README.md

🤖 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

# 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	Flujo completo: Git → Build → Deploy
GITEA-GUIDE.md	API, Registry, Auth, CI/CD
K8S-CLUSTER.md	Cluster info, IPs, componentes
NEXT-SESSION.md	Próximos pasos (actualizado cada sesión)
QUICK-REFERENCE.md	Comandos y URLs de 1 línea

Operacional

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

Detallada

• docs/ - 40+ archivos técnicos organizados
• 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.