En este documento se detallan los requerimientos funcionales que tendrá el sistema MVP para passos generador de informes de tasaciones, conteniendo los siguientes items:
Crear un nuevo proceso de tasación asociado a un cliente y tipo de propiedad específico
Descripción
El Production Team puede iniciar un nuevo proceso de tasación seleccionando el tipo de tasación (comercial, residencial, industrial, etc.) y asociándolo a un cliente. El sistema registra la fecha de inicio, guarda el numero de servicio y establece el estado inicial del proceso.
Entrada
Tipo de tasación, información del cliente, datos básicos de la propiedad, usuario que inicia
Seleccionar el tipo de tasación que determinará la plantilla y estructura del reporte a generar
Descripción
Durante el inicio del proceso, el usuario selecciona el tipo de tasación de una lista configurada previamente. Esta selección determina qué plantilla se utilizará y qué campos serán necesarios para el informe. El proceso queda vinculado al tipo y se cargan los campos correspondientes.
Entrada
Selección del tipo de tasación desde dropdown
Salida
Plantilla asociada al tipo de tasación, campos requeridos según el tipo
Registrar los cálculos técnicos realizados durante la tasación
Descripción
El sistema permite ingresar o importar los cálculos realizados para la tasación: valores de terreno, construcción, depreciación, valores de mercado y cálculos finales del avalúo. Pueden ser ingresados manualmente o importados desde Excel.
Importar los datos capturados durante la inspección física de la propiedad
Descripción
El sistema permite cargar el informe de inspección generado desde Kiseo Forms . Los datos incluyen características físicas, medidas, estado de conservación y observaciones del inspector.
Entrada
Archivo de inspección (aun por definir)
Salida
Datos de inspección importados y mapeados, imágenes vinculadas, confirmación de carga
Permitir la edición de datos del informe de inspección que requieran ajustes o correcciones
Descripción
El Production Team puede modificar campos específicos del informe de inspección cuando se detectan errores o información incompleta. Cada modificación queda registrada en el historial de auditoría con Laravel Audit (usuario, fecha y campos modificados).
Entrada
Campos a modificar, nuevos valores, razón de la modificación (opcional)
Agregar campos adicionales no contemplados en la plantilla estándar para casos especiales
Descripción
Para tasaciones con características únicas, el usuario puede añadir campos personalizados al reporte. Estos campos se almacenan en cached_fields y quedan disponibles solo para este proceso específico.
Entrada
Nombre del campo, tipo de dato, valor del campo, sección donde se ubicará
Salida
Campo agregado al proceso y disponible en la generación del reporte
Vincular documentos adicionales necesarios para el reporte
Descripción
El sistema permite subir y vincular documentos de soporte que complementan la tasación (escrituras, planos, certificados, etc.). Los archivos se almacenan en Dropbox y se vinculan al proceso mediante referencias en la base de datos.
Entrada
Archivos (PDF, imágenes, Office), tipo de documento, descripción
Salida
Archivo almacenado en Dropbox, referencia en BD, URL de acceso
Crear el reporte de tasación en formato PDF siguiendo la plantilla institucional
Descripción
El sistema genera automáticamente un PDF del reporte utilizando la plantilla configurada para el tipo de tasación. Incluye todos los datos capturados, cálculos, imágenes y documentos en el formato oficial de la empresa.
Entrada
Proceso de tasación completo, plantilla PDF configurada, parámetros de generación
Salida
Archivo PDF generado, link de descarga, registro de generación con fecha y usuario
Crear versiones del reporte con ajustes específicos solicitados por clientes
Descripción
Permite generar variaciones del reporte estándar, seleccionando qué secciones incluir, modificando el orden, ajustando el formato o añadiendo secciones personalizadas según requerimientos específicos del cliente.
Entrada
Proceso de tasación base, configuración de personalización, plantilla personalizada (si existe)
Salida
Reporte personalizado en PDF, registro de la personalización aplicada
Crear, modificar y gestionar las plantillas de reportes que definen la estructura y formato de los documentos
Descripción
El administrador puede crear y configurar plantillas de reportes definiendo secciones, subsecciones, campos, tipos de datos, validaciones y formato de presentación. Las plantillas son versionadas y pueden ser asignadas a diferentes tipos de tasación. Las plantillas anteriores permanecen disponibles para reportes históricos.
Entrada
Nombre de la plantilla, tipo de tasación asociado, estructura de secciones y campos, configuración de formato, estado (activa/inactiva)
Salida
Plantilla creada y almacenada, nueva versión de plantilla, confirmación de activación
Extender la plantilla actual añadiendo nuevos campos para capturar información adicional
Descripción
El administrador puede agregar nuevos campos a secciones existentes, especificando nombre, tipo de dato, validaciones, si es obligatorio u opcional, y su posición en el reporte. Se genera una nueva versión de la plantilla. Los procesos existentes NO se ven afectados para mantener integridad histórica.
Entrada
ID de la plantilla, ID de la sección, nombre del campo, tipo de dato, validaciones, orden de visualización
Salida
Campo agregado a la plantilla, nueva versión de plantilla generada, campo disponible para futuros procesos
Definir y organizar las secciones que componen una plantilla de reporte
Descripción
El administrador puede crear, modificar, reordenar y eliminar secciones dentro de una plantilla. Cada sección puede tener subsecciones, y se configura su visibilidad (obligatoria, opcional, condicional), título, descripción y formato de presentación. Las modificaciones NO afectan reportes ya generados.
Entrada
ID de la plantilla, datos de la sección (nombre, descripción, tipo, orden, configuración de formato, subsecciones)
Salida
Sección configurada en la plantilla, estructura actualizada, nueva versión de plantilla
Acceder a reportes y datos de tasaciones anteriores para análisis y referencia
Descripción
El Production Team puede consultar el historial completo de tasaciones realizadas, incluyendo reportes generados, versiones anteriores, modificaciones realizadas y datos archivados. El sistema mantiene la integridad de los datos históricos incluso cuando se modifiquen plantillas actuales.
Entrada
Criterios de búsqueda (fecha, cliente, propiedad, folio, tipo de tasación), filtros adicionales
Salida
Lista de procesos históricos, acceso a reportes generados, visualización de datos completos
Prioridad
Alta
RFN02 - Ver reportes anteriormente generados PRNF02
Campo
Descripción
Código
RF12
Nombre
Ver reportes anteriormente generados
Propósito
Visualizar y descargar versiones anteriores de reportes del mismo proceso de tasación
Descripción
Permite acceder a todas las versiones de reportes generadas para un proceso específico, incluyendo PDF y versiones personalizadas. Útil para comparar cambios, recuperar versiones anteriores o enviar reportes previamente generados.
Entrada
ID del proceso de tasación, filtro de tipo de reporte, rango de fechas (opcional)
Salida
Lista de reportes generados con fecha, usuario y tipo, enlaces de descarga, preview del reporte
Consultar el registro completo de cuándo, quién y qué reportes se han generado para un proceso
Descripción
Muestra un timeline detallado de todas las generaciones de reportes realizadas para un proceso específico, incluyendo usuario que generó, fecha/hora, tipo de reporte, plantilla utilizada y versión de la plantilla.
Entrada
ID del proceso de tasación
Salida
Listado cronológico de generaciones con detalles: fecha, hora, usuario, plantilla, versión, indicadores de cambios
Visualizar todos los cambios realizados a los datos del proceso de tasación a lo largo del tiempo
Descripción
Integrado con Laravel Audit, muestra un registro detallado de todas las modificaciones realizadas a cualquier campo del proceso, incluyendo valores anteriores, nuevos valores, usuario que hizo el cambio y timestamp. Garantiza trazabilidad completa para auditorías y cumplimiento normativo.
Entrada
ID del proceso de tasación, filtros opcionales (campo específico, rango de fechas, usuario)
Salida
Listado de modificaciones con campo modificado, valor anterior → valor nuevo, usuario, fecha/hora exacta, IP
Comparar dos versiones de un reporte para identificar qué información cambió
Descripción
El sistema permite seleccionar dos versiones de reportes del mismo proceso y mostrar una comparación lado a lado o con resaltado de diferencias, identificando campos que cambiaron, fueron agregados o eliminados entre versiones.
Entrada
ID del proceso, ID de reporte versión A, ID de reporte versión B, tipo de visualización (lado a lado, diff resaltado)
Salida
Vista comparativa de ambas versiones, resaltado de diferencias, listado de campos modificados con valores anterior y nuevo
Visualizar cómo se verá un reporte generado con la plantilla antes de aplicarla a procesos reales
Descripción
El administrador puede generar una vista previa de la plantilla con datos de ejemplo o datos reales de un proceso existente. Esto permite validar el diseño, formato, orden de secciones y presentación de campos antes de activar la plantilla. No se genera ningún archivo permanente.
Entrada
ID de la plantilla, opción de datos (ejemplo o proceso real), ID de proceso (si se usa datos reales), formato de vista previa (PDF o web)
Salida
Vista previa del reporte en formato seleccionado, indicadores de campos vacíos o problemas de formato
Todos los reportes generados deben mantener estrictamente el formato institucional de Passos, incluyendo logotipo, colores corporativos, tipografías oficiales, estructura de encabezados y pies de página, y elementos de marca registrados. El formato debe ser consistente en todos los tipos de reportes (PDF y DOCX) y debe diferenciarse claramente de reportes de otras empresas de tasación.
Métrica
Cumplimiento formato: 100% de reportes Elementos de marca: Logotipo, colores, tipografía oficial en todos los documentos Revisión de calidad: Aprobación por departamento de imagen corporativa
El sistema debe implementar un sistema de autenticación robusto con login mediante credenciales. Debe existir un sistema de permisos basado en roles que limite el acceso a funcionalidades según el perfil del usuario: Admin (configuración completa), Production Team (gestión de procesos y generación de reportes), Consulta (solo lectura). Cada acción debe validar permisos antes de ejecutarse.
Métrica
Autenticación: 100% de accesos requieren login Validación de permisos: 100% de operaciones verifican rol Roles implementados: Mínimo 3 (Admin, Production Team, Consulta) Intentos fallidos: Bloqueo temporal después de 5 intentos
El sistema debe permitir la importación de reportes históricos en formato PDF para extraer automáticamente los datos relevantes y poblar la base de datos histórica.
Métrica
Tasa de extracción exitosa: ≥ 85% de campos clave Formatos soportados: PDF (texto y escaneado con OCR) Tiempo de procesamiento: ≤ 30 segundos por documento de hasta 50 páginas Validación manual: 100% de documentos importados requieren revisión
