From f619c4bf5674e8de8a782f678167679f18af2556 Mon Sep 17 00:00:00 2001 From: Hector Ros Date: Tue, 20 Jan 2026 16:47:17 +0100 Subject: [PATCH] Update QUICK-REFERENCE with current system state - Add app.fuq.tv, api.fuq.tv, claude.fuq.tv URLs - Add all 3 repos (frontend, backend, agent) - Add API endpoints documentation (auth, projects, tasks, agents, mcp) - Add testing section with curl examples - Update project structure (frontend, agents now exist) - Add rollout restart commands - Update quick start session commands Co-Authored-By: Claude Sonnet 4.5 (1M context) --- QUICK-REFERENCE.md | 174 +++++++++++++++++++++++++++++++++++++++------ 1 file changed, 151 insertions(+), 23 deletions(-) diff --git a/QUICK-REFERENCE.md b/QUICK-REFERENCE.md index b08c596..3c6f469 100644 --- a/QUICK-REFERENCE.md +++ b/QUICK-REFERENCE.md @@ -6,16 +6,26 @@ Referencia rΓ‘pida de todo lo importante en un solo lugar. ## 🌐 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 | -| Backend Repo | https://git.fuq.tv/admin/aiworker-backend | - | -| Actions | https://git.fuq.tv/admin/aiworker-backend/actions | - | -| Packages | https://git.fuq.tv/admin/-/packages | - | -| Test App | https://test.fuq.tv | - | -| HAProxy Stats | http://108.165.47.221:8404/stats | admin / aiworker2026 | +| Servicio | URL | Credenciales | Estado | +|----------|-----|--------------|--------| +| **Frontend** | https://app.fuq.tv | - | βœ… Running (2 pods) | +| **Backend API** | https://api.fuq.tv | - | βœ… Running (2 pods) | +| **Terminal Web** | https://claude.fuq.tv | - | βœ… Running (tmux persistente) | +| **Gitea** | https://git.fuq.tv | admin / admin123 | βœ… Running | +| **ArgoCD** | https://argocd.fuq.tv | admin / LyPF4Hy0wvp52IoU | βœ… Running | +| **Longhorn** | https://longhorn.fuq.tv | admin / aiworker2026 | βœ… Running | +| **HAProxy Stats** | http://108.165.47.221:8404/stats | admin / aiworker2026 | βœ… Running | + +### Repositorios Git +| Repo | URL | DescripciΓ³n | +|------|-----|-------------| +| Frontend | https://git.fuq.tv/admin/aiworker-frontend | React + Vite + Tailwind | +| Backend | https://git.fuq.tv/admin/aiworker-backend | Bun + Drizzle + MCP | +| Agent | https://git.fuq.tv/admin/aiworker-agent | Ubuntu 24.04 + Claude Code | +| Actions (frontend) | https://git.fuq.tv/admin/aiworker-frontend/actions | CI/CD | +| Actions (backend) | https://git.fuq.tv/admin/aiworker-backend/actions | CI/CD | +| Actions (agent) | https://git.fuq.tv/admin/aiworker-agent/actions | CI/CD | +| Packages | https://git.fuq.tv/admin/-/packages | Container Registry | --- @@ -339,23 +349,89 @@ dig test.fuq.tv +short --- +## πŸ”Œ API Endpoints + +### Backend API (https://api.fuq.tv) +```bash +# Health +GET /api/health + +# Auth +POST /api/auth/register +POST /api/auth/login +POST /api/auth/logout +GET /api/auth/me + +# Projects (CRUD) +GET /api/projects +GET /api/projects/:id +POST /api/projects +PATCH /api/projects/:id +DELETE /api/projects/:id + +# Tasks (CRUD) +GET /api/tasks +GET /api/tasks/:id +POST /api/tasks +PATCH /api/tasks/:id +DELETE /api/tasks/:id + +# Agents (CRUD) +GET /api/agents +GET /api/agents/:id +POST /api/agents +PATCH /api/agents/:id +DELETE /api/agents/:id + +# MCP Tools (para agentes) +GET /api/mcp/tools +POST /api/mcp/get_next_task +POST /api/mcp/update_task_status +POST /api/mcp/create_branch +POST /api/mcp/create_pull_request +POST /api/mcp/ask_user_question +``` + +--- + ## πŸ“ ESTRUCTURA DEL PROYECTO ``` teamSquadAiWorker/ -β”œβ”€β”€ backend/ # Bun backend +β”œβ”€β”€ backend/ # Bun backend (βœ… Desplegado) β”‚ β”œβ”€β”€ src/ +β”‚ β”‚ β”œβ”€β”€ api/routes/ # Auth, Projects, Tasks, Agents, MCP +β”‚ β”‚ β”œβ”€β”€ db/ # Drizzle schema + migrations +β”‚ β”‚ └── index.ts # Bun.serve() β”‚ β”œβ”€β”€ Dockerfile β”‚ └── .gitea/workflows/ -β”œβ”€β”€ frontend/ # React (por crear) +β”œβ”€β”€ frontend/ # React + Vite (βœ… Desplegado) +β”‚ β”œβ”€β”€ src/ +β”‚ β”‚ β”œβ”€β”€ components/ # UI components +β”‚ β”‚ β”œβ”€β”€ pages/ # Login, Register, Dashboard +β”‚ β”‚ β”œβ”€β”€ api/ # API client +β”‚ β”‚ └── lib/ # Auth context +β”‚ β”œβ”€β”€ Dockerfile +β”‚ └── .gitea/workflows/ +β”œβ”€β”€ agents/ # Claude Code agent (βœ… Desplegado) +β”‚ β”œβ”€β”€ Dockerfile # Ubuntu 24.04 + Node 24 + Bun +β”‚ β”œβ”€β”€ mcp-bridge-server.js +β”‚ β”œβ”€β”€ claude-code-config.json +β”‚ └── AGENT-ACCESS.md +β”œβ”€β”€ k8s/ # Kubernetes manifests (βœ… Aplicados) +β”‚ β”œβ”€β”€ backend/ # Deployment, Service, Ingress +β”‚ β”œβ”€β”€ frontend/ # Deployment, Service, Ingress +β”‚ └── agents/ # Deployment, ServiceAccount β”œβ”€β”€ docs/ # DocumentaciΓ³n completa -β”œβ”€β”€ scripts/ # Scripts de instalaciΓ³n -β”œβ”€β”€ k8s/ # Manifests Kubernetes (por crear) +β”œβ”€β”€ past-sessions/ # Sesiones anteriores +β”‚ β”œβ”€β”€ 2026-01-19-infrastructure-deployment.md +β”‚ β”œβ”€β”€ 2026-01-19-backend-api-implementation.md +β”‚ └── 2026-01-20-frontend-mcp-agents.md β”œβ”€β”€ ROADMAP.md # Plan general β”œβ”€β”€ NEXT-SESSION.md # PrΓ³ximos pasos detallados β”œβ”€β”€ TROUBLESHOOTING.md # SoluciΓ³n de problemas β”œβ”€β”€ QUICK-REFERENCE.md # Este archivo -β”œβ”€β”€ K8S-CLUSTER.md # Estado del cluster +β”œβ”€β”€ K8S-CLUSTER.md # Estado del cluster └── CLUSTER-CREDENTIALS.md # Credenciales (sensible) ``` @@ -369,18 +445,70 @@ export KUBECONFIG=~/.kube/aiworker-config kubectl get nodes # 2. Ver servicios -kubectl get pods -n control-plane -kubectl get pods -n gitea +kubectl get pods -n control-plane # frontend, backend +kubectl get pods -n agents # claude-agent, claude-terminal +kubectl get pods -n gitea # gitea -# 3. Backend local -cd backend -bun run dev +# 3. Verificar URLs funcionan +curl -s https://app.fuq.tv/ | grep "AiWorker" +curl -s https://api.fuq.tv/api/health | jq . +curl -s https://claude.fuq.tv/ | head -5 -# 4. Ver Actions +# 4. Desarrollo local +cd backend && bun run dev # Backend +cd frontend && bun run dev # Frontend + +# 5. Ver CI/CD builds +open https://git.fuq.tv/admin/aiworker-frontend/actions open https://git.fuq.tv/admin/aiworker-backend/actions +open https://git.fuq.tv/admin/aiworker-agent/actions -# 5. Continuar donde te quedaste -code NEXT-SESSION.md +# 6. Rollout restart despuΓ©s de builds +kubectl rollout restart deployment/frontend -n control-plane +kubectl rollout restart deployment/backend -n control-plane +kubectl rollout restart deployment/claude-agent -n agents + +# 7. Continuar donde te quedaste +cat NEXT-SESSION.md +``` + +--- + +## πŸ§ͺ Testing RΓ‘pido + +### Frontend +```bash +# Login y crear proyecto +open https://app.fuq.tv +# Register β†’ Login β†’ New Project β†’ Click Project β†’ New Task +``` + +### Backend API +```bash +# Health check +curl -s https://api.fuq.tv/api/health | jq . + +# Register user +curl -X POST https://api.fuq.tv/api/auth/register \ + -H "Content-Type: application/json" \ + -d '{"email":"test@test.com","username":"test","password":"test1234"}' + +# List projects +curl -s https://api.fuq.tv/api/projects | jq . + +# MCP tools +curl -s https://api.fuq.tv/api/mcp/tools | jq '.tools[] | .name' +``` + +### Agent +```bash +# Conectar al terminal web +open https://claude.fuq.tv + +# O conectar al pod directamente +kubectl exec -it -n agents deployment/claude-agent -- /bin/bash +cd /workspace +claude ``` ---