Appearance
Localidades
Modulo: Bases Tipo: Resource Estado: Implementado Fecha: 2026-02-27
Descripcion
Las Localidades son entidades geograficas que representan ciudades o localidades con su codigo postal y provincia asociada. Constituyen un dato maestro global del sistema, compartido por multiples modulos de negocio (CRM, Compras, Ventas, Membresias).
Valor para el negocio:
- Proveen un catalogo estandarizado de localidades para uso en formularios de todo el sistema
- Permiten designar una localidad predeterminada para agilizar la carga de datos en formularios de otros modulos
- Garantizan consistencia en la informacion geografica al centralizar el mantenimiento en un unico punto
Contexto:
Las localidades pueden tener un volumen considerable de registros. Originalmente se gestionaban desde el modulo CRM; fueron reubicadas al modulo Bases por ser datos maestros de alcance global. Una localidad puede marcarse como predeterminada del sistema, lo que permite que formularios de otros modulos la pre-seleccionen automaticamente.
Frontend (Perspectiva de Usuario)
Vistas
- Pantalla de gestion de Localidades: Listado paginado de localidades con opciones para crear, editar y cambiar la localidad predeterminada
Interacciones del Usuario
- Listar: El usuario accede a Bases > Localidades y visualiza el listado paginado de localidades. Puede navegar entre paginas, filtrar por nombre o identificador, y ordenar por columnas.
- Crear: El usuario crea una nueva localidad ingresando nombre, codigo postal y seleccionando una provincia
- Editar: El usuario modifica los datos de una localidad existente (nombre, codigo postal, provincia, marca de predeterminada)
- Cambiar localidad predeterminada: El usuario activa o desactiva la marca de "predeterminada" directamente desde el listado. El cambio se refleja de forma inmediata en la pantalla sin esperar confirmacion del servidor. Si ocurre un error, el cambio se revierte automaticamente.
No existe operacion de eliminacion. Las localidades son datos maestros de referencia que pueden estar asociados a contactos, proveedores, clientes y miembros historicos.
Datos visibles en el listado
| Columna | Descripcion | Filtrable | Ordenable |
|---|---|---|---|
| Identificador | Numero unico de la localidad | Si | Si |
| Nombre | Nombre de la localidad | Si | Si |
| Codigo Postal | Codigo postal de la localidad | No | Si |
| Provincia | Nombre de la provincia asociada | No | No |
| Predeterminada | Indica si es la localidad predeterminada del sistema | No | No |
El listado muestra 10 registros por pagina de forma predeterminada, con paginacion gestionada por el servidor.
Formulario de alta/edicion
- Nombre: Campo de texto, obligatorio (entre 3 y 60 caracteres)
- Codigo postal: Campo numerico, obligatorio (entero positivo)
- Provincia: Selector desplegable con todas las provincias disponibles, obligatorio
- Predeterminada: Casilla de verificacion con etiqueta "Marcar como localidad por defecto"
Permisos
| Permiso | Nivel | Descripcion |
|---|---|---|
| BASES | 1 -- modulo | Requerido para ver la seccion Bases en el menu principal |
| BASES_LOCALIDADES | 2 -- sub-item | Requerido para acceder a la gestion de Localidades |
Estados de UI
- Carga inicial: Indicador de carga mientras se obtiene la primera pagina de datos
- Tabla paginada: Muestra los datos segun la pagina, filtros y orden seleccionados
- Lista vacia: Mensaje informativo cuando no hay localidades registradas o no hay resultados para los filtros aplicados
- Alta exitosa: Confirmacion tras crear una localidad; el listado se actualiza automaticamente
- Edicion exitosa: Confirmacion tras editar una localidad; el listado se actualiza automaticamente
- Cambio de predeterminada -- actualizacion inmediata: La marca se actualiza de forma instantanea en la pantalla. Si el servidor retorna error, el cambio se revierte automaticamente y se muestra un mensaje de error.
- Error de validacion: Mensajes de error si campos obligatorios estan vacios o tienen formato incorrecto
Backend (Perspectiva de Datos de Negocio)
Entidades de Negocio
- Localidad: Ciudad o localidad con su codigo postal y provincia, utilizada como referencia geografica en todo el sistema
Datos Necesarios
- Nombre: Nombre de la localidad (obligatorio, entre 3 y 60 caracteres)
- Codigo postal: Codigo postal (obligatorio, entero positivo)
- Provincia: Provincia asociada (obligatorio, debe existir en el catalogo de provincias)
- Predeterminada: Indica si es la localidad predeterminada del sistema (opcional, por defecto: no)
El identificador unico es asignado automaticamente por el sistema al crear la localidad.
Relaciones de Negocio
- Cada Localidad pertenece a una Provincia
- Las localidades son utilizadas en formularios de contactos (CRM), proveedores (Compras), clientes (Ventas) y miembros (Membresias)
- Otros modulos pueden consultar la localidad predeterminada del sistema para pre-seleccionarla en sus formularios
Validaciones de Negocio
- Nombre: Obligatorio, entre 3 y 60 caracteres
- Codigo postal: Obligatorio, debe ser un entero positivo
- Provincia: Obligatoria, debe corresponder a una provincia existente en el sistema
- Predeterminada: Solo una localidad puede estar marcada como predeterminada a la vez (gestionado por el sistema)
Reglas de Negocio
RN-001: Unicidad de localidad predeterminada
- Condicion: El usuario activa la marca de "predeterminada" en una localidad
- Accion: El sistema desactiva automaticamente la localidad que previamente tenia la marca de predeterminada. En ningun momento pueden coexistir dos localidades marcadas como predeterminadas.
- Ejemplo: Si "Buenos Aires" es la localidad predeterminada y el usuario marca "Cordoba", el sistema automaticamente desmarca "Buenos Aires" y marca "Cordoba".
RN-002: Actualizacion inmediata al cambiar predeterminada
- Condicion: El usuario activa o desactiva la marca de predeterminada desde el listado
- Accion: El cambio se refleja de forma inmediata en la pantalla sin esperar confirmacion del servidor. Si el servidor retorna un error, el estado se revierte al valor anterior automaticamente. Este comportamiento mejora la percepcion de velocidad sin comprometer la consistencia de los datos.
RN-003: Sin eliminacion de localidades
- Condicion: Las localidades son datos maestros de referencia
- Accion: No se ofrece la operacion de eliminacion. Una localidad puede estar referenciada por contactos, proveedores, clientes y miembros historicos.
RN-004: Paginacion del lado del servidor
- Condicion: El volumen de localidades puede ser elevado
- Accion: El listado se pagina del lado del servidor. Los filtros y el ordenamiento tambien se resuelven en el servidor.
RN-005: Datos globales a nivel empresa
- Condicion: Las localidades son datos maestros compartidos por todos los modulos
- Accion: Las localidades son globales para toda la empresa y no varian por sucursal
Casos de Uso
UC-001: Listar localidades con paginacion
Actor: Usuario administrativo con permiso BASES_LOCALIDADES
Precondiciones:
- El usuario esta autenticado
- El usuario tiene los permisos BASES y BASES_LOCALIDADES
Flujo principal:
- El usuario accede a Bases > Localidades desde el menu principal
- El sistema muestra la primera pagina del listado paginado de localidades con nombre, codigo postal, provincia y marca de predeterminada
- El usuario puede navegar entre paginas usando los controles de paginacion
- El usuario puede filtrar por nombre o identificador usando el buscador
- El usuario puede ordenar los resultados haciendo clic en las columnas ordenables
Postcondiciones:
- Se visualizan las localidades segun los parametros de paginacion, filtrado y ordenamiento seleccionados
UC-002: Crear una localidad
Actor: Usuario administrativo con permiso BASES_LOCALIDADES
Precondiciones:
- El usuario esta en la pantalla de Localidades
- Existen provincias registradas en el sistema
Flujo principal:
- El usuario selecciona la opcion de crear nueva localidad
- El sistema muestra un formulario con los campos: nombre, codigo postal, provincia (selector) y predeterminada (casilla)
- El usuario ingresa el nombre de la localidad
- El usuario ingresa el codigo postal
- El usuario selecciona una provincia del selector desplegable
- Opcionalmente, el usuario marca la casilla de localidad predeterminada
- El usuario confirma la creacion
- El sistema valida los campos (nombre entre 3-60 caracteres, codigo postal entero positivo, provincia seleccionada)
- El sistema registra la nueva localidad
- El sistema muestra confirmacion y actualiza el listado
Flujos alternativos:
- 8a. Campos invalidos: El sistema muestra mensajes de error especificos y no permite guardar
- 6a. Marca como predeterminada con otra localidad ya marcada: El sistema desmarca la localidad predeterminada anterior automaticamente
Postcondiciones:
- La localidad queda registrada en el sistema
- Esta disponible para su uso en formularios de otros modulos
- Si fue marcada como predeterminada, los formularios de otros modulos la pre-seleccionaran
UC-003: Editar una localidad
Actor: Usuario administrativo con permiso BASES_LOCALIDADES
Precondiciones:
- El usuario esta en la pantalla de Localidades
- Existe al menos una localidad registrada
Flujo principal:
- El usuario selecciona la opcion de edicion en la fila de la localidad deseada
- El sistema muestra el formulario con los datos actuales de la localidad
- El usuario modifica los campos deseados
- El usuario confirma la edicion
- El sistema valida los campos
- El sistema actualiza los datos de la localidad
- El sistema muestra confirmacion y actualiza el listado
Flujos alternativos:
- 5a. Campos invalidos: El sistema muestra mensajes de error especificos y no permite guardar
Postcondiciones:
- Los datos de la localidad quedan actualizados en el sistema
UC-004: Cambiar la localidad predeterminada
Actor: Usuario administrativo con permiso BASES_LOCALIDADES
Precondiciones:
- El usuario esta en la pantalla de Localidades
Flujo principal:
- El usuario activa la marca de "predeterminada" en una localidad desde el listado
- El sistema refleja el cambio de forma inmediata en la pantalla: la localidad seleccionada aparece como predeterminada y la anterior se desmarca
- El sistema envia la solicitud de cambio al servidor
- El servidor desactiva la localidad predeterminada anterior y activa la nueva
- El sistema confirma el estado actual de los datos
Flujos alternativos:
- 4a. Error del servidor: Si la solicitud falla, el cambio se revierte automaticamente en la pantalla. La localidad vuelve al estado anterior y se muestra un mensaje de error al usuario.
Postcondiciones:
- Una unica localidad tiene la marca de predeterminada en el sistema
- Los formularios de otros modulos que pre-seleccionan la localidad predeterminada obtendran la nueva localidad
Consideraciones
Seguridad
- Solo usuarios autenticados pueden consultar las localidades
- La creacion, edicion y cambio de predeterminada requieren el permiso BASES_LOCALIDADES
Rendimiento
- El volumen de localidades puede ser elevado, por lo que el listado utiliza paginacion del lado del servidor
- Los filtros y el ordenamiento se resuelven en el servidor para mantener el rendimiento
Dependencias
Modulos internos
- Provincias (Bases): Cada localidad tiene una provincia asociada; el formulario de localidades incluye un selector de provincias
- CRM: Usa localidades en formularios de contacto
- Compras: Usa localidades en el formulario de proveedores
- Ventas: Usa localidades en los datos de clientes
- Membresias: Usa localidades en los datos de miembros
Dependencias de datos
- Deben existir provincias registradas en el sistema para poder crear localidades (la provincia es un campo obligatorio)
Criterios de Aceptacion
- [x] El usuario con permiso BASES_LOCALIDADES puede ver el listado paginado de localidades
- [x] El listado soporta paginacion del lado del servidor, filtrado por columnas y ordenamiento
- [x] El usuario puede crear una nueva localidad con nombre, codigo postal y provincia
- [x] El usuario puede editar los datos de una localidad existente
- [x] El cambio de localidad predeterminada se refleja de forma inmediata en la pantalla
- [x] Si el cambio de predeterminada falla en el servidor, el estado se revierte automaticamente en la pantalla
- [x] Solo puede existir una localidad marcada como predeterminada a la vez
- [x] La seccion "Bases" aparece en el menu principal y el item "Localidades" queda marcado como activo al acceder
- [x] Las direcciones anteriores del modulo CRM que apuntaban a Localidades redirigen correctamente a la nueva ubicacion
- [x] La ruta de navegacion muestra: Inicio > Bases > Localidades
- [x] No se ofrece opcion de eliminar localidades
- [x] La provincia es obligatoria al crear o editar una localidad
Notas Adicionales
- La localidad predeterminada es utilizada por formularios de otros modulos para pre-seleccionar automaticamente una localidad, agilizando la carga de datos.
- Este recurso fue extraido del modulo CRM como parte de la reorganizacion de datos maestros geograficos.
- El cambio no implico modificaciones en la base de datos ni en los servicios del sistema; fue exclusivamente organizativo y de experiencia de usuario.