Sistema de Gestión y Control de Contratos Estatales

1. Introducción

Este sistema tiene como propósito facilitar la gestión, seguimiento, control y vigilancia de contratos estatales por parte de distintas organizaciones. Fue construido utilizando Laravel 12, el sistema de autenticación Breeze, AdminLTE3 para el panel administrativo y el paquete Spatie para la gestión de roles y permisos.

🎯 Objetivos principales

• Administrar contratos estatales en múltiples organizaciones
• Asociar contratistas, pagos, documentos e investigaciones
• Permitir el acceso segmentado por roles y permisos
• Centralizar la configuración en una sola tabla dinámica

🧰 Tecnologías utilizadas

• Laravel 12 - Backend robusto en PHP
• AdminLTE3 - Panel administrativo moderno
• Laravel Breeze - Sistema de login básico
• Spatie - Control avanzado de roles y permisos
• FullCalendar - Calendario de eventos
• DataTables - Tablas dinámicas

🗂️ Roles Definidos

• Superadmin: Control total del sistema y acceso global
• Administrador: Gestión total de una organización
• Gestor: Asignación y supervisión de contratos
• Supervisor: Seguimiento a contratos asignados
• Contratista: Consulta de sus contratos e interacciones

2. Instalación y Configuración

📦 Requisitos del sistema

• PHP 8.2 o superior
• MySQL o MariaDB
• Composer
• Node.js (versión 18+)
• Extensiones de PHP: pdo, mbstring, openssl, bcmath, tokenizer, fileinfo, xml, ctype, json, curl, zip

🚀 Pasos de instalación

1. Clona el repositorio o descomprime el archivo ZIP
2. Instala las dependencias de PHP:

   composer install

3. Instala los paquetes de JavaScript:

   npm install && npm run dev

4. Copia el archivo de entorno y genera la clave:

   cp .env.example .env 
   php artisan key:generate

5. Edita el archivo .env y configura la base de datos:

   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=nombre_db
   DB_USERNAME=usuario
   DB_PASSWORD=contraseña
   APP_TIMEZONE=America/Bogota
   APP_LOCALE=es

6. Ejecuta migraciones y seeders:

   php artisan migrate --seed

7. Inicia el servidor:

   php artisan serve

   Luego accede desde tu navegador: http://localhost:8000

🌎 Idioma y zona horaria

El sistema está configurado para Español (Colombia) con la zona horaria America/Bogota. Se utiliza el paquete Laraveles/lang para traducciones.

🔧 Configuración adicional

Para personalizar la configuración del sistema, puedes modificar los siguientes parámetros en el archivo .env:

• APP_NAME: Nombre de la aplicación
• APP_ENV: Entorno de la aplicación (local, producción, etc.)
• APP_DEBUG: Habilitar o deshabilitar el modo de depuración

Para personalizar la configuración del sistema, puedes modificar los siguientes parámetros en el archivo .env:

• APP_NAME: Nombre de la aplicación
• APP_ENV: Entorno de la aplicación (local, producción, etc.)
• APP_DEBUG: Habilitar o deshabilitar el modo de depuración