Documentación del Sistema

Appearance

Extension CRM Servicio Tecnico ​

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

Descripcion ​

La extension de Servicio Tecnico amplia los registros base del CRM con campos especificos para gestionar equipos que ingresan al servicio tecnico. Esta extension permite registrar los accesorios que acompañan al equipo y su ubicacion fisica en la estanteria del taller.

Proposito de la Extension ​

  • Registrar accesorios que acompañan al equipo (cargador, funda, etc.)
  • Registrar ubicacion fisica del equipo en estanteria (fila y columna)
  • Facilitar la busqueda y devolucion de equipos
  • Mantener inventario de equipos en servicio tecnico

Frontend (Perspectiva de Usuario) ​

Vistas ​

  • Listado de Registros de Servicio Tecnico: Vista principal con grilla de registros y ubicaciones
  • Formulario de Alta/Edicion: Modal con campos base y campos especificos de servicio tecnico

Interacciones del Usuario ​

Creacion de Registro:

  1. Acceder al menu CRM y seleccionar tipo "Servicio Tecnico"
  2. Crear nuevo registro
  3. Completar campos base (fecha/hora, contacto, titulo describiendo el equipo, detalle del problema)
  4. Completar campos especificos:
    • Ingresar lista de accesorios que acompañan al equipo
    • Indicar fila de la estanteria donde se almacena
    • Indicar columna de la estanteria
  5. Guardar el registro

Consulta y Localizacion:

  • Buscar equipo por contacto/cliente
  • Buscar equipo por titulo o detalle
  • Localizar equipo por posicion en estanteria (fila/columna)

Permisos ​

  • CRM_SERV_TECNICO_VER: Visualizar registros de servicio tecnico
  • CRM_SERV_TECNICO_CREAR: Crear nuevos registros
  • CRM_SERV_TECNICO_EDITAR: Modificar registros existentes
  • CRM_SERV_TECNICO_ELIMINAR: Eliminar registros

Backend (Perspectiva de Datos de Negocio) ​

Entidades de Negocio ​

Extension de Servicio Tecnico ​

Almacena los campos especificos del tipo Servicio Tecnico vinculados al registro base.

Datos necesarios:

  • Identificador unico de la extension
  • Vinculo al registro base de CRM
  • Lista de accesorios (multiples valores de texto)
  • Fila de ubicacion en estanteria (numero)
  • Columna de ubicacion en estanteria (letra)

Relaciones de Negocio ​

  • Cada registro de CRM tipo Servicio Tecnico tiene exactamente UNA extension de servicio tecnico
  • Los accesorios se almacenan como una lista de textos libres (no hay catalogo predefinido)
  • La ubicacion (fila/columna) permite localizar fisicamente el equipo

Validaciones de Negocio ​

Campos Opcionales con Formato:

  • Fila: numero entero positivo (ej: 1, 2, 3...)
  • Columna: un caracter alfabetico (ej: A, B, C...)
  • Accesorios: lista de textos libres, sin limite de cantidad

Validaciones:

  • Si se indica fila, debe ser un numero valido
  • Si se indica columna, debe ser un caracter unico
  • Los accesorios pueden estar vacios

Reglas de Negocio ​

  • Regla 1: Ubicacion Fisica

    • Condicion: Al recibir un equipo en el taller
    • Accion: Se registra la posicion exacta (fila/columna) donde se almacena el equipo para facilitar su localizacion posterior

  • Regla 2: Registro de Accesorios

    • Condicion: Al recibir un equipo con accesorios
    • Accion: Se listan todos los accesorios entregados para evitar reclamos posteriores al momento de devolucion

  • Regla 3: Texto Libre en Accesorios

    • Condicion: No existe catalogo predefinido de accesorios
    • Accion: El operador ingresa los accesorios como texto libre, permitiendo describir cualquier item que acompañe al equipo

Casos de Uso ​

Caso 1: Recepcion de Equipo en Servicio Tecnico ​

Actor: Tecnico de recepcion

Precondiciones:

  • El usuario debe estar autenticado con permisos de CRM Servicio Tecnico
  • Debe existir el contacto/cliente en el sistema

