Saltar al contenido
vfernandezg.devProyectosContacto
Todos los proyectos

TG Intranet · Tesla Group

Intranet corporativa que reemplazó un CRM SaaS y cadenas de hojas de cálculo por un solo sistema para ventas, cotizaciones, personal, logística y reportes.

Pantalla de inicio de sesión de la intranet de Tesla Group, con el logo de la empresa, los campos de correo corporativo y contraseña y el botón de ingreso
Rol
Responsable de TI. Desarrollo completo, gestión del proyecto y Scrum master
Periodo
jun 2026 — Actualidad
Estado
En curso
Tecnologías
  • Kotlin
  • Spring Boot
  • Angular
  • PostgreSQL
  • Python
  • Redis
  • Docker

Tesla Group es una empresa de ingeniería eléctrica e integración industrial de Trujillo, Perú. Construyo y opero su intranet sin más equipo de desarrollo: una aplicación Angular, un servicio central en Kotlin y un servicio de datos en Python sobre una misma base PostgreSQL. El código y el sistema son privados, así que esta página describe la arquitectura y deja fuera los datos de negocio.

Qué cubre

  • CRM: cuentas, embudo de oportunidades y propuestas.
  • Cotizador con revisiones y exportación a Excel, y catálogo de precios.
  • Cuadrillas y horas de campo, y codificación de productos de logística.
  • Tableros de ventas y de costos por proyecto.
  • Comparación de documentos: lee PDF de cotizaciones y órdenes de compra y propone campos para que una persona los verifique.

Los módulos de contabilidad y de órdenes de venta están en modo de práctica. Reflejan el ERP hasta que se haga el cambio.

Cómo funciona

Diagrama de arquitectura. Una aplicación Angular detrás de nginx, un servicio central en Kotlin, PostgreSQL y Redis, un servicio Python que replica el ERP y un worker de procesamiento de documentos

  • Monolito modular, hexagonal por contexto. Cada contexto de negocio es un par de módulos Gradle: un núcleo con dominio en Kotlin puro y un módulo adaptador con Spring. Los módulos de dominio no tienen Spring en el classpath, así que importarlo no compila.
  • Reglas como tests. Más de 50 reglas de ArchUnit cubren ciclos de dependencias, aislamiento entre contextos, “todo endpoint exige un permiso” y “todo cuerpo de petición se valida”.
  • Integración por la base de datos. El servicio Python replica el ERP SaaS a través de su API hacia PostgreSQL y reconstruye las tablas de reportes. No hay HTTP entre servicios. LISTEN/NOTIFY de PostgreSQL alimenta un hub de WebSocket que refresca las pantallas abiertas.
  • Control de acceso. Roles por sección y acción, con ajustes por usuario y alcance de datos. Los objetos fuera del alcance de un usuario responden 404. La bitácora de auditoría es de solo inserción, garantizada por un trigger de base de datos.
  • Procesamiento de documentos. Un worker con un rol de base de datos restringido toma corridas de una tabla de entrada, extrae con OCR y un modelo de lenguaje, y guarda una cita literal por cada campo. Propone; una persona decide.

Práctica de ingeniería

  • El CI fija las actions por commit y las imágenes por digest, escanea con gitleaks, Semgrep y Trivy, y publica imágenes solo desde la rama principal.
  • Las pruebas de integración corren contra PostgreSQL y Redis reales. Pruebas de referencia reproducen celda por celda un libro de cotización real.
  • Un modo sandbox ejecuta la misma imagen con datos sintéticos.

La intranet es además el tema de mi proyecto integrador y de mi tesis en la Universidad Privada Antenor Orrego.