Alpha Platform
Plataforma de colaboración en tiempo real con 6 servicios, autonomía IA, integración Gmail y framework de herramientas NATS.
¿Qué es Alpha?
Alpha es una plataforma distribuida de colaboración empresarial construida con tecnologías modernas. Proporciona mensajería en tiempo real, gestión de tareas estilo Kanban, una aplicación de escritorio con autonomía IA (Ollama), integración completa con Gmail (lectura, respuesta automática, reglas de correo), un framework de herramientas Go vía NATS, trabajos programados (cron jobs), subida de archivos, canales de escalación y un panel de administración — todo con autenticación segura basada en JWT y soporte para Google OAuth.
Componentes del Sistema
alpha
Aplicación de escritorio construida con Wails v2 (Go + Svelte). Incluye autonomía IA con Ollama (bucle ReAct), gestión de herramientas NATS, integración de email, tareas y conexión directa a MongoDB.
Wails v2 (Go + Svelte)alpha-api
API REST construida con Hono y Node.js. Maneja autenticación, mensajería, tareas, clientes, integración Gmail con reglas de correo, subida de archivos, descubrimiento de herramientas NATS y retransmisión WebSocket.
Hono + Node.jsalpha-ws
Servidor WebSocket dedicado para comunicación en tiempo real. Gestiona presencia, indicadores de escritura, retransmisión de mensajes y sincronización de datos.
ws + JWTalpha-pwa
Aplicación web progresiva (PWA) construida con SvelteKit 5 y Tailwind v4. Interfaz de chat, tablero Kanban, integración de email, grabación de audio, compartición de imágenes y panel de administración.
SvelteKit 5alpha-tools
Framework de herramientas en Go con comunicación NATS. CLI de scaffolding para crear nuevas herramientas. Ciclo de vida: registro, heartbeat (30s), deregistro. Patrón request/reply.
Go + NATSalpha-infrastructure
Configuración de infraestructura con Docker Compose. Incluye servidor NATS con JetStream habilitado para mensajería asíncrona y comunicación entre servicios.
Docker + NATSCaracterísticas Principales
- Autenticación segura — JWT + bcrypt, Google OAuth, rate limiting, sesión persistente en desktop
- Control de acceso por roles — Admin, user, viewer con permisos granulares
- Mensajería en tiempo real — WebSocket con presencia online, indicadores de escritura, multi-dispositivo
- Integración Gmail — Lectura de correos, respuesta automática con IA, reglas de correo configurables, poller periódico
- Autonomía IA — Bucle ReAct con Ollama, ejecución de herramientas, contexto de conversación
- Framework de herramientas — Herramientas Go vía NATS con scaffolding CLI, registro automático, heartbeat
- Trabajos programados — CronJobs para tareas automáticas (polling email, limpieza, etc.)
- Subida de archivos — Upload y gestión de archivos adjuntos
- Canales de escalación — Sistema de escalación para mensajes y eventos críticos
- Mensajes de audio — Grabación y reproducción con soporte multi-codec
- Compartición de imágenes — Captura, pegado, arrastrar, compresión automática
- Gestión de tareas — Tablero Kanban con filtros, prioridades, asignaciones
- Gestión de clientes — CRUD completo con sincronización en tiempo real
- Panel de administración — Gestión de usuarios, roles, suspensión de cuentas, configuración de herramientas
- Aplicación de escritorio — Wails v2 con acceso directo a MongoDB, NATS y Ollama
- PWA instalable — Tema oscuro, diseño responsive, soporte offline
Stack Tecnológico
| Capa | Tecnología | Versión |
|---|---|---|
| Desktop | Go + Wails v2 | 1.25 / 2.x |
| Backend API | Node.js + Hono | 22.x / 4.12 |
| WebSocket | ws | 8.19 |
| Base de datos | MongoDB | 7.x driver |
| Autenticación | JWT + bcryptjs + Google OAuth | 9.0 / 3.0 |
| Frontend | SvelteKit 5 (Svelte 5 runes) | 2.50 |
| Estilos | Tailwind CSS | 4.2 |
| Mensajería | NATS | 2-alpine |
| IA | Ollama | Local |
| Google APIs (Gmail) | OAuth 2.0 | |
| Infraestructura | Docker Compose | v2 |
Métricas del Código
| Componente | Archivos | Líneas Aprox. | Lenguaje |
|---|---|---|---|
| alpha | ~18+ | ~6,000 | Go + Svelte |
| alpha-api | ~25+ | ~2,500 | JavaScript (ESM) |
| alpha-ws | 1 | ~309 | JavaScript (ESM) |
| alpha-pwa | ~25+ | ~4,000 | TypeScript + Svelte |
| alpha-tools | ~10+ | ~1,500 | Go |
| alpha-infrastructure | 2 | ~30 | YAML + NATS conf |
| Total | ~80+ | ~14,300+ |
Cambios desde 2026-03-18
- +2 servicios nuevos —
alpha(escritorio Wails v2) yalpha-tools(framework Go/NATS) se incorporan al monorepo - Integración Gmail — Poller de correos, reglas de email, borradores automáticos, respondedor IA, estados de procesamiento
- Autonomía IA — Bucle ReAct con Ollama en la app de escritorio, ejecución de herramientas via NATS
- CronJobs — Sistema de trabajos programados para polling de email, tareas automáticas
- Subida de archivos — Endpoint de upload con gestión de archivos adjuntos
- Canales de escalación — Rutas de escalación para eventos críticos
- 82 tests pasando — De 0 a 82 tests con Vitest (auth, messages, tasks, clients, members, middleware, ws)
- Pipeline de conversaciones corregido — Agregación MongoDB para listado de conversaciones reparada
- Evaluación de riesgo — Mejorada de MEDIO-ALTO a MEDIO gracias a tests, validación y autenticación robusta
- Código: ~3,610 → ~14,300+ líneas — Crecimiento de ~32 a ~80+ archivos en 6 servicios