Documentación del Sistema

Appearance

Modelos ​

Modulo: CRM Tipo: Resource Estado: Implementado Fecha: 2026-02-02

Descripcion ​

El catalogo de Modelos permite registrar los modelos de productos relacionados con las interacciones de atencion al cliente. Este catalogo es particularmente util cuando los registros de atencion se relacionan con productos especificos que tienen diferentes versiones o modelos.

Valor de negocio: Permite vincular las interacciones de servicio con modelos especificos de productos, facilitando el analisis de problemas recurrentes por modelo y la gestion de garantias o seguimiento tecnico.

Frontend (Perspectiva de Usuario) ​

Vistas ​

  • Listado de modelos: Vista principal que muestra todos los modelos en formato de tabla con las columnas Codigo, Descripcion y Activo
  • Formulario de alta/modificacion: Ventana modal para crear o editar un modelo

Interacciones del usuario ​

  1. Consultar modelos: El usuario accede al listado y puede visualizar todos los modelos disponibles
  2. Buscar modelos: El usuario puede filtrar por codigo o por descripcion
  3. Crear nuevo modelo: El usuario ingresa la descripcion y marca si esta activo
  4. Editar modelo: El usuario selecciona un registro del listado para modificar sus datos
  5. Activar/Desactivar modelo: El usuario puede cambiar el estado activo directamente desde el listado haciendo clic en el checkbox

Permisos ​

  • Visualizacion de modelos
  • Creacion de modelos
  • Modificacion de modelos
  • Activacion/desactivacion de modelos

Estados de UI ​

  • Cargando: Indicador de carga mientras se obtienen los datos
  • Vacio: Mensaje cuando no existen modelos registrados
  • Error: Notificacion cuando ocurre un error en alguna operacion
  • Exito: Confirmacion visual cuando se completa una operacion correctamente
  • Deshabilitado temporal: Checkbox deshabilitado mientras se procesa cambio de estado

Backend (Perspectiva de Datos de Negocio) ​

Entidades de negocio ​

Modelo

  • Identificador unico (codigo)
  • Descripcion del modelo
  • Indicador de estado activo

Datos necesarios ​

DatoDescripcionObligatorio
CodigoIdentificador unico numerico, generado automaticamenteSi (autogenerado)
DescripcionNombre o descripcion del modelo (1-150 caracteres)Si
ActivoIndica si el modelo esta disponible para su usoSi (por defecto: Si)

Validaciones de negocio ​

  • Descripcion requerida: La descripcion no puede estar vacia
  • Longitud maxima: La descripcion no puede exceder 150 caracteres
  • Estado activo: Valor booleano (Si/No)

Reglas de negocio ​

  • RN-001: El codigo del modelo se genera automaticamente utilizando el maximo codigo existente mas uno
  • RN-002: La descripcion del modelo debe tener entre 1 y 150 caracteres
  • RN-003: Los modelos nuevos se crean por defecto como activos
  • RN-004: Los modelos inactivos no se muestran en los selectores de registros de atencion
  • RN-005: Desactivar un modelo no afecta los registros de atencion existentes que lo referencian
  • RN-006: El estado activo puede cambiarse en cualquier momento desde el listado

Casos de uso ​

Caso 1: Crear nuevo modelo ​

Actor: Usuario administrador de CRM

Precondiciones:

  • El usuario debe estar autenticado en el sistema
  • El usuario debe tener permisos para crear modelos

Flujo principal:

  1. El usuario navega a CRM > Bases > Modelos
  2. El usuario hace clic en el boton para agregar nuevo modelo
  3. Se abre el formulario de nuevo modelo
  4. El usuario ingresa la descripcion del modelo (ej: "Modelo A 2024", "Version Premium", "Serie X")
  5. El usuario verifica que la opcion "Activo" este marcada (por defecto activo)
  6. El usuario hace clic en Guardar
  7. El sistema valida los datos y registra el nuevo modelo
  8. El sistema muestra un mensaje de confirmacion
  9. El listado se actualiza mostrando el nuevo modelo

Postcondiciones:

  • Se crea un nuevo modelo con codigo autogenerado
  • El modelo queda disponible para ser utilizado en registros de atencion

Flujos alternativos:

  • Descripcion vacia: Si la descripcion esta vacia, el sistema muestra error
  • Descripcion muy larga: Si la descripcion excede 150 caracteres, el sistema muestra error

Caso 2: Desactivar modelo desde el listado ​

Actor: Usuario administrador de CRM

Precondiciones:

  • El usuario debe estar autenticado en el sistema
  • El usuario debe tener permisos para modificar modelos
  • Debe existir al menos un modelo activo

Flujo principal:

  1. El usuario navega a CRM > Bases > Modelos
  2. El usuario localiza el modelo que desea desactivar
  3. El usuario hace clic en el checkbox de la columna "Activo"
  4. El sistema procesa el cambio (checkbox temporalmente deshabilitado)
  5. El sistema actualiza el estado del modelo a inactivo
  6. El listado se actualiza mostrando el modelo con checkbox desmarcado

Postcondiciones:

  • El modelo queda marcado como inactivo
  • El modelo ya no aparece en los selectores de nuevos registros de atencion
  • Los registros existentes que usan este modelo no se ven afectados

Caso 3: Modificar descripcion de modelo ​

Actor: Usuario administrador de CRM

Precondiciones:

  • El usuario debe estar autenticado en el sistema
  • El usuario debe tener permisos para modificar modelos
  • Debe existir al menos un modelo registrado

Flujo principal:

  1. El usuario navega a CRM > Bases > Modelos
  2. El usuario localiza el modelo que desea modificar
  3. El usuario hace clic en el registro para editarlo
  4. Se abre el formulario con los datos actuales
  5. El usuario modifica la descripcion y/o el estado activo
  6. El usuario hace clic en Guardar
  7. El sistema valida y actualiza los datos

Postcondiciones:

  • Los datos del modelo quedan actualizados

Consideraciones ​

Seguridad ​

  • Solo usuarios autenticados pueden acceder al catalogo
  • Las operaciones de escritura requieren permisos especificos

Auditoria ​

  • Se registra quien crea y modifica los modelos
  • Se registran los cambios de estado activo/inactivo

Rendimiento ​

  • El listado incluye limite de resultados al buscar (10 registros)
  • Los modelos pueden filtrarse por estado activo para optimizar consultas

Dependencias ​

Funcionalidades relacionadas ​

  • Registro de Atencion CRM: Utiliza el modelo para vincular la interaccion con un producto especifico
  • CRM de Ventas: Los modelos se utilizan en registros de servicio tecnico y post-venta
  • Reportes de CRM: Agrupa y analiza registros por modelo de producto

Criterios de aceptacion ​

  • [ ] AC-001: El usuario puede visualizar un listado de todos los modelos
  • [ ] AC-002: El listado muestra codigo, descripcion y estado activo de cada modelo
  • [ ] AC-003: El usuario puede filtrar modelos por codigo o descripcion
  • [ ] AC-004: El usuario puede crear un nuevo modelo ingresando descripcion y estado
  • [ ] AC-005: El sistema genera automaticamente el codigo del modelo
  • [ ] AC-006: El sistema valida que la descripcion no exceda 150 caracteres
  • [ ] AC-007: Los modelos nuevos se crean como activos por defecto
  • [ ] AC-008: El usuario puede activar/desactivar un modelo directamente desde el listado
  • [ ] AC-009: El checkbox de activo se deshabilita temporalmente mientras se procesa el cambio
  • [ ] AC-010: El usuario puede editar un modelo existente desde el formulario modal