jessica.orozco/wave-ai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
wave-ai/doc/propuesta_kinetix.md

15 KiB
Raw Blame History

Propuesta Técnica y Comercial

Plataforma de Intranet Corporativa · Kinetix

Preparado por: Jess Miller · Arquitecta de Software Senior
Fecha: Junio 2026
Versión: 1.0 — Confidencial
Para: [Nombre de la Empresa Objetivo]

Resumen Ejecutivo

Kinetix es una plataforma de intranet corporativa de nueva generación, diseñada para consolidar en un único ecosistema digital todos los procesos internos de una organización empresarial moderna: gestión de identidades, reserva de espacios, aprobación de contenidos, directorio de personal y ticketing de incidencias.

La plataforma está operativa, con frontend y backend en producción local, y lista para su despliegue en infraestructura cloud o on-premise. Está construida sobre un stack tecnológico de primer nivel —Angular 18, NestJS 10 y PostgreSQL 15— con autenticación nativa vía Microsoft Azure Entra ID (Active Directory), lo que garantiza integración inmediata con el ecosistema Microsoft de cualquier empresa.

Important

Kinetix no es un prototipo. Es un producto en desarrollo activo con arquitectura escalable, código limpio y documentación técnica estructurada. Esta propuesta presenta su adopción como solución central de intranet para [Empresa].

1. Problema que Resuelve

Las empresas modernas operan con herramientas fragmentadas: un sistema para reservas, otro para el directorio, formularios manuales para workflows de aprobación y correos internos para incidencias. Este modelo genera:

Problema Impacto
Fragmentación de herramientas Pérdida de tiempo y errores de coordinación
Sin integración con Active Directory Onboarding lento, acceso manual, riesgos de seguridad
Reservas de salas sin control centralizado Conflictos de disponibilidad, overbooking
Aprobaciones por correo Sin trazabilidad, cuellos de botella operativos
Directorio desactualizado Información incorrecta, baja colaboración

Kinetix resuelve todos estos problemas en una sola plataforma integrada.

2. La Solución: Plataforma Kinetix

2.1 Visión General

┌─────────────────────────────────────────────────────────────┐
│                     KINETIX INTRANET                        │
│  "Un ecosistema. Todos los procesos internos en uno."       │
├──────────────┬──────────────┬──────────────┬────────────────┤
│  Directorio  │   Espacios   │  Workflows   │  Info Hub CMS  │
│  Corporativo │  & Reservas  │ de Aprobación│   + Ticketing  │
│  (Entra ID)  │  (Calendar)  │  (BPM Multi- │  (SLA/Tickets) │
│              │  + IA Parser │   nivel)     │                │
└──────────────┴──────────────┴──────────────┴────────────────┘
         ↑                    ↑                    ↑
    SSO / JWT          PostgreSQL DB          Azure Entra ID

2.2 Módulos Implementados

🏢 Módulo 1 — Directorio Corporativo (IAM/HR)

Sincronizado con Microsoft Entra ID (Azure AD). Muestra el organigrama real de la empresa con perfiles dinámicos: nombre, rol, departamento, skills, métricas y contacto directo.

  • Búsqueda en tiempo real por nombre, rol o habilidad
  • Filtrado por departamento
  • ID de Active Directory (AD-XXXX) en cada perfil
  • Badge de calificación y tarifa por hora
  • Diseño de tarjetas con micro-animaciones y hover

📅 Módulo 2 — Autogestión de Espacios y Activos (PMS)

Sistema completo de reservas con calendario dinámico con vistas Mes/Semana/Día.

  • Clic en cualquier slot del calendario → redirige a formulario de reserva
  • Filtros en tiempo real por tipo de recurso (salas, equipos, vehículos)
  • Asistente IA de lenguaje natural: el usuario escribe "Reservar sala para el jueves 5 personas" y el sistema auto-completa el formulario usando un parser de IA
  • Confirmación y notificación a calendario de Active Directory

⚙️ Módulo 3 — Workflow de Aprobación y Publicación (BPM)

Motor de reglas multinivel integrado con SSO y Active Directory para jerarquías de aprobación de contenidos institucionales.

  • Creación → Validación → Publicación automática
  • Estados de aprobación trazables
  • Publicación en canales de comunicación interna

📰 Módulo 4 — Info Hub / CMS Corporativo

Gestión de contenidos corporativos: artículos, comunicados y publicaciones institucionales con editor integrado.

🎫 Módulo 5 — Ticketing e Incidencias

Creación, flujo y asignación de tickets internos con gestión de SLAs y prioridades de soporte técnico y operativo.

3. Stack Tecnológico

