El cliente
CDR Consulting es una consultora peruana especializada en contratos de construcción internacional bajo los estándares FIDIC, JCT y NEC — los tres frameworks contractuales que rigen la mayoría de la obra pública e infraestructura privada de gran escala en el mundo. Su equipo de consultores trabaja diariamente con un acervo extenso de literatura técnica especializada.
El desafío
Consultar más de 3,800 documentos técnicos (reglamentos, contratos modelo, jurisprudencia, publicaciones de la ICC, entre otros) de forma manual era inviable. La información estaba dispersa entre carpetas locales, dispositivos personales y archivos físicos. Encontrar un documento puntual tomaba horas. No había sistema de búsqueda unificada, ni forma estructurada de incorporar nuevo material, ni control sobre quién había consultado qué.
CDR necesitaba una plataforma propia — no una solución genérica de gestión documental — que respetara la forma en que un consultor jurídico organiza y consulta literatura especializada.
La solución
Construimos una biblioteca digital a medida que centraliza el acervo completo con visor PDF integrado en el navegador (sin descarga obligatoria), búsqueda por título, autor, idioma y tipo de documento, organización por colecciones temáticas (FIDIC, JCT, ICC), sistema de favoritos, generación automática de citas en formatos académicos (APA, MLA, Chicago) y panel administrativo para catalogación masiva.
El dashboard analítico expone métricas reales de uso — libros más consultados, número de lecturas registradas — para que la administración tome decisiones sobre qué material adquirir o destacar.
Capacidades principales
- Catálogo digital de 3,867 libros organizados en 13 colecciones temáticas
- Visor PDF integrado en el navegador (sin descarga obligatoria)
- Búsqueda multi-criterio (título, autor, idioma, tipo de documento)
- Generación automática de citas bibliográficas (APA / MLA / Chicago)
- Sistema de favoritos y solicitudes de préstamo
- Control de acceso con roles (admin / lector) y restricciones por libro o usuario
- Panel administrativo para alta, edición y catalogación masiva
- Dashboard analítico con métricas de lecturas y consultas
Stack técnico
Frontend: React 18 + Vite 4 · Zustand · Bootstrap 5 · Formik + Yup · pdfjs-dist + react-pdf · Chart.js · React Router DOM 6
Backend: Node.js + Express 4 · MySQL2/Promise · JWT + bcrypt (cookies httpOnly) · Multer
Base de datos: MariaDB 10.11 con modelo relacional normalizado
Infraestructura y DevOps
- VPS Linux (Ubuntu 20.04) con dos entornos paralelos: staging (
cdr.prodixperu.com) y producción (biblioteca.cdrconsulting.pe) - PM2 como process manager de Node con auto-restart y monitoreo
- Nginx como reverse proxy con SSL/TLS
- CI/CD con GitHub Actions y flujo Git Flow: push a
developdespliega a staging, push amaina producción - Verificación post-deploy automatizada (healthcheck backend, validación de build frontend,
nginx -tantes de reload) - Cookies httpOnly para sesión JWT, CORS restringido al dominio de producción
Estado
En producción en biblioteca.cdrconsulting.pe, operando como herramienta principal de consulta del equipo de CDR Consulting.