76 lines
3.2 KiB
Markdown
76 lines
3.2 KiB
Markdown
# INICIO-AQUI.md — Guía de Onboarding Kinetix Intranet
|
|
## La guía técnica única para desarrolladores y agentes de IA
|
|
|
|
**Para:** Cualquier desarrollador o agente de IA que trabaje en el monorepo Kinetix.
|
|
**Stack Principal:** Angular 17+ & NestJS + PostgreSQL.
|
|
|
|
---
|
|
|
|
## Estructura del Monorepo
|
|
|
|
```
|
|
Kinetix/
|
|
│
|
|
├── AGENT.md ← System Prompt principal de la IA (no borrar)
|
|
├── INICIO-AQUI.md ← Este archivo
|
|
├── package.json ← Scripts del monorepo
|
|
├── docker-compose.yml ← Contenedor de base de datos PostgreSQL local
|
|
├── setup.ps1 / setup.sh ← Scripts de aprovisionamiento de entorno
|
|
│
|
|
├── backend/ ← API REST en NestJS
|
|
│ ├── src/
|
|
│ │ ├── auth/ ← Módulo de SSO Active Directory / JWT
|
|
│ │ ├── cms/ ← Módulo de Gestión de Contenidos
|
|
│ │ ├── directory/ ← Módulo de Directorios Corporativos
|
|
│ │ ├── workflow/ ← Módulo de Workflow de Aprobación
|
|
│ │ ├── spaces/ ← Módulo de Reservas de Espacios
|
|
│ │ └── ticketing/ ← Módulo de Incidencias (Ticketing)
|
|
│ └── package.json
|
|
│
|
|
├── frontend/ ← SPA en Angular 17+
|
|
│ ├── src/app/
|
|
│ │ ├── core/ ← Guardias de SSO, interceptores HTTP, auth services
|
|
│ │ ├── shared/ ← Componentes comunes estilo Neon/Cyberpunk
|
|
│ │ └── features/ ← Módulos visuales correspondientes a cada subagente
|
|
│ └── package.json
|
|
│
|
|
└── standards/ ← Estándares del proyecto
|
|
├── 01-subagents-prompts.md ← Prompts e instrucciones para cada subagente
|
|
├── 02-database-schema.md ← Modelado e integridad PostgreSQL
|
|
├── 03-active-directory-sso.md ← Flujo de autenticación detallado
|
|
└── 04-ui-ux-neon.md ← Directrices de diseño Neon/Cyberpunk/Vercel
|
|
```
|
|
|
|
---
|
|
|
|
## Paso 1: Configurar el Entorno
|
|
|
|
Ejecuta el script de configuración correspondiente a tu sistema operativo en la raíz del proyecto para copiar la plantilla de variables de entorno y preparar el workspace:
|
|
|
|
```bash
|
|
# Windows (PowerShell):
|
|
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process; .\setup.ps1
|
|
|
|
# Linux / macOS (Bash):
|
|
chmod +x setup.sh && ./setup.sh
|
|
```
|
|
|
|
---
|
|
|
|
## Paso 2: Iniciar Base de Datos Local
|
|
|
|
Levanta el contenedor de PostgreSQL para desarrollo local:
|
|
```bash
|
|
docker-compose up -d
|
|
```
|
|
Esto creará la base de datos `kinetix_db` expuesta en `localhost:5432` y pgAdmin en `http://localhost:5050` con las credenciales configuradas en el archivo `.env`.
|
|
|
|
---
|
|
|
|
## Paso 3: Flujo de Autenticación Integrado (Active Directory SSO)
|
|
|
|
1. El cliente entra en la app Angular. Si no está autenticado, el guardia de SSO lo redirige al portal institucional de Microsoft Entra ID.
|
|
2. Al ingresar sus credenciales institucionales, se le retorna un JWT.
|
|
3. El frontend Angular intercepta las llamadas HTTP e inyecta el JWT en la cabecera `Authorization: Bearer <JWT>`.
|
|
4. El backend NestJS valida el token en el módulo `auth` y le da acceso a los endpoints correspondientes según su rol en la organización.
|