fcaac6aa3e
- Add complete session documentation in past-sessions/ - Update NEXT-SESSION.md with Frontend + Agents roadmap - Add K8s manifests for backend deployment - Update README with past-sessions reference Session achievements: - Implemented complete REST API (projects, tasks, agents) - Implemented MCP Server with 4 core tools - Integrated Gitea API client - Successfully deployed backend to K8s at api.fuq.tv - Fixed MariaDB permissions and secrets - CI/CD pipeline working (build #7 successful) Co-Authored-By: Claude Sonnet 4.5 (1M context) <noreply@anthropic.com>
6.9 KiB
6.9 KiB
🤖 AiWorker - AI Agent Orchestration Platform
Sistema de orquestación de agentes IA (Claude Code) para automatización del ciclo completo de desarrollo de software.
Estado: 🚧 En desarrollo - Infraestructura completa ✅
🎯 ¿Qué es AiWorker?
Plataforma que permite a agentes IA (Claude Code) trabajar autónomamente en tareas de desarrollo:
- Dashboard Web - Kanban board para gestionar tareas
- Agentes Autónomos - Claude Code en pods de Kubernetes
- Comunicación MCP - Agentes piden/dan información
- Deployments Automáticos - Preview, staging, production
- GitOps - Todo versionado en Git
Flujo completo:
Tarea → Agente → Código → PR → Preview Deploy → Aprobación → Staging → Production
📚 DOCUMENTACIÓN
🚀 Start Here
- ROADMAP.md - Plan general y progreso
- NEXT-SESSION.md - Próximos pasos detallados
- DEVELOPMENT-WORKFLOW.md - Cómo trabajamos (Git, CI/CD, Deploy)
- QUICK-REFERENCE.md - Comandos y URLs importantes
- GITEA-GUIDE.md - Guía completa de Gitea (API, Registry, CI/CD)
🏗️ Infraestructura
- K8S-CLUSTER.md - Estado del cluster K8s
- CLUSTER-CREDENTIALS.md - Credenciales (⚠️ sensible)
- AGENT-GUIDE.md - Guía para agentes IA
- TROUBLESHOOTING.md - Solución de problemas
📜 Historial
- past-sessions/ - Documentación de cada sesión de desarrollo
📖 Documentación Completa
- docs/ - 40+ archivos de documentación detallada
01-arquitectura/- Diseño del sistema02-backend/- Backend (Bun + Express + MCP)03-frontend/- Frontend (React 19.2 + TailwindCSS)04-kubernetes/- Kubernetes setup05-agents/- Claude Code agents06-deployment/- CI/CD y GitOpsCONTAINER-REGISTRY.md- Uso del registry
✅ COMPLETADO
Infraestructura Kubernetes HA
- ✅ Cluster K3s v1.35.0+k3s1 (Houston, Texas)
- ✅ 3 Control Planes + 3 Workers + 2 Load Balancers
- ✅ Longhorn Storage HA (3 réplicas)
- ✅ Nginx Ingress + Cert-Manager (TLS automático)
- ✅ Red privada con HAProxy
- ✅ DNS: *.fuq.tv (round-robin HA)
Servicios Base
- ✅ MariaDB 11.4 LTS
- ✅ Redis 7
- ✅ Gitea 1.25.3 + Container Registry
- ✅ ArgoCD (instalado, pendiente configuración)
- ✅ Gitea Actions Runner (CI/CD activo)
Backend Inicial
- ✅ Estructura del proyecto
- ✅ Bun 1.3.6 con Bun.serve()
- ✅ Database schema (Drizzle ORM)
- ✅ Dockerfile
- ✅ Workflow CI/CD
Costo: $148/mes | Capacidad: 48 vCPU, 104 GB RAM
🚧 EN DESARROLLO
- Backend API routes completas
- MCP Server para agentes
- Frontend React 19.2
- Pods de agentes Claude Code
- Preview environments automáticos
⚡ QUICK START
Acceder al Cluster
export KUBECONFIG=~/.kube/aiworker-config
kubectl get nodes
kubectl get pods -A
Desarrollo Local (Backend)
cd backend
# Port-forward services
kubectl port-forward -n control-plane svc/mariadb 3306:3306 &
kubectl port-forward -n control-plane svc/redis 6379:6379 &
# Run dev server
bun run dev
# Test
curl http://localhost:3000/api/health
Ver Actions CI/CD
open https://git.fuq.tv/admin/aiworker-backend/actions
Deploy en K8s (cuando esté listo)
kubectl apply -f k8s/backend/
kubectl get pods -n control-plane
🏗️ ARQUITECTURA
Internet
↓
[DNS: *.fuq.tv]
↓
┌────────────┴────────────┐
↓ ↓
[LB-01] [LB-02]
HAProxy HAProxy
↓ ↓
└────────────┬────────────┘
↓
[Private Network 10.100.0.0/24]
↓
┌───────────────┼───────────────┐
↓ ↓ ↓
[CP etcd] [CP etcd] [CP etcd]
10.100.0.2 10.100.0.3 10.100.0.4
↓ ↓ ↓
─────┴───────────────┴───────────────┴─────
↓ ↓ ↓
[Worker+Storage] [Worker+Storage] [Worker+Storage]
10.100.0.5 10.100.0.6 10.100.0.7
↓ ↓ ↓
[Apps] [Apps] [Apps]
│ │ │
[Longhorn 3x Replica Storage HA]
📦 STACK TECNOLÓGICO
| Layer | Tecnología | 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 | Gitea | 1.25.3 |
| Registry | Gitea Container Registry | - |
| K8s | K3s | v1.35.0+k3s1 |
| Storage | Longhorn | v1.8.0 |
| Ingress | Nginx | latest |
| TLS | Cert-Manager | v1.16.2 |
| GitOps | ArgoCD | stable |
| CI/CD | Gitea Actions | - |
🎓 LEARN BY DOING - Sesiones
Sesión 1 (2026-01-19) - Infraestructura ✅
- Desplegar cluster K3s HA en CubePath
- Configurar storage, networking, ingress
- Instalar Gitea, MariaDB, Redis
- Setup CI/CD con Gitea Actions
- Inicializar backend
Ver: K8S-CLUSTER.md para detalles completos
Sesión 2 (Próxima) - Backend API
- Completar API routes
- Implementar MCP Server
- Integración con Gitea y K8s
- Deploy backend en cluster
Ver: NEXT-SESSION.md para pasos exactos
📞 SOPORTE
- Issues: Documentadas en
TROUBLESHOOTING.md - CubePath: https://cubepath.com/support
- K3s Docs: https://docs.k3s.io
- Bun Docs: https://bun.sh/docs
🤝 CONTRIBUCIÓN
Este es un proyecto en desarrollo activo. La documentación se actualiza en cada sesión.
Estructura de commits:
Title line (imperativo)
Detailed description
Co-Authored-By: Claude Sonnet 4.5 (1M context) <noreply@anthropic.com>
📜 LICENSE
Proyecto privado - AiWorker Platform
🎉 HIGHLIGHTS
- Alta Disponibilidad: 3 réplicas de todo (storage, control planes)
- TLS Automático: Let's Encrypt con Cert-Manager
- CI/CD Integrado: Build automático en cada push
- GitOps Ready: ArgoCD configurado
- Escalable: 48 vCPU, 104 GB RAM disponibles
- Moderno: Últimas versiones de todo (K3s, Bun, React 19.2)
🚀 ¡Proyecto con bases sólidas! Listo para construir features increíbles!
Siguiente paso: Abre NEXT-SESSION.md y continúa donde lo dejaste.