admin/aiworker
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update QUICK-REFERENCE with current system state

Browse Source 
- 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>
This commit is contained in:
Hector Ros
2026-01-20 16:47:17 +01:00
parent 9b55a2dc0f
commit f619c4bf56
1 changed files with 151 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files

174
QUICK-REFERENCE.md
View File

@@ -6,16 +6,26 @@ Referencia rápida de todo lo importante en un solo lugar.
## 🌐 URLs ## 🌐 URLs
| Servicio | URL | Credenciales | | Servicio | URL | Credenciales | Estado |
|----------|-----|--------------| |----------|-----|--------------|--------|
| Gitea | https://git.fuq.tv | admin / admin123 | | **Frontend** | https://app.fuq.tv | - | ✅ Running (2 pods) |
| ArgoCD | https://argocd.fuq.tv | admin / LyPF4Hy0wvp52IoU | | **Backend API** | https://api.fuq.tv | - | ✅ Running (2 pods) |
| Longhorn | https://longhorn.fuq.tv | admin / aiworker2026 | | **Terminal Web** | https://claude.fuq.tv | - | ✅ Running (tmux persistente) |
| Backend Repo | https://git.fuq.tv/admin/aiworker-backend | - | | **Gitea** | https://git.fuq.tv | admin / admin123 | ✅ Running |
| Actions | https://git.fuq.tv/admin/aiworker-backend/actions | - | | **ArgoCD** | https://argocd.fuq.tv | admin / LyPF4Hy0wvp52IoU | ✅ Running |
| Packages | https://git.fuq.tv/admin/-/packages | - | | **Longhorn** | https://longhorn.fuq.tv | admin / aiworker2026 | ✅ Running |
| Test App | https://test.fuq.tv | - | | **HAProxy Stats** | http://108.165.47.221:8404/stats | admin / aiworker2026 | ✅ Running |
| HAProxy Stats | http://108.165.47.221:8404/stats | admin / aiworker2026 |
### 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 ## 📁 ESTRUCTURA DEL PROYECTO
``` ```
teamSquadAiWorker/ teamSquadAiWorker/
├── backend/ # Bun backend ├── backend/ # Bun backend (✅ Desplegado)
│ ├── src/ │ ├── src/
│ │ ├── api/routes/ # Auth, Projects, Tasks, Agents, MCP
│ │ ├── db/ # Drizzle schema + migrations
│ │ └── index.ts # Bun.serve()
│ ├── Dockerfile │ ├── Dockerfile
│ └── .gitea/workflows/ │ └── .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 ├── docs/ # Documentación completa
├── scripts/ # Scripts de instalación ├── past-sessions/ # Sesiones anteriores
├── k8s/ # Manifests Kubernetes (por crear) │ ├── 2026-01-19-infrastructure-deployment.md
│ ├── 2026-01-19-backend-api-implementation.md
│ └── 2026-01-20-frontend-mcp-agents.md
├── ROADMAP.md # Plan general ├── ROADMAP.md # Plan general
├── NEXT-SESSION.md # Próximos pasos detallados ├── NEXT-SESSION.md # Próximos pasos detallados
├── TROUBLESHOOTING.md # Solución de problemas ├── TROUBLESHOOTING.md # Solución de problemas
├── QUICK-REFERENCE.md # Este archivo ├── QUICK-REFERENCE.md # Este archivo
├── K8S-CLUSTER.md # Estado del cluster ├── K8S-CLUSTER.md # Estado del cluster
└── CLUSTER-CREDENTIALS.md # Credenciales (sensible) └── CLUSTER-CREDENTIALS.md # Credenciales (sensible)
``` ```
@@ -369,18 +445,70 @@ export KUBECONFIG=~/.kube/aiworker-config
kubectl get nodes kubectl get nodes
# 2. Ver servicios # 2. Ver servicios
kubectl get pods -n control-plane kubectl get pods -n control-plane # frontend, backend
kubectl get pods -n gitea kubectl get pods -n agents # claude-agent, claude-terminal
kubectl get pods -n gitea # gitea
# 3. Backend local # 3. Verificar URLs funcionan
cd backend curl -s https://app.fuq.tv/ | grep "AiWorker"
bun run dev 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-backend/actions
open https://git.fuq.tv/admin/aiworker-agent/actions
# 5. Continuar donde te quedaste # 6. Rollout restart después de builds
code NEXT-SESSION.md 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
``` ```
--- ---