Capa Tecnología Versión Justificación
Frontend Angular 18.0 Framework enterprise estándar de Google. Signals natively reactive.
Backend NestJS 10.0 Framework TypeScript para APIs REST escalables y modulares
Autenticación Azure Entra ID + JWT — SSO corporativo con Passport.js. Sin gestión de contraseñas propias
Base de Datos PostgreSQL 15 Transaccional, ACID-compliant. Crítico para reservas sin overbooking
ORM Prisma — Migraciones tipeadas, esquema declarativo
Contenedores Docker + Docker Compose — Portabilidad total entre entornos
Estilos TailwindCSS + Vanilla CSS — Sistema de diseño Executive Suite personalizado
IA Parser API de IA (NLP) — Procesamiento de lenguaje natural para reservas conversacionales

3.1 Arquitectura de Seguridad SSO

Usuario → App Angular → Azure Entra ID (login)
                ↓
         Token JWT (con roles AD)
                ↓
    Backend NestJS valida token
    con passport-azure-ad / passport-jwt
                ↓
    Acceso según rol: employee | manager | admin

Ninguna contraseña se almacena en Kinetix. La autenticación es 100% delegada a Active Directory de la empresa.

4. Arquitectura del Sistema

kinetix/
├── frontend/          ← SPA Angular 18 (Standalone Components + Signals)
│   └── src/app/
│       ├── core/      ← Guards SSO, interceptores HTTP, auth services
│       ├── shared/    ← Componentes reutilizables del Design System
│       └── features/  ← Módulos por dominio (reservas, directorio, etc.)
│
├── backend/           ← API REST NestJS (TypeScript modular)
│   └── src/
│       ├── auth/      ← Módulo SSO Active Directory / JWT
│       ├── cms/       ← Gestión de contenidos
│       ├── directory/ ← Directorio corporativo
│       ├── workflow/  ← Motor de aprobaciones
│       ├── spaces/    ← Reservas de espacios (con anti-overbooking)
│       └── ticketing/ ← Sistema de incidencias
│
├── standards/         ← Documentación técnica y estándares del proyecto
├── docker-compose.yml ← Infraestructura local: PostgreSQL + pgAdmin
└── setup.ps1 / .sh   ← Scripts de onboarding para nuevos devs

5. Diseño e Interfaz de Usuario

Kinetix utiliza el Executive Suite Design System, un sistema de diseño corporativo premium desarrollado a medida:

  • Paleta: Ivory #F5F4F1 + Negro sofisticado #0F0D0A + Dorado bronce #C9973C
  • Tarjetas Joya (Blackjack System): Fondos oscuros en Navy, Plum, Viridian, Espresso para los módulos principales
  • Tipografía: Inter (titulares) + Outfit (cuerpo)
  • Glassmorphism y micro-animaciones para interactividad premium
  • Responsive design completo: mobile, tablet, desktop
  • Sidebar colapsable con estado de sistema en tiempo real

El diseño fue validado contra estándares documentados en standards/04-ui-ux-neon.md.

6. Estado Actual del Proyecto

Módulo Estado Detalle
Autenticación SSO ✅ Implementado JWT + Guards + Interceptores HTTP
Dashboard principal ✅ Implementado KPIs, cards de módulos, navegación
Directorio de Personal ✅ Implementado Búsqueda reactiva, filtros, tarjetas AD
Calendario de Reservas ✅ Implementado Vistas Mes/Semana/Día, filtros dinámicos
Formulario de Reserva + IA ✅ Implementado Parser NLP con mock local y API IA
Workflow de Aprobación 🔄 En desarrollo Motor de reglas, vistas de simulación
Info Hub / CMS 📋 Planificado Editor WYSIWYG, taxonomías
Ticketing 📋 Planificado SLA, asignación, prioridades
Base de datos PostgreSQL ✅ Configurado Docker Compose, schema documentado
Despliegue cloud 📋 Pendiente Azure / AWS / on-premise

7. Plan de Acción (Roadmap de Entrega)

Fase 0 — Diagnóstico e Integración (Semanas 1–2)

Actividad Responsable Entregable
Reunión de kickoff con equipo técnico Arquitecta + IT Cliente Acta de requerimientos
Auditoría del Active Directory existente Arquitecta + Admin AD Mapeo de grupos, roles y UOs
Definición de ambientes (dev / staging / prod) DevOps Documento de infraestructura
Firma de NDA y contrato de desarrollo Legal Contrato ejecutado

Fase 1 — Setup e Integración SSO (Semanas 3–4)

Actividad Entregable
Configurar Azure Entra ID con la tenant del cliente App registrada en Azure Portal
Integrar OAuth2 + JWT con roles reales de AD Auth funcional en entorno del cliente
Onboarding técnico al equipo de IT interno Workshop de 4 horas
Setup de base de datos PostgreSQL en producción DB productiva con migraciones aplicadas

Hito: ✅ Login con credenciales reales de la empresa funcionando.

Fase 2 — Módulos Core (Semanas 5–10)

Semana Módulo Entregable
5–6 Directorio Corporativo Perfiles sincronizados con AD real
7–8 Gestión de Espacios + IA Calendario + reservas en producción
9–10 Workflow de Aprobación Motor de reglas con notificaciones