Flujo principal:

  1. El cliente trae un equipo para reparacion
  2. El tecnico accede al modulo CRM tipo Servicio Tecnico
  3. Crea nuevo registro
  4. Busca y selecciona el contacto del cliente
  5. Ingresa titulo descriptivo (ej: "Notebook HP Pavilion - No enciende")
  6. Ingresa detalle del problema reportado
  7. Lista los accesorios que entrega el cliente:
    • "Cargador original"
    • "Funda de tela"
    • "Mouse inalambrico"
  8. Indica la ubicacion de almacenamiento: Fila 3, Columna B
  9. Guarda el registro
  10. Entrega comprobante al cliente

Postcondiciones:

  • Queda registrado el equipo con sus accesorios
  • La ubicacion fisica permite localizar el equipo
  • El cliente tiene respaldo de lo entregado

Flujos alternativos:

  • Sin accesorios: El campo de accesorios puede quedar vacio
  • Ubicacion no asignada: Puede dejarse sin ubicacion si el equipo se trabaja inmediatamente

Caso 2: Localizacion de Equipo para Devolucion ​

Actor: Tecnico de entrega

Precondiciones:

  • Existe el registro del equipo en el sistema
  • El cliente viene a retirar el equipo

Flujo principal:

  1. El cliente se presenta a retirar su equipo
  2. El tecnico busca el registro por nombre del cliente o descripcion del equipo
  3. Identifica el registro correspondiente
  4. Lee la ubicacion: Fila 3, Columna B
  5. Se dirige a la estanteria y localiza el equipo
  6. Verifica los accesorios listados contra lo que va a entregar
  7. Entrega el equipo con todos sus accesorios
  8. Marca el registro como finalizado/cancelado con motivo "Entregado"

Postcondiciones:

  • El equipo es devuelto al cliente
  • Quedan verificados los accesorios entregados
  • El registro se cierra con el motivo correspondiente

Caso 3: Reorganizacion de Estanteria ​

Actor: Supervisor de servicio tecnico

Precondiciones:

  • Existen equipos almacenados en el taller

Flujo principal:

  1. El supervisor necesita reorganizar la estanteria
  2. Accede al listado de registros activos (no cancelados)
  3. Filtra por rango de fechas o busca registros especificos
  4. Edita los registros actualizando las ubicaciones (fila/columna)
  5. Guarda los cambios

Postcondiciones:

  • Las ubicaciones reflejan la nueva organizacion
  • Los equipos pueden ser localizados en sus nuevas posiciones

Consideraciones ​

Seguridad ​

  • Solo usuarios con permisos de CRM Servicio Tecnico pueden acceder
  • Los datos del cliente estan protegidos por permisos del modulo de contactos

Auditoria ​

  • Se registra quien recibe cada equipo y cuando
  • Se mantiene historial de modificaciones
  • Las entregas quedan registradas con fecha y motivo

Rendimiento ​

  • Los accesorios se almacenan como lista, sin limite predefinido
  • La busqueda por ubicacion es directa (fila + columna)

Dependencias ​

Funcionalidades Relacionadas ​

  • Sistema base de CRM (registros, derivaciones, relaciones)
  • Modulo de contactos

Servicios Externos ​

  • Ninguno requerido

Criterios de Aceptacion ​

  • [ ] AC-001: El usuario puede crear un registro de servicio tecnico con accesorios
  • [ ] AC-002: El usuario puede indicar ubicacion en estanteria (fila/columna)
  • [ ] AC-003: Los accesorios se muestran como lista editable
  • [ ] AC-004: La busqueda por contacto o titulo funciona correctamente
  • [ ] AC-005: Se puede editar la ubicacion de un equipo existente
  • [ ] AC-006: Los campos de ubicacion aceptan el formato esperado (numero/letra)

Notas Adicionales ​

  • El sistema de accesorios usa texto libre para maxima flexibilidad
  • No existe validacion cruzada de ubicaciones (dos equipos pueden tener la misma ubicacion si el usuario lo ingresa asi)
  • La columna esta limitada a un solo caracter para simplicidad
  • Esta extension se habilita condicionalmente segun configuracion del tipo CRM "serv_tecnico"