🚀 ServidorCargoPlanner - Sistema de Gestión de Operaciones

Planificación inteligente de operaciones y gestión eficiente de personal

Características • Descripción • Instalación • Configuración • Uso • Documentación • Tecnologías

📋 Descripción

ServidorCargoPlanner es un sistema de gestión diseñado específicamente para optimizar la planificación de operaciones y la asignación de trabajadores en entornos empresariales.

Esta solución integral permite a las organizaciones:

• Organizar eficientemente sus operaciones diarias
• Asignar personal basado en disponibilidad y habilidades
• Monitorear en tiempo real el estado de cada operación
• Gestionar áreas de trabajo y equipos específicos

La aplicación está construida como una API robusta con NestJS que se integra fácilmente con diferentes interfaces de usuario y sistemas existentes.

✨ Características

🧑‍💼 Gestión de Trabajadores Registro completo de personal Control de disponibilidad Asignación a departamentos Estados: Disponible, Asignado, Incapacitado	📅 Planificación de Operaciones Programación con fechas específicas Asignación de horarios de inicio y fin Definición de tareas y prioridades Estados: Pendiente, En Progreso, Completado
📊 Seguimiento en Tiempo Real Actualización automática de estados Notificaciones de cambios importantes Cronómetro de operaciones activas Historial de actividades	🔒 Sistema de Seguridad Autenticación mediante JWT Control de acceso por roles Protección de endpoints Invalidación de sesiones

🛠️ Instalación

# Clonar el repositorio
$ git clone https://github.com/DuvanBonilla/ServidorCargoPlanner.git

# Acceder al directorio del proyecto
$ cd ServidorCargoPlanner

# Instalar dependencias
$ npm install

⚙️ Configuración

1. Archivo de entorno

Crea un archivo .env en la raíz del proyecto:

# Base de datos
DATABASE_URL="postgresql://usuario:contraseña@localhost:5432/plannerop?schema=public"

# JWT
SECRET_JWT="tu_clave_secreta_aqui"
EXPIRES_IN="1d"

2. Configuración de la base de datos

# Ejecutar migraciones de Prisma
$ npx prisma migrate dev

# Generar cliente Prisma
$ npx prisma generate

🔧 Uso

# Modo desarrollo
$ npm run start:dev

# Modo producción
$ npm run start:prod

# Compilar el proyecto
$ npm run build

📚 Documentación

Documentación de la API

Una vez que el servidor esté en funcionamiento, puedes acceder a la documentación interactiva de la API en:

http://localhost:3000/api

Generar documentación técnica

Para generar la documentación técnica del código:

# Generar documentación
$ npm run doc

# La documentación estará disponible en la carpeta /docs

📡 Endpoints principales

Método	Endpoint	Descripción
GET	/operations	Obtener todas las operaciones
POST	/operations	Crear una nueva operación
GET	/workers	Obtener todos los trabajadores
POST	/workers	Registrar un nuevo trabajador
POST	/auth/login	Iniciar sesión
POST	/auth/logout	Cerrar sesión
GET	/areas	Obtener todas las áreas de trabajo

💻 Tecnologías

• NestJS: Framework para construcción de aplicaciones eficientes y escalables
• Prisma: ORM moderno para interacción con bases de datos
• PostgreSQL: Sistema de gestión de base de datos relacional
• JWT: Sistema de autenticación basado en tokens
• TypeScript: Lenguaje de programación tipado
• Swagger: Documentación de API interactiva

📝 Licencia

Este proyecto está licenciado bajo la Licencia MIT.

📞 Contacto

Para preguntas o sugerencias, puedes contactar al equipo de desarrollo:

• Email: deyler456@gmail.comolvadis2004@gmail.com
• GitHub: KeniBeckGhostRiderDev

---

Desarrollado con ❤️ por el Equipo