captain-claude/apps/captain-mobile-v2/ESTADO_PROYECTO.md

Captain Claude Mobile v2 - Estado del Proyecto

Fecha: 2026-01-17 Estado: BACKEND ACTUALIZADO / PENDIENTE COMPILAR APK

---

Cambios Realizados (17 Ene 2026)

Backend reescrito con patrón LLMChat

Se aplicó el patrón de streaming de LLMChat:

1. Queue para desacoplar receiver/sender

   • asyncio.Queue para mensajes entrantes
   • ws_receiver() y ws_sender() corren en paralelo con asyncio.gather()

2. ChatBuffer - Contexto por conexión

   • Mantiene estado: websocket, username, queue, done, conversation_id
   • done event para interrumpir streaming

3. Mensaje init al conectar

   • Envía lista de conversaciones al conectar
   • Frontend recibe estado inicial sin llamada REST adicional

4. Soporte para interrumpir streaming

   • Cliente envía {"type": "stop"}
   • Backend termina proceso Claude y envía {"type": "interrupted"}

5. Nuevos tipos de mensaje

   • init - Estado inicial con conversaciones
   • text_start - Inicio de bloque de texto
   • tool_input - Input completo del tool
   • interrupted - Generación interrumpida
   • conversation_loaded - Conversación cargada via WS

---

Configuración Actual

Componente	Puerto	Notas
captain-api-v2	3030	Backend con patrón LLMChat

Credenciales: admin / admin Servicio: captain-api-v2.service (systemd)

---

Archivos Modificados

apps/captain-mobile-v2/
├── backend/
│   ├── captain_api_v2.py          # Backend reescrito
│   └── captain-api-v2.service     # Puerto 3031
├── flutter/lib/
│   ├── config/api_config.dart     # Puerto 3031
│   ├── services/chat_service.dart # Nuevos eventos
│   └── providers/chat_provider.dart # Manejo de init, interrupted, etc.
└── ESTADO_PROYECTO.md             # Este archivo

---

Próximos Pasos

1. Instalar servicio systemd (requiere sudo)

sudo cp captain-api-v2.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable captain-api-v2
sudo systemctl start captain-api-v2

2. Compilar APK

cd /home/architect/captain-claude/apps/captain-mobile-v2/flutter
/home/architect/flutter/bin/flutter build apk --release

3. Subir a Nextcloud

scp -i ~/.ssh/tzzr build/app/outputs/flutter-apk/app-release.apk \
  root@72.62.1.113:"/var/www/nextcloud/data/tzzrdeck/files/documentos adjuntos/captain-mobile-v2.apk"
ssh -i ~/.ssh/tzzr root@72.62.1.113 \
  "chown www-data:www-data '/var/www/nextcloud/data/tzzrdeck/files/documentos adjuntos/captain-mobile-v2.apk' && \
   cd /var/www/nextcloud && sudo -u www-data php occ files:scan tzzrdeck"

---

Probar Backend Manualmente

# Health check
curl http://localhost:3031/health

# Login
TOKEN=$(curl -s -X POST http://localhost:3031/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"admin"}' | jq -r '.token')

# Listar conversaciones
curl -H "Authorization: Bearer $TOKEN" http://localhost:3031/conversations

---

Arquitectura WebSocket (LLMChat pattern)

┌─────────────────┐     WebSocket      ┌─────────────────┐
│  Flutter Client │ ◄───────────────► │  FastAPI Server │
│                 │   /ws/chat         │                 │
└─────────────────┘                    └────────┬────────┘
                                                │
         ┌──────────────────────────────────────┼──────────────────┐
         │                                      │                  │
         ▼                                      ▼                  ▼
    ws_receiver()                         ws_sender()        ChatBuffer
    - Recibe JSON                         - Procesa queue    - websocket
    - stop → buffer.done.set()            - Llama Claude     - username
    - ping → pong                         - Stream chunks    - queue
    - Otros → queue.put()                 - Guarda en DB     - done event

---

Flujo de Mensajes

Conexión

Cliente                          Servidor
   │                                │
   │──── {"token": "xxx"} ─────────►│
   │                                │
   │◄─── {"type": "init",          │
   │      "user": "admin",          │
   │      "conversations": [...]}   │

Chat

Cliente                          Servidor
   │                                │
   │──── {"type": "message",       │
   │      "content": "Hola"} ──────►│
   │                                │
   │◄─── {"type": "start"} ─────────│
   │◄─── {"type": "thinking"} ──────│
   │◄─── {"type": "delta", ...} ────│ (múltiples)
   │◄─── {"type": "done", ...} ─────│

Interrumpir

Cliente                          Servidor
   │                                │
   │──── {"type": "stop"} ─────────►│
   │                                │
   │◄─── {"type": "interrupted",   │
   │      "content": "..."} ────────│