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) <noreply@anthropic.com>
2026-01-20 16:47:17 +01:00
parent 9b55a2dc0f
commit f619c4bf56
1 changed files with 151 additions and 23 deletions
--- 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
 ```

 ---