DTIC Bitácoras es un sistema web completo de gestión de recursos tecnológicos y tareas para el Departamento de Tecnología de la Información y Comunicación (DTIC). Desarrollado con tecnologías modernas, permite administrar eficientemente el inventario de hardware/software, asignar recursos a usuarios, gestionar tareas técnicas y mantener un registro completo de todas las operaciones.

🎯 Propósito y Alcance

El sistema está diseñado para:

Gestión de Recursos: Controlar inventario de hardware, software, equipos de red y herramientas
Administración de Personal: Gestionar técnicos del DTIC con diferentes roles y permisos
Asignación de Recursos: Vincular recursos tecnológicos con usuarios finales
Seguimiento de Tareas: Administrar y monitorear tareas técnicas asignadas a técnicos
Auditoría Completa: Mantener registro detallado de todas las operaciones del sistema
Reportes y Estadísticas: Generar informes sobre el estado del inventario y rendimiento
Framework de Prompts DTIC: Sistema automatizado de gestión de flujos de trabajo y documentación para procesos de desarrollo optimizados

🚀 Inicio Rápido

Opción 1: Usando Script Optimizado (Recomendado)

# Configuración inicial automática (primera ejecución)
./app-run.sh

# Iniciar aplicación
./app-run.sh start

# Ver estado
./app-run.sh status

# Ver logs (requiere aplicación ejecutándose)
./app-run.sh logs

# Crear backup
./app-run.sh bd-backup

# Detener aplicación
./app-run.sh stop

Opción 2: Usando Docker Compose Manual

# Clonar el repositorio
git clone <repository-url>
cd dtic-bitacoras-php/_app-npm

# Ejecutar la aplicación completa
docker-compose up --build

# Acceder a la aplicación
# Frontend: http://localhost:5173
# Backend API: http://localhost:3001
# Base de datos: localhost:5432

🔧 Configuración para Despliegue Remoto

1. Variables de Entorno

Copia el archivo de ejemplo y configura tus variables:

cp .env.example .env
# Edita .env según tus necesidades

2. Configuración por Entorno

El archivo docker-compose.override.yml permite personalizar la configuración:

# Variables disponibles en .env
POSTGRES_PORT=5432
API_PORT=3001
FRONTEND_PORT=5173
NODE_ENV=production
# ... etc

3. Despliegue en Producción

# Configurar variables de producción en .env
NODE_ENV=production
VITE_API_URL=https://tu-dominio.com/api

# Desplegar
make up

🏗️ Arquitectura del Sistema

Arquitectura General

El sistema sigue una arquitectura de 3 capas con contenedores Docker:

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Frontend      │    │     Backend      │    │   Database      │
│   React/Vite    │◄──►│  Node.js/Express │◄──►│  PostgreSQL     │
│   Puerto 5173   │    │   Puerto 3001    │    │   Puerto 5432   │
└─────────────────┘    └─────────────────┘    └─────────────────┘

Componentes Principales

🖥️ Frontend (React + Vite)

Framework: React 18 con TypeScript
Estado Global: Zustand para gestión de estado
UI Components: Bootstrap + FontAwesome
Rutas: React Router con protección de rutas
Configuración: Sistema de entidades dinámicas vía YAML
Versionado Dinámico: Carga automática de versión desde package.json mediante Vite config

🚀 Backend (Node.js + Express)

Runtime: Node.js 18 con Alpine Linux
Framework: Express.js con middleware avanzado
Base de Datos: PostgreSQL con pool de conexiones
Autenticación: JWT con bcrypt para hashing
API: RESTful con validación de datos
Seguridad: Helmet, CORS, Rate Limiting

🗄️ Base de Datos (PostgreSQL)

Motor: PostgreSQL 15
Esquema: dtic con tablas normalizadas
Índices: Optimizados para búsquedas comunes
Auditoría: Triggers automáticos para updated_at
Datos de Ejemplo: Incluye usuarios y recursos de prueba

Entidades del Sistema

👥 Técnicos

Los técnicos son los profesionales especializados del DTIC que resuelven las tareas asignadas al departamento. Son los responsables directos de ejecutar y completar las actividades del sistema.