Diario Mercantil de Venezuela
Sistema para recibir, validar, cobrar, compaginar y publicar avisos legales, con ediciones digitales y verificación pública de cada publicación mediante código QR.
- Sector
- Publicaciones legales y mercantiles
- Período
- Ene. 2026 – actualidad
- Estado
- En producción
Contexto
El Diario Mercantil publica documentos legales y avisos mercantiles. Cada publicación implica recibir documentos, calcular la tarifa, verificar el pago, maquetar la edición y permitir su consulta posterior.
Problema o necesidad
Con un proceso manual, cada solicitud pasa por correo, revisión de comprobantes, cálculo de folios e impuestos y montaje de la edición, y después es difícil demostrar públicamente que un aviso fue publicado.
Objetivo de la solución
Digitalizar el ciclo completo con estados claros, montos calculados por el sistema, ediciones compaginadas y una forma pública de verificar cada publicación.
Arquitectura general
API PHP con enrutador propio, repositorios PDO sobre MySQL y migraciones versionadas; frontend React + TypeScript con Vite. Procesos en segundo plano para la cola de tareas y para el envío de correo desde un outbox. Despliegue en VPS con Docker Compose detrás de Traefik o Caddy con TLS, y scripts de healthcheck, readiness y actualización.
Mi participación
Desarrollo Full-Stack y operación: backend PHP, frontend React, base de datos, despliegue en VPS con Docker y mantenimiento.
Funcionalidades implementadas
- Flujo de solicitudes: borrador, enviada, verificada, en edición y publicada.
- Cálculo de montos por folios, tasa BCV e IVA, con obtención automática de la tasa y fuente alternativa.
- Carga de comprobantes y documentos en PDF; órdenes de servicio y recibos generados en PDF.
- Compaginación y publicación de la edición diaria, con visor PDF y formato revista.
- Verificación pública por código QR y rutas públicas para cada publicación y edición.
- Roles SuperAdmin, Administrador y Solicitante, con suspensión y restauración de cuentas.
- Directorio de abogados con aprobación administrativa y gestor de páginas y noticias.
- Registro de auditoría de las acciones críticas.
Desafíos técnicos y decisiones
- Hacer verificable una publicación sin exponer el expediente: la consulta pública muestra la publicación, no los documentos privados de la solicitud.
- Generar ediciones consistentes a partir de muchos documentos independientes, con herramientas de auditoría y reparación de ediciones.
- Enviar correo sin bloquear la API: los mensajes se guardan en un outbox y los procesa un worker independiente.
Tecnologías utilizadas
Seguridad y operación
Roles jerárquicos con política de permisos, sesiones con expiración, política de contraseñas, auditoría con registro de IP, configuración por variables de entorno y scripts de mantenimiento separados del despliegue normal. GitHub Actions ejecuta la integración continua del repositorio.
Capturas
La captura disponible es la portada de este caso. Otras vistas (paneles internos, flujos) están pendientes de documentar con datos anonimizados.
Estado actual
En producción El sistema está publicado y en uso en el enlace indicado.
Resultados comprobables
Sistema desplegado en diariomercantil.com. Repositorio público con más de 470 commits.
Repositorio y demo
Construyamos tu próximo sistema
Cuéntame el proceso que quieres resolver; te respondo con preguntas concretas o un siguiente paso.