ricardo
66fd4e175a
- Auth con KAPPA (login + token Bearer) - Cliente HTTP para 10 endpoints (proyectos, HUs, bitácoras, planeaciones) - Dashboard multi-proyecto con concepto médico Teloprax - Calendario colombiano con 19 feriados (Ley Emiliani + Pascua) - Scheduler tipo cron con Dexie (reglas recurrentes, toasts, log) - Diseño marca Teloprax: Inter, Space Grotesk, #1A1A2E, rojo #E63946 - Stack: Vue 3 + TypeScript + Pinia + Vite + Bun
80 lines
2.7 KiB
Markdown
80 lines
2.7 KiB
Markdown
# 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
|