Appearance
Provincias
Modulo: Bases Tipo: Resource Estado: Implementado Fecha: 2026-02-27
Descripcion
Las Provincias son entidades geograficas que representan las divisiones administrativas de nivel provincial. Constituyen un dato maestro global del sistema, compartido por multiples modulos de negocio (CRM, Compras, Ventas).
Valor para el negocio:
- Proveen un catalogo estandarizado de provincias para uso en formularios de todo el sistema
- Garantizan consistencia en la informacion geografica al centralizar el mantenimiento en un unico punto
- Sirven como referencia obligatoria para las localidades del sistema
Contexto:
Las provincias son un conjunto reducido y estable de datos (~24 provincias argentinas). Originalmente se gestionaban desde el modulo CRM; fueron reubicadas al modulo Bases por ser datos maestros de alcance global.
Frontend (Perspectiva de Usuario)
Vistas
- Pantalla de gestion de Provincias: Listado completo de todas las provincias registradas, con opciones para crear y editar
Interacciones del Usuario
- Listar: El usuario accede a Bases > Provincias y visualiza el listado completo de provincias. No hay paginacion dado el volumen reducido de datos.
- Crear: El usuario crea una nueva provincia ingresando su nombre
- Editar: El usuario modifica el nombre de una provincia existente
No existe operacion de eliminacion. Las provincias son datos maestros estables que sirven como referencia para localidades y registros de multiples modulos.
Permisos
| Permiso | Nivel | Descripcion |
|---|---|---|
| BASES | 1 -- modulo | Requerido para ver la seccion Bases en el menu principal |
| BASES_PROVINCIAS | 2 -- sub-item | Requerido para acceder a la gestion de Provincias |
Estados de UI
- Carga inicial: Indicador de carga mientras se obtienen los datos
- Lista vacia: Mensaje informativo cuando no hay provincias registradas
- Alta exitosa: Confirmacion tras crear una provincia; el listado se actualiza automaticamente
- Edicion exitosa: Confirmacion tras editar una provincia; el listado se actualiza automaticamente
- Error de validacion: Mensaje de error si el nombre esta vacio
Backend (Perspectiva de Datos de Negocio)
Entidades de Negocio
- Provincia: Division administrativa de nivel provincial, utilizada como referencia geografica en todo el sistema
Datos Necesarios
- Nombre: Nombre de la provincia (obligatorio)
El identificador unico es asignado automaticamente por el sistema al crear la provincia.
Relaciones de Negocio
- Cada Localidad tiene asociada una Provincia
- Los formularios de contactos (CRM), proveedores (Compras) y clientes (Ventas) utilizan provincias indirectamente a traves de la seleccion de localidad
Validaciones de Negocio
- Nombre: Obligatorio, no puede estar vacio
Reglas de Negocio
RN-001: Sin eliminacion de provincias
- Condicion: Las provincias son datos maestros de referencia utilizados por localidades y registros de multiples modulos
- Accion: No se ofrece la operacion de eliminacion. Las provincias permanecen en el sistema de forma permanente.
RN-002: Listado completo sin paginacion
- Condicion: El volumen de provincias es reducido y estable (~24 provincias argentinas)
- Accion: El listado muestra todas las provincias sin necesidad de paginacion
RN-003: Datos globales a nivel empresa
- Condicion: Las provincias son datos maestros compartidos por todos los modulos
- Accion: Las provincias son globales para toda la empresa y no varian por sucursal
Casos de Uso
UC-001: Listar provincias
Actor: Usuario administrativo con permiso BASES_PROVINCIAS
Precondiciones:
- El usuario esta autenticado
- El usuario tiene los permisos BASES y BASES_PROVINCIAS
Flujo principal:
- El usuario accede a Bases > Provincias desde el menu principal
- El sistema muestra el listado completo de provincias con su nombre y opciones de edicion
- El usuario visualiza las provincias registradas
Postcondiciones:
- Se visualizan todas las provincias del sistema
UC-002: Crear una provincia
Actor: Usuario administrativo con permiso BASES_PROVINCIAS
Precondiciones:
- El usuario esta en la pantalla de Provincias
Flujo principal:
- El usuario selecciona la opcion de crear nueva provincia
- El sistema muestra un formulario con el campo nombre
- El usuario ingresa el nombre de la provincia
- El usuario confirma la creacion
- El sistema valida que el nombre no este vacio
- El sistema registra la nueva provincia y asigna un identificador unico
- El sistema muestra confirmacion y actualiza el listado
Flujos alternativos:
- 5a. Nombre vacio: El sistema muestra un mensaje de error y no permite guardar
Postcondiciones:
- La provincia queda registrada en el sistema
- Esta disponible para su uso en la gestion de localidades y formularios de otros modulos
UC-003: Editar una provincia
Actor: Usuario administrativo con permiso BASES_PROVINCIAS
Precondiciones:
- El usuario esta en la pantalla de Provincias
- Existe al menos una provincia registrada
Flujo principal:
- El usuario selecciona la opcion de edicion en la fila de la provincia deseada
- El sistema muestra el formulario con el nombre actual de la provincia
- El usuario modifica el nombre
- El usuario confirma la edicion
- El sistema valida que el nombre no este vacio
- El sistema actualiza el nombre de la provincia
- El sistema muestra confirmacion y actualiza el listado
Flujos alternativos:
- 5a. Nombre vacio: El sistema muestra un mensaje de error y no permite guardar
Postcondiciones:
- El nombre de la provincia queda actualizado
- Todos los registros que referencian esta provincia reflejan el nuevo nombre
Consideraciones
Seguridad
- Solo usuarios autenticados pueden consultar las provincias
- La creacion y edicion requieren el permiso BASES_PROVINCIAS
Rendimiento
- El volumen de datos es fijo y reducido (~24 provincias argentinas), por lo que no se requieren optimizaciones especiales ni paginacion
Dependencias
Modulos internos
- Localidades (Bases): Cada localidad tiene una provincia asociada
- CRM: Usa provincias indirectamente a traves de la seleccion de localidades en formularios de contacto
- Compras: Usa provincias en el formulario de proveedores
- Ventas: Usa provincias en los datos de clientes
Criterios de Aceptacion
- [x] El usuario con permiso BASES_PROVINCIAS puede ver el listado completo de provincias
- [x] El usuario puede crear una nueva provincia ingresando un nombre
- [x] El usuario puede editar el nombre de una provincia existente
- [x] El listado se actualiza automaticamente tras crear o editar una provincia
- [x] La seccion "Bases" aparece en el menu principal y el item "Provincias" queda marcado como activo al acceder
- [x] Las direcciones anteriores del modulo CRM que apuntaban a Provincias redirigen correctamente a la nueva ubicacion
- [x] La ruta de navegacion muestra: Inicio > Bases > Provincias
- [x] No se ofrece opcion de eliminar provincias
Notas Adicionales
- Las provincias son un dato maestro estable. No se anticipa alta frecuencia de creacion o edicion.
- Este recurso fue extraido del modulo CRM como parte de la reorganizacion de datos maestros geograficos.