330 lines
15 KiB
Markdown
330 lines
15 KiB
Markdown
# 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
|
||
|
||
```mermaid
|
||
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.*
|