Milton Gonzalez
f8e42d4377
scripts/install.sh automatiza el primer despliegue en un servidor Debian/Ubuntu nuevo: verifica requisitos (Node.js, npm, cliente mysql, systemd, espacio, puertos libres), pregunta dominio, puertos y base de datos (MariaDB local auto-instalada o un servidor existente), genera backend/.env con secretos aleatorios, corre migraciones + catalogos, compila el frontend y crea/arranca los servicios systemd. No crea usuarios: el primer registro publico se vuelve superadmin solo (bootstrap ya existente). Probando el instalador de punta a punta contra una base de datos recien creada goo un bug real: la migracion 006_seed_it_baseline.sql (datos de ejemplo especificos de LinkedCorp) fallaba por foreign key al no existir todavia catalogos ni usuario. Corregido para que detecte esa situacion y quede inerte en instalaciones nuevas, sin tocar el comportamiento ya probado en dev/prod. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
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
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
- Configuración (catálogos)
Arranque rapido
Backend
cd backend
npm install
cp .env.example .env # completar con las credenciales reales
npm run dev
Frontend
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.exampleyCONFIGURACION.md. - Base de datos dev:
project_linkedcorpen192.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).