Hito: ✅ Piloto con 50 usuarios internos en entorno staging.

Fase 3 — Módulos Secundarios (Semanas 11–14)

Semana Módulo Entregable
11–12 Info Hub / CMS Editor de artículos operativo
13–14 Ticketing e Incidencias Sistema de tickets con SLA

Hito: ✅ Plataforma completa en staging. UAT (User Acceptance Testing).

Fase 4 — Lanzamiento (Semanas 15–16)

Actividad Entregable
Despliegue en producción cloud/on-premise Plataforma 100% en vivo
Capacitación a usuarios finales (por roles) Manual de usuario + sesiones
Documentación técnica de operación Runbook de DevOps
Soporte post-lanzamiento (30 días incluidos) Canal de soporte dedicado

Hito: 🚀 Go-Live oficial de Kinetix para [Empresa].

8. Diagrama de Fases

gantt
    title Roadmap de Implementación Kinetix
    dateFormat  YYYY-MM-DD
    section Fase 0 — Diagnóstico
    Kickoff & Auditoría AD       :2026-07-01, 7d
    Definición de Ambientes      :2026-07-07, 7d
    section Fase 1 — SSO & Setup
    Azure Entra ID Integration   :2026-07-14, 7d
    PostgreSQL Producción         :2026-07-21, 7d
    section Fase 2 — Core
    Directorio Corporativo        :2026-07-28, 14d
    Gestión de Espacios + IA     :2026-08-11, 14d
    Workflow de Aprobación        :2026-08-25, 14d
    section Fase 3 — Secundarios
    Info Hub / CMS                :2026-09-08, 14d
    Ticketing & Incidencias       :2026-09-22, 14d
    section Fase 4 — Lanzamiento
    Despliegue Producción         :2026-10-06, 7d
    Capacitación & Go-Live        :2026-10-13, 7d

9. Propuesta Económica

Modelo de Precios Sugerido

Note

Los siguientes valores son referenciales y ajustables según el tamaño de la organización, cantidad de usuarios y requerimientos adicionales de personalización.

Concepto Descripción Estimado
Licencia de Plataforma Uso de la plataforma Kinetix base A negociar
Implementación e Integración Fases 0–1: Setup, SSO, infraestructura 4–6 semanas
Desarrollo de Módulos Core Fase 2: Directorio, Espacios, Workflow 6 semanas
Módulos Secundarios Fase 3: CMS, Ticketing 4 semanas
Soporte Post-Lanzamiento 30 días incluidos + contratos de mantenimiento opcionales Incluido

Modalidades de Contratación

Modalidad Descripción Recomendado para
Llave en mano Precio fijo por entrega completa Empresas con presupuesto definido
Tiempo y materiales Pago por hora/sprint según avance Proyectos con alcance variable
SaaS Mensual Hosting + mantenimiento + actualizaciones Empresas que prefieren OpEx

10. Por Qué Kinetix sobre Alternativas

Criterio Kinetix SharePoint Confluence Desarrollo a medida desde cero
Integración AD nativa ✅ ✅ ⚠️ Plugin ✅
Personalizable 100% ✅ ⚠️ Limitado ⚠️ Limitado ✅
Stack moderno (Angular + NestJS) ✅ ❌ ❌ ✅
Asistente IA integrado ✅ ❌ ❌ Solo si se desarrolla
Tiempo de implementación ~4 meses 3–12 meses 2–6 meses 12–18 meses
Costo de implementación Medio Alto Medio Muy alto
Curva de aprendizaje usuarios Baja Alta Media Variable

11. Garantías y Compromisos

  • ✅ Código fuente entregado: La empresa es propietaria del código al finalizar el proyecto
  • ✅ Documentación técnica completa: Estándares, esquemas DB, guías de API
  • ✅ Sin vendor lock-in: Stack 100% open source (Angular, NestJS, PostgreSQL)
  • ✅ Seguridad by design: OWASP Top 10, JWT validation, HTTPS obligatorio
  • ✅ Escalabilidad: Arquitectura modular preparada para 10,000+ usuarios
  • ✅ Soporte 30 días post-lanzamiento incluido en el contrato base

12. Próximos Pasos

  1. Reunión de presentación (30–45 min): Demo en vivo de la plataforma actual
  2. Workshop técnico (2h): Revisión de requerimientos específicos con IT y RR.HH.
  3. Propuesta económica formal ajustada al volumen de usuarios y módulos requeridos
  4. Firma de NDA para compartir acceso al repositorio y documentación interna
  5. Kick-off de Fase 0

Contacto

Jess Miller
Arquitecta de Software Senior · Full-Stack Engineer
📧 jess@kinetix.dev
🔗 github.com/kinetix

Documento confidencial. Preparado exclusivamente para [Nombre de la Empresa]. Prohibida su reproducción parcial o total sin autorización expresa.