Streamline README: concise and direct
- Removed detailed explanations, just references - Cleaner table format - 160 lines vs 244 (35% shorter) Co-Authored-By: Claude Sonnet 4.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Hector Ros
319
README.md
319
README.md
@@ -1,248 +1,159 @@
|
|||||||
# 🤖 AiWorker - AI Agent Orchestration Platform
|
# 🤖 AiWorker
|
||||||
|
|
||||||
Sistema de orquestación de agentes IA (Claude Code) para automatización del ciclo completo de desarrollo de software.
|
AI Agent Orchestration Platform - Automatización del ciclo completo de desarrollo con agentes Claude Code.
|
||||||
|
|
||||||
**Estado**: 🚧 En desarrollo - Infraestructura completa ✅
|
**Estado**: Infraestructura HA completa ✅ | Backend en desarrollo 🚧
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🎯 ¿Qué es AiWorker?
|
## 🚀 Quick Start
|
||||||
|
|
||||||
Plataforma que permite a agentes IA (Claude Code) trabajar autónomamente en tareas de desarrollo:
|
|
||||||
|
|
||||||
1. **Dashboard Web** - Kanban board para gestionar tareas
|
|
||||||
2. **Agentes Autónomos** - Claude Code en pods de Kubernetes
|
|
||||||
3. **Comunicación MCP** - Agentes piden/dan información
|
|
||||||
4. **Deployments Automáticos** - Preview, staging, production
|
|
||||||
5. **GitOps** - Todo versionado en Git
|
|
||||||
|
|
||||||
**Flujo completo**:
|
|
||||||
```
|
|
||||||
Tarea → Agente → Código → PR → Preview Deploy → Aprobación → Staging → Production
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📚 DOCUMENTACIÓN
|
|
||||||
|
|
||||||
### 🚀 Start Here
|
|
||||||
- **[ROADMAP.md](ROADMAP.md)** - Plan general y progreso
|
|
||||||
- **[NEXT-SESSION.md](NEXT-SESSION.md)** - Próximos pasos detallados
|
|
||||||
- **[DEVELOPMENT-WORKFLOW.md](DEVELOPMENT-WORKFLOW.md)** - Cómo trabajamos (Git, CI/CD, Deploy)
|
|
||||||
- **[QUICK-REFERENCE.md](QUICK-REFERENCE.md)** - Comandos y URLs importantes
|
|
||||||
- **[GITEA-GUIDE.md](GITEA-GUIDE.md)** - Guía completa de Gitea (API, Registry, CI/CD)
|
|
||||||
|
|
||||||
### 🏗️ Infraestructura
|
|
||||||
- **[K8S-CLUSTER.md](K8S-CLUSTER.md)** - Estado del cluster K8s
|
|
||||||
- **[CLUSTER-CREDENTIALS.md](CLUSTER-CREDENTIALS.md)** - Credenciales (⚠️ sensible)
|
|
||||||
- **[AGENT-GUIDE.md](AGENT-GUIDE.md)** - Guía para agentes IA
|
|
||||||
- **[TROUBLESHOOTING.md](TROUBLESHOOTING.md)** - Solución de problemas
|
|
||||||
|
|
||||||
### 📜 Historial
|
|
||||||
- **[past-sessions/](past-sessions/)** - Documentación de cada sesión de desarrollo
|
|
||||||
|
|
||||||
### 📖 Documentación Completa
|
|
||||||
- **[docs/](docs/)** - 40+ archivos de documentación detallada
|
|
||||||
- `01-arquitectura/` - Diseño del sistema
|
|
||||||
- `02-backend/` - Backend (Bun + Express + MCP)
|
|
||||||
- `03-frontend/` - Frontend (React 19.2 + TailwindCSS)
|
|
||||||
- `04-kubernetes/` - Kubernetes setup
|
|
||||||
- `05-agents/` - Claude Code agents
|
|
||||||
- `06-deployment/` - CI/CD y GitOps
|
|
||||||
- `CONTAINER-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
|
|
||||||
```bash
|
```bash
|
||||||
|
# Acceso al cluster
|
||||||
export KUBECONFIG=~/.kube/aiworker-config
|
export KUBECONFIG=~/.kube/aiworker-config
|
||||||
kubectl get nodes
|
kubectl get nodes
|
||||||
kubectl get pods -A
|
|
||||||
```
|
|
||||||
|
|
||||||
### Desarrollo Local (Backend)
|
# Desarrollo backend
|
||||||
```bash
|
cd backend && bun run dev
|
||||||
cd backend
|
|
||||||
|
|
||||||
# Port-forward services
|
# Verificar servicios
|
||||||
kubectl port-forward -n control-plane svc/mariadb 3306:3306 &
|
kubectl get pods -n control-plane
|
||||||
kubectl port-forward -n control-plane svc/redis 6379:6379 &
|
|
||||||
|
|
||||||
# Run dev server
|
# Ver CI/CD
|
||||||
bun run dev
|
|
||||||
|
|
||||||
# Test
|
|
||||||
curl http://localhost:3000/api/health
|
|
||||||
```
|
|
||||||
|
|
||||||
### Ver Actions CI/CD
|
|
||||||
```bash
|
|
||||||
open https://git.fuq.tv/admin/aiworker-backend/actions
|
open https://git.fuq.tv/admin/aiworker-backend/actions
|
||||||
```
|
```
|
||||||
|
|
||||||
### Deploy en K8s (cuando esté listo)
|
---
|
||||||
```bash
|
|
||||||
kubectl apply -f k8s/backend/
|
## 📚 Documentación
|
||||||
kubectl get pods -n control-plane
|
|
||||||
|
### 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
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🏗️ ARQUITECTURA
|
## 💻 Stack
|
||||||
|
|
||||||
```
|
| Layer | Tech | Versión |
|
||||||
Internet
|
|-------|------|---------|
|
||||||
↓
|
| Runtime | Bun | 1.3.6 |
|
||||||
[DNS: *.fuq.tv]
|
| Backend | Bun.serve() + Drizzle | - |
|
||||||
↓
|
| Frontend | React + TailwindCSS | 19.2 + 4.x |
|
||||||
┌────────────┴────────────┐
|
| Database | MariaDB | 11.4 LTS |
|
||||||
↓ ↓
|
| Cache | Redis | 7 |
|
||||||
[LB-01] [LB-02]
|
| Git/Registry | Gitea | 1.25.3 |
|
||||||
HAProxy HAProxy
|
| 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 |
|
||||||
[Private Network 10.100.0.0/24]
|
| CI/CD | Gitea Actions | Activo |
|
||||||
↓
|
|
||||||
┌───────────────┼───────────────┐
|
|
||||||
↓ ↓ ↓
|
|
||||||
[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
|
## ✅ Completado
|
||||||
|
|
||||||
| Layer | Tecnología | Versión |
|
**Infraestructura**:
|
||||||
|-------|-----------|---------|
|
- Cluster K8s HA (8 servidores, $148/mes)
|
||||||
| **Runtime** | Bun | 1.3.6 |
|
- Storage distribuido Longhorn (3 réplicas)
|
||||||
| **Backend** | Bun.serve() + Drizzle | - |
|
- TLS automático (Let's Encrypt)
|
||||||
| **Frontend** | React + TailwindCSS | 19.2 + 4.x |
|
- DNS: *.fuq.tv con round-robin HA
|
||||||
| **Database** | MariaDB | 11.4 LTS |
|
|
||||||
| **Cache** | Redis | 7 |
|
**Plataforma**:
|
||||||
| **Git** | Gitea | 1.25.3 |
|
- MariaDB 11.4 LTS + Redis 7
|
||||||
| **Registry** | Gitea Container Registry | - |
|
- Gitea 1.25.3 + Container Registry
|
||||||
| **K8s** | K3s | v1.35.0+k3s1 |
|
- Gitea Actions Runner (CI/CD)
|
||||||
| **Storage** | Longhorn | v1.8.0 |
|
- ArgoCD (pendiente config)
|
||||||
| **Ingress** | Nginx | latest |
|
|
||||||
| **TLS** | Cert-Manager | v1.16.2 |
|
**Backend** (20%):
|
||||||
| **GitOps** | ArgoCD | stable |
|
- Estructura + Bun 1.3.6
|
||||||
| **CI/CD** | Gitea Actions | - |
|
- Database schema (projects, agents, tasks)
|
||||||
|
- Auto-migrations
|
||||||
|
- Dockerfile + CI/CD workflow
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🎓 LEARN BY DOING - Sesiones
|
## 🚧 En Desarrollo
|
||||||
|
|
||||||
### Sesión 1 (2026-01-19) - Infraestructura ✅
|
- [ ] Backend API routes
|
||||||
- Desplegar cluster K3s HA en CubePath
|
- [ ] MCP Server
|
||||||
- Configurar storage, networking, ingress
|
- [ ] Frontend React 19.2
|
||||||
- Instalar Gitea, MariaDB, Redis
|
- [ ] Agentes Claude Code
|
||||||
- Setup CI/CD con Gitea Actions
|
- [ ] Preview environments
|
||||||
- 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
|
**Ver**: `NEXT-SESSION.md` para pasos exactos
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 📞 SOPORTE
|
## 🌐 URLs
|
||||||
|
|
||||||
- **Issues**: Documentadas en `TROUBLESHOOTING.md`
|
| Servicio | URL | Credenciales |
|
||||||
- **CubePath**: https://cubepath.com/support
|
|----------|-----|--------------|
|
||||||
- **K3s Docs**: https://docs.k3s.io
|
| Gitea | https://git.fuq.tv | admin/admin123 |
|
||||||
- **Bun Docs**: https://bun.sh/docs
|
| 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`
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🤝 CONTRIBUCIÓN
|
## 📖 Aprende Más
|
||||||
|
|
||||||
Este es un proyecto en desarrollo activo. La documentación se actualiza en cada sesión.
|
- **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
|
||||||
|
|
||||||
**Estructura de commits**:
|
|
||||||
```
|
```
|
||||||
Title line (imperativo)
|
Infraestructura: ████████████████████ 100%
|
||||||
|
Backend: ████░░░░░░░░░░░░░░░░ 20%
|
||||||
Detailed description
|
Frontend: ░░░░░░░░░░░░░░░░░░░░ 0%
|
||||||
|
Agentes: ░░░░░░░░░░░░░░░░░░░░ 0%
|
||||||
Co-Authored-By: Claude Sonnet 4.5 (1M context) <noreply@anthropic.com>
|
Total: ██████░░░░░░░░░░░░░░ 26%
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 📜 LICENSE
|
**Siguiente paso**: Lee `NEXT-SESSION.md` y continúa donde lo dejaste.
|
||||||
|
|
||||||
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.
|
|
||||||
|
|||||||
Reference in New Issue
Block a user