7c843494ce
- 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>
160 lines
4.2 KiB
Markdown
160 lines
4.2 KiB
Markdown
# 🤖 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.
|