This project (Coverly) has been created solely as an academic exercise to demonstrate knowledge in software architecture and full-stack development.
- Academic Nature: All content, including the business logic, architecture, and documentation, is fictitious and intended for demonstration purposes only.
- No Affiliation: This project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with any real insurance company or existing organization.
- Non-Profit Use: This software is distributed under the specified license (GPLv3) for non-profit educational purposes and is not intended for commercial use or production environments.
"Coverage with confidence"
Coverly es una plataforma web interna diseñada para transformar la gestión de seguros. Asiste a los agentes en la toma de decisiones comerciales mediante análisis automatizado, gestión centralizada de clientes y un motor de recomendaciones inteligentes.
- Visión del Proyecto
- Arquitectura Técnica
- Funcionalidades Clave
- Estructura del Proyecto
- Instalación y Configuración
- Documentación
- Roadmap
- Licencia
El objetivo de Coverly es migrar la interacción comercial de un proceso manual a uno guiado por datos. Actualmente, los agentes invierten demasiado tiempo analizando perfiles y comparando productos manualmente.
Coverly resuelve esto centralizando la información y utilizando un Motor Inteligente para generar rankings de productos, estrategias de upselling y cross-selling, mejorando así la tasa de conversión y la consistencia en las ofertas.
El sistema sigue un estilo arquitectónico de Monolito Modular Cloud-Native, diseñado para ser desplegado en contenedores (Docker) sobre infraestructura PaaS en AWS.
Core (Frontend/Backend): Aplicación unificada construida con Next.js 16+ (App Router), React 19, y Tailwind CSS complementados con HeroUI v3 y Lucide React. Cuenta con Prisma como ORM para la persistencia, y usa react-hook-form, zod, y bcryptjs para la validación de formularios y seguridad de credenciales.
Motor Inteligente: Servicio aislado desarrollado en Python con FastAPI para la evaluación de reglas y scoring, listo para entornos contenerizados.
Base de Datos: PostgreSQL gestionada e instanciada en local vía docker-compose, y prevista para migrar a servicios gestionados (AWS RDS) en producción.
Infraestructura: Despliegues gestionados a través de Docker y previstos para PaaS como AWS Elastic Beanstalk.
Coverly incluye:
-
Gestión de Usuarios y Roles: Control de acceso seguro para Agentes, Supervisores y Administradores.
-
Perfilado de Clientes: Registro de datos personales, perfil económico y evaluación de riesgo.
-
Catálogo de Productos: Gestión completa de seguros, coberturas y restricciones.
Motor de Recomendación: Algoritmos que evalúan la elegibilidad y generan un ranking de las mejores opciones para cada cliente.
Estrategias Comerciales: Sugerencias automáticas de promociones y oportunidades de venta cruzada.
Reportes y Analítica: Métricas de conversión y desempeño comercial.
La aplicación está dividida en dos componentes principales, apoyados de su documentación y herramientas de despliegue local:
coverly/
├── coverly-core/ # Sistema principal (Next.js, NextUI, Auth, Prisma)
├── coverly-engine/ # Motor Inteligente de recomendaciones (Python, FastAPI)
├── docs/ # Documentación técnica y funcional
├── docker-compose.yml # Configuración de base de datos PostgreSQL local
├── LICENSE # Licencia GNU GPLv3
└── README.md # Este archivoSigue estos pasos para levantar un entorno de desarrollo local.
Asegúrate de tener instalados:
- Node.js (v20 o superior)
- Python (v3.10 o superior)
- Docker y Docker Compose
- PostgreSQL (si decides instanciarla de forma local)
-
Copia el archivo de variables de entorno de ejemplo:
cp .env.example .env
-
Configura los valores necesarios de puerto, conexión a la DB y secretos en
.env.
Para aprovisionar la base de datos requerida y otros servicios, desde la raíz del proyecto usa:
docker-compose up -d(Nota: Se deben configurar las variables de entorno para que los contenedores sincronicen correctamente).
Si optas por correr cada servicio independientemente (asegúrate de que la BD ya está corriendo):
-
Core (Next.js):
cd coverly-core npm install npm run dev -
Motor de Recomendación (Python/FastAPI):
cd coverly-engine # Se recomienda crear tu venv: python -m venv venv && source venv/bin/activate pip install -r requirements.txt fastapi dev main.py
Para entender a profundidad el sistema, consulta los siguientes documentos oficiales:
-
Visión del Sistema: El "por qué" del proyecto.
-
Identidad de Producto: Guía de estilo, tono y paleta de colores.
-
Arquitectura General: Visión de alto nivel de la infraestructura.
-
Arquitectura de Módulos: Detalle de los límites funcionales y dependencias.
-
Requisitos del Sistema: Listado de RF y RNF.
-
Contratos API Base: Definición de endpoints y payloads JSON.
-
Modelo de Dominio: Entidades y relaciones de la base de datos.
-
Metodología y Plan: Fases, roles y estrategia de desarrollo iterativo.
El desarrollo se rige por la metodología Agile Modular Iterativo (AMI):
-
Fase 0: Diseño y Setup (Arquitectura, CI/CD). [Completada]
-
Iteración 1: Núcleo del sistema (Auth, CRUD Clientes/Productos). [Completada]
-
Iteración 2: Inteligencia Comercial (Motor de recomendaciones, Promociones). [Completada]
-
Iteración 3: Integración Completa (Estética UI/UX premium, Componentes unificados, Análisis AI integral). [Completada]
-
Iteración 4: Sistema End-to-End y estabilización. [En Progreso]
Este proyecto está distribuido bajo la licencia GNU General Public License v3.0. Consulta el archivo LICENSE para más detalles.