# KAPPA Hub

> Asistente multi-proyecto para KAPPA. Semilla de RUMBO.
> POC → validación diaria → lo que funciona migra a RUMBO.

## Stack

| Capa | Tecnología |
|------|-----------|
| Frontend | Vue 3 + TypeScript + Vite |
| Runtime | **Bun** (1.3+) |
| Estado | Pinia |
| HTTP | fetch() directo a KAPPA (proxy Vite en dev) |
| Auth | Bearer token (POST /api/users/login/) |
| Almacenamiento | localStorage (token, last project) → Dexie (futuro) |

## Sincronización entre máquinas (Mac Mini ↔ MacBook Air)

El proyecto vive en iCloud Drive: `com~apple~CloudDocs/AI/Teloprax/02_productos/kappa-hub/`.

- **Código**: se sincroniza automáticamente vía iCloud. Solo `bun install` una vez por máquina.
- **Datos de KAPPA**: viven en el servidor (kappa.lambdaanalytics.co). El Hub es solo un cliente.
- **Token**: localStorage del navegador. Loguearse una vez por máquina.
- **Datos locales futuros** (borradores, caché): se guardarán como archivos en `data/` dentro del proyecto, sincronizados vía iCloud. Ver `../rumbo/sincronizacion.md`.

## APIs KAPPA integradas

| Endpoint | Método | Uso en el hub |
|----------|--------|--------------|
| `/users/login/` | POST | Auth |
| `/initiatives-all/` | GET | Listar proyectos |
| `/users/all/` | GET | Listar usuarios |
| `/userstorys/create/` | POST | Crear HU desde transcripción |
| `/logbooks_master/create/` | POST | Crear bitácora |
| `/logbooks/create/` | POST | Entrada de bitácora |
| `/plannings_master/create/` | POST | Crear planeación |
| `/plannings/create/` | POST | Entrada de planeación |
| `/business-rules/create/` | POST | Reglas de negocio |
| `/functionalrequirements/create/` | POST | Requisitos funcionales/no funcionales |

## Estructura

```
kappa-hub/
├── src/
│   ├── types/kappa.ts          # Tipos TypeScript
│   ├── services/kappa-api.ts   # Cliente HTTP KAPPA
│   ├── stores/                 # Pinia
│   │   ├── auth.ts
│   │   ├── projects.ts
│   │   └── workitems.ts
│   ├── views/
│   │   ├── LoginView.vue
│   │   └── DashboardView.vue
│   ├── components/layout/
│   │   └── AppShell.vue
│   ├── App.vue
│   └── main.ts
├── package.json
└── vite.config.ts
```

## Cómo ejecutar

```bash
cd "02_productos/kappa-hub"
bun install   # una vez por máquina
bun dev       # http://localhost:5173
```

Abre http://localhost:5173. El proxy de Vite redirige `/api/*` a `https://kappa.lambdaanalytics.co`.

## Próximos pasos

1. Agregar Dexie.js para cache offline de proyectos y HUs
2. Pipeline de transcripciones (.docx/.vtt/.md → análisis → HU)
3. Dashboard multi-proyecto con resumen unificado
4. Priorizador diario (¿qué hacer hoy?)
5. Generador de reportes de estado