From 98d6d608a6d3cfe71d67d43a2ad093cfaec36909 Mon Sep 17 00:00:00 2001
From: Ricardo Gonzalez <herrmonkey@gmail.com>
Date: Wed, 27 May 2026 20:41:54 -0500
Subject: [PATCH] crear README.md con estructura, stack, tablas y reglas del
 proyecto

---
 README.md | 96 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 96 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..123018f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,96 @@
+# Alpha — KAPPA Hub
+
+> Asistente multi-proyecto para KAPPA. Semilla de RUMBO.
+> POC en producción como herramienta de Business Analyst.
+
+---
+
+## Stack
+
+| Capa | Tecnología |
+|------|-----------|
+| Desktop | Tauri v2 |
+| Frontend | Vue 3 + TypeScript + Vite |
+| Runtime | Bun |
+| BD local | Turso (libSQL) |
+| UI | shadcn-vue (New York) + Tailwind CSS v4 |
+| Tablas | AG Grid Community |
+| i18n | vue-i18n (es + en) |
+
+## Inicio rápido
+
+```bash
+cd 02_productos/kappa-hub
+bun install          # solo la primera vez
+npx tauri dev         # abre la app Tauri
+```
+
+## Estructura
+
+```
+kappa-hub/
+├── src/                  # Frontend Vue 3
+│   ├── views/            # LoginView, DashboardView, ProjectListView, UsersView, CalendarView, SchedulerView
+│   ├── components/       # AppSidebar, NavUser, NavProjects, UI (shadcn-vue)
+│   ├── stores/           # Pinia: auth, projects, workitems, users, scheduler
+│   ├── services/         # kappa-api, tauri-db, clean-html, calendar
+│   ├── types/            # Tipos KAPPA
+│   ├── i18n/             # es.json, en.json
+│   └── assets/           # Tema AG Grid
+├── src-tauri/            # Backend Rust
+│   ├── src/
+│   │   ├── main.rs       # Entry point Tauri
+│   │   └── db.rs         # Turso/libSQL (11 tablas)
+│   └── tauri.conf.json
+├── docs/                 # Documentación técnica
+│   ├── arquitectura_alpha.md
+│   ├── metricas_pmi.md
+│   └── learnings_para_rumbo.md
+└── public/               # Assets estáticos
+    └── Alpha.svg
+```
+
+## Base de datos (Turso)
+
+11 tablas locales en `~/Library/Application Support/com.teloprax.alpha/alpha.db`:
+
+| Tabla | Contenido |
+|-------|-----------|
+| `projects` | Proyectos KAPPA |
+| `epics` | Épicas por proyecto |
+| `user_stories` | HUs con relación a épicas |
+| `work_items` | Features, tareas, bugs |
+| `alpha_users` | Usuarios + campos locales (rol, seniority, célula) |
+| `cells` | Células / equipos |
+| `cell_members` | Usuario ↔ célula |
+| `project_members` | Usuario ↔ proyecto |
+| `absences` | Vacaciones, permisos |
+| `daily_logs` | Registro diario de trabajo |
+| `performance_snapshots` | Métricas SPI, CPI, velocity |
+
+## APIs KAPPA integradas
+
+| Endpoint | Uso |
+|----------|-----|
+| `/users/login/` | Auth |
+| `/users/all/` | Todos los usuarios |
+| `/initiatives-all/` | Proyectos |
+| `/userstorys/` | HUs (paginado) |
+| `/epicdevelopment/` | Épicas (paginado, CRUD) |
+| `/employees/` | Usuarios ↔ proyectos (paginado) |
+| `/logbooks/` | Bitácoras |
+| `/plannings/` | Planeaciones |
+
+## Reglas del proyecto
+
+1. **No hardcodear texto** — usar `t('clave')` de vue-i18n
+2. **KAPPA retorna tipos mixtos** — usar `String()` siempre
+3. **No silenciar errores** — siempre `console.error()`
+4. **Build verde siempre** — `bun run build` + `cargo build` sin errores
+
+## Documentos clave
+
+- `AGENTS.md` — Punto de entrada para IAs
+- `docs/arquitectura_alpha.md` — Arquitectura completa
+- `docs/metricas_pmi.md` — Métricas y fórmulas PMI
+- `docs/learnings_para_rumbo.md` — Patrones y utilidades para RUMBO