165 lines
5.5 KiB
Markdown
165 lines
5.5 KiB
Markdown
# 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](https://github.com/c0sogi/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)
|
|
```bash
|
|
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
|
|
```bash
|
|
cd /home/architect/captain-claude/apps/captain-mobile-v2/flutter
|
|
/home/architect/flutter/bin/flutter build apk --release
|
|
```
|
|
|
|
### 3. Subir a Nextcloud
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
# 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": "..."} ────────│
|
|
```
|