chore: estructura inicial del MVP

Backend (Express + MariaDB) y frontend (React + Vite, identidad Fluent/Windows) con el
nucleo funcional: seguridad, organizacion, proyectos, actividades, subtareas, dependencias,
dashboard, calendario, gantt, comentarios, adjuntos, notificaciones in-app y catalogos.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Milton Gonzalez
2026-09-03 08:37:58 -05:00
commit 1d22adc42e
135 changed files with 10913 additions and 0 deletions
+78
View File
@@ -0,0 +1,78 @@
# 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 Subtareas
- Dashboard, Calendario, Gantt (solo lectura)
- Comentarios, adjuntos, notificaciones in-app
- 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/UI-UX-WINDOWS.md` — identidad visual del proyecto (Fluent/Windows 11).
- `ESTADO.md` — punto de retoma del proyecto (handoff).