# project.linkedcorp.net

**En producción:** https://project.linkedcorp.net

Gestión y seguimiento de proyectos y actividades de TI para una empresa de tamaño medio. MVP simple
por diseño (menos campos, menos módulos separados) con el modelo de datos preparado para crecer
hacia el resto del alcance funcional (riesgos, incidencias, recursos, proveedores, presupuesto,
reportes exportables, etc.) sin romper lo construido.

## Stack

- Frontend: React + Vite
- Backend: Node.js + Express
- Base de datos: MariaDB
- Deploy: Debian 12 (dos servicios separados — arquetipo B del grupo)

## Estructura

```text
project.linkedcorp.net/
├── README.md
├── AGENTS.md
├── SPEC.md
├── API.md
├── BASE_DE_DATOS.md
├── CONFIGURACION.md
├── VERSIONADO.md
├── ESTADO.md
├── frontend/
├── backend/
├── docs/
└── scripts/
```

## Modulos principales (MVP)

- Seguridad (usuarios, roles, auditoría)
- Organización (departamentos, usuarios)
- Proyectos, Actividades y Tareas
- Dashboard, Calendario, Gantt (solo lectura)
- Comentarios, adjuntos, notificaciones in-app
- Equipos (inventario de TI con agentes GLPI)
- Configuración (catálogos)

## Arranque rapido

### Backend

```bash
cd backend
npm install
cp .env.example .env   # completar con las credenciales reales
npm run dev
```

### Frontend

```bash
cd frontend
npm install
npm run dev
```

Puertos de este proyecto (registrados en `PORTS_INVENTORY.md` del grupo): frontend `5196`,
backend `4019`. El frontend escucha en `0.0.0.0` para poder probarlo desde otro equipo/celular en
la misma red.

## Variables y configuracion

- Revisar `backend/.env.example` y `CONFIGURACION.md`.
- Base de datos dev: `project_linkedcorp` en `192.168.222.20` (ya creada).

## Documentacion relacionada

- `AGENTS.md` — contexto del proyecto para el asistente de IA (leer primero el orquestador del grupo).
- `SPEC.md` — alcance funcional.
- `API.md` — contrato de la API.
- `BASE_DE_DATOS.md` — modelo de datos.
- `CONFIGURACION.md` — variables de entorno y setup local.
- `docs/ARQUITECTURA-INVENTARIO.md` — módulo Equipos (agente GLPI + colector).
- `docs/UI-UX-WINDOWS.md` — identidad visual del proyecto (Fluent/Windows 11).
- `ESTADO.md` — punto de retoma del proyecto (handoff).