Documentación del Sistema

Appearance

Tipo de Contacto ​

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

Descripcion ​

El catalogo de Tipo de Contacto permite clasificar a las personas con las que se interactua en el sistema CRM. Define el rol o categoria del contacto dentro de la relacion comercial con el cliente.

Valor de negocio: Permite identificar y segmentar los contactos segun su funcion, facilitando la comunicacion dirigida y el seguimiento de relaciones con diferentes interlocutores dentro de una organizacion cliente.

Frontend (Perspectiva de Usuario) ​

Vistas ​

  • Listado de tipos de contacto: Vista principal que muestra todos los tipos de contacto en formato de tabla con las columnas Codigo y Nombre
  • Formulario de alta/modificacion: Ventana modal para crear o editar un tipo de contacto

Interacciones del usuario ​

  1. Consultar tipos de contacto: El usuario accede al listado y puede visualizar todos los tipos disponibles
  2. Buscar tipos de contacto: El usuario puede filtrar por codigo o por nombre
  3. Crear nuevo tipo de contacto: El usuario hace clic en "Nvo. Tip. Contacto" (atajo Alt+A) y completa el formulario
  4. Editar tipo de contacto: El usuario selecciona un registro del listado para modificar sus datos

Permisos ​

  • Visualizacion de tipos de contacto
  • Creacion de tipos de contacto
  • Modificacion de tipos de contacto

Estados de UI ​

  • Cargando: Indicador de carga mientras se obtienen los datos
  • Vacio: Mensaje cuando no existen tipos de contacto registrados
  • Error: Notificacion cuando ocurre un error en alguna operacion
  • Exito: Confirmacion visual cuando se completa una operacion correctamente

Backend (Perspectiva de Datos de Negocio) ​

Entidades de negocio ​

Tipo de Contacto

  • Identificador unico (codigo)
  • Nombre descriptivo del tipo de contacto

Datos necesarios ​

DatoDescripcionObligatorio
CodigoIdentificador unico numerico, generado automaticamenteSi (autogenerado)
NombreDescripcion del tipo de contacto (3-100 caracteres)Si

Validaciones de negocio ​

  • Nombre requerido: El nombre no puede estar vacio
  • Longitud minima: El nombre debe tener al menos 3 caracteres
  • Longitud maxima: El nombre no puede exceder 100 caracteres

Reglas de negocio ​

  • RN-001: El codigo del tipo de contacto se genera automaticamente al crear un nuevo registro
  • RN-002: El nombre del tipo de contacto debe tener entre 3 y 100 caracteres
  • RN-003: Los tipos de contacto tipicos incluyen: Titular, Responsable de Compras, Gerente, Tecnico, Administrativo
  • RN-004: El tipo de contacto se asigna a los contactos de clientes para clasificarlos

Casos de uso ​

Caso 1: Crear nuevo tipo de contacto ​

Actor: Usuario administrador de CRM

Precondiciones:

  • El usuario debe estar autenticado en el sistema
  • El usuario debe tener permisos para crear tipos de contacto

Flujo principal:

  1. El usuario navega a CRM > Bases > Tipos de Contacto
  2. El usuario hace clic en "Nvo. Tip. Contacto" o presiona Alt+A
  3. Se abre el formulario de nuevo tipo de contacto
  4. El usuario ingresa el nombre del tipo (ej: "Titular", "Encargado de Compras", "Gerente Comercial")
  5. El usuario hace clic en Guardar
  6. El sistema valida los datos y registra el nuevo tipo de contacto
  7. El sistema muestra un mensaje de confirmacion
  8. El listado se actualiza mostrando el nuevo tipo de contacto

Postcondiciones:

  • Se crea un nuevo tipo de contacto con codigo autogenerado
  • El tipo de contacto queda disponible para ser asignado a contactos de clientes

Flujos alternativos:

  • Nombre muy corto: Si el nombre tiene menos de 3 caracteres, el sistema muestra error
  • Nombre muy largo: Si el nombre excede 100 caracteres, el sistema muestra error

Caso 2: Modificar tipo de contacto existente ​

Actor: Usuario administrador de CRM

Precondiciones:

  • El usuario debe estar autenticado en el sistema
  • El usuario debe tener permisos para modificar tipos de contacto
  • Debe existir al menos un tipo de contacto registrado

Flujo principal:

  1. El usuario navega a CRM > Bases > Tipos de Contacto
  2. El usuario localiza el tipo de contacto 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 el nombre del tipo de contacto
  6. El usuario hace clic en Guardar
  7. El sistema valida y actualiza los datos

Postcondiciones:

  • Los datos del tipo de contacto quedan actualizados
  • Los contactos de clientes con este tipo mantienen la referencia

Consideraciones ​

Seguridad ​

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

Auditoria ​

  • Se registra quien crea y modifica los tipos de contacto

Rendimiento ​

  • El listado incluye limite de resultados al buscar (10 registros)
  • Soporte para carga por lotes de multiples tipos de contacto (batch loading)

Dependencias ​

Funcionalidades relacionadas ​

  • Contactos de Clientes: Los contactos se clasifican usando tipos de contacto
  • Registro de Atencion CRM: Al registrar interacciones se identifica el tipo de contacto
  • Reportes de CRM: Agrupa y filtra registros por tipo de contacto

Criterios de aceptacion ​

  • [ ] AC-001: El usuario puede visualizar un listado de todos los tipos de contacto
  • [ ] AC-002: El listado muestra codigo y nombre del tipo de contacto
  • [ ] AC-003: El usuario puede filtrar tipos de contacto por codigo o nombre
  • [ ] AC-004: El usuario puede crear un nuevo tipo de contacto ingresando el nombre
  • [ ] AC-005: El sistema genera automaticamente el codigo del tipo de contacto
  • [ ] AC-006: El sistema valida que el nombre tenga entre 3 y 100 caracteres
  • [ ] AC-007: El usuario puede editar el nombre de un tipo de contacto existente
  • [ ] AC-008: El atajo de teclado Alt+A abre el formulario de nuevo tipo de contacto