# Propuesta Técnica y Comercial
## Plataforma de Intranet Corporativa · **App**

---

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

---

## Resumen Ejecutivo

**App** 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]
> App 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 |

**App resuelve todos estos problemas en una sola plataforma integrada.**

---

## 2. La Solución: Plataforma App

### 2.1 Visión General

```
┌─────────────────────────────────────────────────────────────┐
│                     App 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 App.** La autenticación es 100% delegada a Active Directory de la empresa.

---

## 4. Arquitectura del Sistema

```
App/
├── 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

App 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 App para [Empresa].

---

## 8. Diagrama de Fases

```mermaid
gantt
    title Roadmap de Implementación App
    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 App 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é App sobre Alternativas

| Criterio | App | 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@App.dev  
🔗 github.com/App  

---

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