Files
Alpha/AGENTS.md
T
ricardo 66fd4e175a Alpha v0.1.0 — KAPPA Hub inicial
- 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
2026-05-22 20:18:54 -05:00

2.7 KiB

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

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