Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/alber1802/AvaluoVehicular/llms.txt

Use this file to discover all available pages before exploring further.

Esta guía te lleva desde cero hasta tener la aplicación corriendo y tu primer avalúo técnico generado, en menos de cinco minutos. Elige el método de instalación que mejor se adapte a tu entorno — Docker es la opción recomendada porque levanta todos los servicios sin necesidad de configurar PHP, Node.js ni SQLite manualmente — y luego sigue el flujo paso a paso para completar tu primer registro de vehículo y descargar el reporte en PDF.
Para instrucciones detalladas de cada método de instalación, incluyendo variables de entorno, configuración de correo y comandos de mantenimiento, consulta las guías completas en /installation/local y /installation/docker.

Instalación

1

Clona el repositorio

Descarga el código fuente en tu máquina local:
git clone https://github.com/alber1802/AvaluoVehicular.git
cd AvaluoVehicular
2

Ejecuta la configuración inicial

Este comando instala todas las dependencias de PHP y Node.js, copia el archivo de entorno, genera la clave de aplicación, ejecuta las migraciones y compila los assets de frontend — todo en un solo paso.
chmod +x docker.sh
./docker.sh setup
3

Inicia la aplicación

./docker.sh start
4

Abre la aplicación en tu navegador

La aplicación estará disponible en:
http://localhost:8080
Si es tu primera vez, navega a http://localhost:8080/register para crear tu cuenta de evaluador. No hay credenciales por defecto — el registro está abierto para el primer usuario.

Tu Primer Avalúo

Con la aplicación en marcha, sigue estos pasos para completar un avalúo técnico de principio a fin:
1

Regístrate e inicia sesión

Navega a /register, completa el formulario con tu nombre, correo y contraseña, y accede al dashboard principal. Opcionalmente, puedes activar la autenticación de dos factores (2FA) desde la configuración de tu perfil.
2

Inicia un nuevo registro

En el menú de navegación, haz clic en Registro. Se abrirá el formulario de creación de avalúo. Aquí comenzarás capturando la información del vehículo.
3

Completa el formulario del vehículo

Rellena los datos del vehículo: entidad solicitante, fecha de evaluación, ubicación actual, tipo de vehículo, combustible, marca, modelo, año de fabricación, placa, serie de motor, chasis, color, procedencia, kilometraje y precio referencial. Todos estos campos se persisten en el modelo Vehiculo.
4

Selecciona el tipo de evaluación

Elige entre dos modalidades de evaluación complementarias:
  • Mecánica — evalúa el estado de cada sistema mecánico del vehículo (motor, transmisión, frenos, suspensión, etc.).
  • Inspección — registra la condición visual y general del vehículo, capturando daños, desgastes o irregularidades observables.
Puedes completar ambas modalidades en el mismo avalúo.
5

Guarda la evaluación

Al finalizar cada sección, guarda el progreso. El sistema calculará automáticamente los factores de depreciación por modelo, por kilometraje y por inspección, y aplicará el factor de reposición para producir la final_estimacion almacenada en el modelo Avaluo.
6

Sube imágenes del vehículo

En la sección de imágenes, carga las fotografías del vehículo (exterior, interior, detalles de daños). Estas se asocian al registro a través del modelo VehiculoImagen y quedarán incluidas en el reporte final.
7

Revisa el resultado del avalúo

Navega a la sección Resultados para ver el resumen completo: datos del vehículo, depreciaciones aplicadas, valor final estimado y galería de imágenes. Desde aquí también puedes editar cualquier campo del avalúo o compartirlo con un tercero.
8

Descarga el reporte en PDF

Haz clic en el botón Descargar PDF para generar y descargar el reporte técnico completo del avalúo, listo para ser entregado al cliente o adjuntado a un expediente.

Build docs developers (and LLMs) love