1
El problema
La gestión comercial de proyectos energéticos suele depender de procesos manuales, herramientas dispersas y flujos poco estructurados, lo que dificulta el seguimiento de clientes, cotizaciones y estados del proceso.
energysalesoperationsbackendMVPsaas2026En desarrollo
// project case study
Solvexis Sales System
Backend MVP para la gestión comercial y operativa de proyectos energéticos.
Node.jsTypeScriptPostgreSQLREST API
2
La solución
Solvexis propone un backend centralizado que organiza usuarios, clientes y cotizaciones dentro de un sistema estructurado, permitiendo control de roles, trazabilidad del proceso comercial y base para escalabilidad futura.
3
Arquitectura del sistema
Arquitectura backend-first basada en una API REST con enfoque modular, separación de capas (API, aplicación, dominio y persistencia) y uso de base de datos relacional para soportar flujos comerciales y operativos.
✓
Resumen del proyecto
Sistema backend orientado a centralizar la gestión de clientes, cotizaciones y seguimiento comercial en entornos de energía solar, diseñado como un MVP con arquitectura modular, API REST y modelado de datos relacional.
// editorial notes
Estado y evolución del proyecto
Esta sección reúne notas editoriales complementarias, avances, próximos pasos y observaciones del proceso.
Contexto
Solvexis Sales System surge como la evolución de un sistema previo de gestión administrativa y comercial utilizado en un contexto energético.
En lugar de replicar la solución original, el proyecto se replantea como un MVP backend diseñado desde cero con mejores prácticas de arquitectura, modelado de datos y diseño de APIs.
El objetivo es construir una base sólida que permita gestionar el flujo comercial completo de proyectos energéticos, desde la captación de clientes hasta el seguimiento de cotizaciones.
Enfoque
El sistema se diseña con una filosofía backend-first, priorizando la lógica de negocio y la estructura del dominio sobre la interfaz de usuario.
El MVP se enfoca en resolver el núcleo del problema:
- gestión de usuarios internos
- control de acceso por roles
- administración de clientes
- creación y seguimiento de cotizaciones
- trazabilidad del proceso comercial
Se evita intencionalmente la sobreingeniería para mantener el alcance realista y enfocado en un backend funcional.
Features
Funcionalidades principales del MVP
- Autenticación de usuarios
- Control de roles (
admin,sales) - CRUD de clientes
- Creación de cotizaciones asociadas a clientes
- Seguimiento del estado de cotizaciones
- Registro de notas u observaciones
- Base para evolución hacia métricas y reportes
Arquitectura
El sistema se plantea como un modular monolith, ideal para la etapa MVP por su simplicidad y facilidad de evolución.
Capas del sistema
-
API Layer
Exposición de endpoints REST para autenticación, clientes y cotizaciones. -
Application Layer
Implementación de casos de uso y flujos del sistema. -
Domain Layer
Reglas de negocio relacionadas con usuarios, clientes y cotizaciones. -
Persistence Layer
Acceso a datos mediante una base relacional (PostgreSQL).
Módulos principales
authusersclientsquotes
Decisiones técnicas clave
- Backend en Node.js con TypeScript
- Persistencia relacional para consistencia de datos
- Diseño modular para facilitar mantenimiento
- Enfoque en claridad sobre complejidad
Estado actual
El proyecto se encuentra en fase conceptual/prototipo, enfocado en:
- definición del alcance MVP
- estructuración del dominio
- diseño de arquitectura
- modelado inicial de datos
Aún no se cuenta con una implementación completa del backend, por lo que el estado refleja de manera honesta el avance actual.
Próximos pasos
- Definir modelo de datos detallado
- Diseñar endpoints principales del sistema
- Implementar backend inicial en Node.js
- Integrar base de datos PostgreSQL
- Validar flujos comerciales básicos
- Preparar entorno para iteración hacia MVP funcional
Aprendizajes
Este proyecto representa la transición hacia un enfoque más sólido en backend y arquitectura.
Principales aprendizajes:
- cómo transformar un sistema previo en un MVP bien definido
- cómo identificar el núcleo del dominio antes de implementar
- cómo estructurar un backend modular sin sobreingeniería
- cómo documentar decisiones técnicas de forma clara
- cómo construir sistemas pensando en evolución futura