Change PIN to 1451
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
ARCHITECT
164
apps/captain-mobile-v2/ESTADO_PROYECTO.md
Normal file
164
apps/captain-mobile-v2/ESTADO_PROYECTO.md
Normal file
@@ -0,0 +1,164 @@
|
||||
# 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": "..."} ────────│
|
||||
```
|
||||
Reference in New Issue
Block a user