Appearance
Tipos de Relacion
Modulo: Membresias Tipo: Resource Estado: Implementado Fecha: 2026-01-27
Descripcion
Problema que resuelve
Las instituciones que gestionan membresias necesitan agrupar a sus miembros en grupos familiares, donde cada integrante tiene un rol especifico dentro del grupo (titular, conyuge, hijo, etc.). Sin un catalogo de tipos de relacion:
- No es posible definir los roles familiares de forma estandarizada
- No se puede distinguir cual miembro es el titular del grupo familiar
- La conformacion de grupos familiares carece de estructura y consistencia
Solucion implementada
Se implemento un catalogo de tipos de relacion que permite:
- Administrar tipos de relacion: Crear, consultar y modificar los tipos de relacion familiar disponibles
- Marcar relacion principal: Indicar cual tipo de relacion identifica al miembro titular o principal del grupo familiar
- Alternancia rapida: Activar o desactivar la marca de "principal" directamente desde la tabla sin abrir el formulario
Valor de negocio
- Estandarizacion: Catalogo unico de roles familiares para toda la institucion
- Identificacion del titular: Permite determinar quien es el miembro principal de un grupo familiar para comunicaciones, facturacion y responsabilidades
- Flexibilidad: La institucion puede definir los tipos de relacion que mejor se adapten a su realidad (Principal, Conyuge, Hijo, Padre, Madre, Hermano, etc.)
Contexto del sistema
Este recurso forma parte del modulo de Membresias y se relaciona con:
- Grupos Familiares: Los tipos de relacion definen el rol de cada miembro dentro del grupo
- Miembros: Al asignar un miembro a un grupo familiar, se especifica su tipo de relacion
Frontend (Perspectiva de Usuario)
Vistas
- Listado de tipos de relacion: Tabla con todos los tipos de relacion disponibles, mostrando codigo, nombre e indicador de principal. Accesible desde Inicio > Bases > Tipos de Relacion
Interacciones del usuario
- Consultar tipos de relacion: El usuario visualiza la tabla completa de tipos de relacion con sus datos
- Crear tipo de relacion: El usuario abre el formulario, completa el nombre y opcionalmente marca si es principal
- Editar tipo de relacion: El usuario selecciona un tipo de relacion existente, modifica los campos deseados y guarda los cambios
- Alternar marca de principal: El usuario activa o desactiva la marca "Principal" directamente desde la tabla mediante un interruptor
Nota importante: La eliminacion de tipos de relacion no esta habilitada desde la interfaz de usuario.
Estados de UI
- Estado inicial: Tabla cargada con todos los tipos de relacion disponibles
- Estado cargando: Indicador de carga mientras se obtienen los datos
- Estado exito: Notificacion de confirmacion al crear o editar
- Estado error: Mensaje de error descriptivo cuando falla una operacion
- Estado vacio: Tabla sin registros cuando no hay tipos de relacion configurados
Backend (Perspectiva de Datos de Negocio)
Entidades de negocio
Tipo de Relacion: Representa un rol o vinculo familiar que un miembro puede tener dentro de un grupo familiar (ej: Principal, Conyuge, Hijo).
Datos necesarios
Cada tipo de relacion debe almacenar:
| Dato | Descripcion | Restricciones |
|---|---|---|
| Codigo | Identificador unico del tipo de relacion | Generado automaticamente, solo lectura |
| Nombre | Denominacion del tipo de relacion (ej: "Principal", "Conyuge", "Hijo") | Requerido, maximo 100 caracteres |
| Es principal | Indica si este tipo de relacion identifica al miembro titular del grupo familiar | Valor booleano (si/no) |
Relaciones de negocio
- Tipo de Relacion - Grupos Familiares: Los tipos de relacion se utilizan al asignar miembros a grupos familiares, definiendo el rol de cada integrante
Validaciones de negocio
- Nombre requerido: El nombre del tipo de relacion no puede estar vacio y tiene un maximo de 100 caracteres
Reglas de negocio
RN-001: Marca de relacion principal
Descripcion: Un tipo de relacion puede marcarse como "principal" para identificar al titular o responsable del grupo familiar.
Condicion: El usuario activa la marca de principal en un tipo de relacion.
Accion: El tipo de relacion se marca como principal. Esta marca determina que los miembros con este tipo de relacion dentro de un grupo familiar son considerados titulares del grupo.
RN-002: Eliminacion no disponible
Descripcion: Los tipos de relacion no pueden eliminarse desde la interfaz de usuario.
Condicion: El tipo de relacion existe en el sistema.
Accion: La operacion de eliminacion no esta disponible. Los tipos de relacion son datos de configuracion base que, una vez creados, permanecen en el sistema para mantener la integridad de los grupos familiares existentes.
Casos de uso
Caso 1: Crear nuevo tipo de relacion
Actor: Usuario administrativo
Precondiciones:
- El usuario esta autenticado en el sistema
Flujo principal:
- El usuario accede al listado de tipos de relacion desde Inicio > Bases > Tipos de Relacion
- El usuario selecciona "Nvo. Tipo"
- El sistema presenta el formulario de alta
- El usuario ingresa el nombre del tipo de relacion (ej: "Hijo")
- Opcionalmente, el usuario marca si el tipo es "Principal"
- El usuario confirma la creacion
- El sistema valida los datos y crea el tipo de relacion
- El sistema muestra una notificacion: "Tipo de relacion creado correctamente"
Postcondiciones:
- El tipo de relacion queda registrado y disponible para asignar en grupos familiares
Flujos alternativos:
- Error: nombre vacio: El sistema muestra "El nombre es requerido" y no permite guardar
Caso 2: Alternar marca de principal
Actor: Usuario administrativo
Precondiciones:
- El usuario esta autenticado en el sistema
- Existe al menos un tipo de relacion registrado
Flujo principal:
- El usuario visualiza el listado de tipos de relacion
- El usuario identifica el tipo de relacion cuya marca de principal desea cambiar
- El usuario acciona el interruptor de "Principal" en la tabla
- El sistema actualiza inmediatamente el valor (actualizacion optimista)
- Si la operacion falla, el sistema revierte al valor anterior automaticamente
Postcondiciones:
- La marca de principal del tipo de relacion queda actualizada
Flujos alternativos:
- Error de servidor: El sistema revierte el cambio visual y muestra un mensaje de error
Caso 3: Editar tipo de relacion existente
Actor: Usuario administrativo
Precondiciones:
- El usuario esta autenticado en el sistema
- Existe el tipo de relacion a modificar
Flujo principal:
- El usuario selecciona la opcion de editar en el tipo de relacion deseado
- El sistema presenta el formulario con los datos actuales
- El usuario modifica el nombre o la marca de principal
- El usuario confirma los cambios
- El sistema valida los datos y actualiza el tipo de relacion
- El sistema muestra una notificacion: "Tipo de relacion actualizado correctamente"
Postcondiciones:
- El tipo de relacion queda actualizado con los nuevos valores
Flujos alternativos:
- Error: nombre vacio: El sistema muestra "El nombre es requerido" y no permite guardar
Consideraciones
Seguridad
- El acceso a la gestion de tipos de relacion requiere autenticacion en el sistema
- La eliminacion no esta disponible para proteger la integridad de los grupos familiares existentes
Auditoria
- Las operaciones de creacion y modificacion de tipos de relacion deben registrarse en el sistema de auditoria
Rendimiento
- El catalogo de tipos de relacion es un conjunto muy reducido de datos (tipicamente menos de 10 registros) y debe responder de forma inmediata
- La alternancia de la marca principal utiliza actualizacion optimista para respuesta inmediata al usuario
Dependencias
Funcionalidades relacionadas
- Grupos Familiares: Los tipos de relacion son utilizados al asignar miembros a grupos familiares
- Gestion de Miembros: La relacion del miembro con su grupo familiar se define mediante un tipo de relacion
Criterios de aceptacion
La funcionalidad se considera completa cuando:
- [x] AC-001: El usuario puede consultar el listado completo de tipos de relacion con codigo, nombre e indicador de principal
- [x] AC-002: El usuario puede crear un nuevo tipo de relacion con nombre y opcionalmente marca de principal
- [x] AC-003: El usuario puede editar el nombre y la marca de principal de un tipo de relacion existente
- [x] AC-004: El usuario puede alternar la marca de principal directamente desde la tabla con respuesta inmediata
- [x] AC-005: La opcion de eliminar tipos de relacion no esta disponible en la interfaz
- [x] AC-006: El sistema muestra notificaciones de exito y error para todas las operaciones
Notas adicionales
- La marca "Es principal" es un indicador que determina que tipo de relacion se tiene en cuenta para identificar al titular de los grupos familiares. El tooltip del campo indica: "Determina que tipo de relacion se tiene en cuenta en los grupos familiares"
- A diferencia de las categorias y disciplinas, los tipos de relacion no tienen producto asociado ya que su funcion es exclusivamente clasificar el rol dentro del grupo familiar
- La eliminacion no esta implementada ni en la interfaz ni en el backend para este recurso, lo cual garantiza que los grupos familiares existentes mantengan la referencia a su tipo de relacion
Historial de cambios
| Fecha | Version | Autor | Descripcion |
|---|---|---|---|
| 2026-01-27 | 1.0 | Sistema | Creacion del documento de requisitos de negocio (funcionalidad ya implementada) |