Retiro de Socios

1. Introducción #

La funcionalidad Retiro de Socios permite consultar de manera online los retiros efectuados, los saldos pendientes y los activos disponibles de una sociedad. El informe se genera según los parámetros seleccionados y proporciona una visualización clara y dinámica tanto de los retiros individuales como de la distribución global de la sociedad.

2. Acceso a la Pantalla de Inicio #

• Nombre del informe: “Retiro de socios”.
• Selector principal:
  • Ubicado en la parte superior e identificado con asterisco, es obligatorio seleccionar una sociedad antes de avanzar.
  • Por defecto, no tiene ninguna opción seleccionada.
  • Si, tras seleccionar una sociedad, el usuario presiona la ‘x’, se vuelve a abrir el modal de selección (el selector nunca queda vacío).
• Botones principales:
  • Filtros: Acceso disponible solo si hay una sociedad seleccionada.
  • Generar: Permite generar el informe únicamente si la sociedad está seleccionada. Si no, se muestra un label rojo debajo del selector (“Elegí una opción”).
• Header:
  • Colapsable mediante ícono ubicado a la derecha del título; colapsa/despliega selector y accesos principales.
• Empty State:
  • Imagen por defecto al ingresar o si el informe no arroja resultados, informando sobre la ausencia de registros.
• Navegación:
  • Salir mediante botón “Atrás” arriba a la izquierda o el botón físico del teléfono. Regresa a Home o al módulo Campo, según origen.

3. Pantalla de Filtros #

• Acceso: Solo tras seleccionar una sociedad.
• Filtros disponibles:
  • Campaña: Selector simple, por defecto se muestra la campaña del menú hamburguesa (obligatorio).
  • Fecha desde/hasta: Inputs tipo fecha.
    • Desde: por defecto “01/01/00”,
    • Hasta: fecha actual.
    • Validación cruzada: “Desde” no puede ser posterior a “Hasta” y viceversa.
  • Actividad: Selector múltiple sin selección por defecto, muestra solo actividades agrícolas con planilla de producción.
  • Tipo de valorización: Radio button, primaria (por defecto) o secundaria.
  • Salidas por: Radio button entre “Kg origen” (por defecto) y “Kg destino”.
• Acciones en la pantalla:
  • Aplicar filtros: Solo habilitado tras modificar algún filtro. Guarda y regresa a inicio generando el informe.
  • Limpiar filtros: Restaura todos los valores a sus estados por defecto.
  • Cancelar/Volver: Descarta cambios y retorna a la pantalla de inicio.

4. Generación y Visualización – Tab ‘Retiros’ #

Al seleccionar la tab ‘Retiros’ (por defecto):

4.1 Gráfico de distribución de retiros #

• Gráfico de tipo torta que ilustra el porcentaje retirado por cada socio del total retirado en la sociedad.
  • Porcentajes ordenados de mayor a menor en sentido horario.
  • Nombres de socios y colores debajo del gráfico, en el mismo orden.
  • Si los nombres superan dos renglones, se despliega un CTA “Ver Más” para visualizar el resto.
• Tooltip a la izquierda del título “Distribución de retiros” para información adicional.

4.2 Listado detallado de retiros por socio #

• Cards por socio, ordenadas en función del porcentaje retirado (de mayor a menor).
• Cards están colapsadas por defecto, salvo si un solo socio ha efectuado retiros (entonces se muestra desplegada). Solo una card puede desplegarse a la vez.
• Cada card muestra:
  • Título: Nombre del socio.
  • Barra porcentual de retiros: Compara retiro planificado (lo que corresponde retirar según aporte) vs total retirado.
    • Color de la barra según avance:
      • 0–33%: Rojo
      • 34–66%: Naranja
      • 67–99%: Amarillo
      • 100%: Verde
      • 100%: Lila
  • Retiro planificado: Arriba de la barra, en gris claro y con separador de miles, sin decimales.
  • Total retirado: Debajo de la barra, mismo formato.
  • Detalle de retiros:
    • Tabla con dos columnas: tipo de retiro (granos, insumos, otros retiros — siempre en ese orden y siempre presentes aunque su importe sea cero) e importe total (con separador de miles y sin decimales).
    • Tooltips a la izquierda de cada tipo de retiro para mayor detalle; si el importe es cero, el tooltip está deshabilitado.
  • Total al pie: Valor total retirado por socio, mismo formato.

5. Comportamientos Especiales #

• El estado de la pantalla (incluyendo selección y despliegue de cards) se conserva si la app queda en segundo plano.
• En caso de no tener conexión a internet al generar el informe, se muestra un toast informativo. El usuario vuelve a inicio y, si el informe fue generado previamente, lo seguirá viendo.
• Si el usuario pierde los permisos para acceder a la funcionalidad, se muestra un modal y, al confirmarlo, la pantalla se cierra volviendo a Home y el acceso se oculta.

6. Resumen – Criterios Clave para el Usuario #

• Informe con nombre “Retiro de socios”.
• Selector de sociedad obligatorio, sin selección por defecto; no puede quedar vacío.
• Acceso a filtros y generación sólo con sociedad elegida.
• Visualización clara de empty state al ingresar o si no hay resultados.
• Gráfico de torta e información segmentada por socios.
• Cards de socios, colapsadas, con barra de avance colorida y detalle de retiros.
• Acceso protegido ante desconexiones o cambios de permisos.
• Retorno a la pantalla de origen según la ruta de acceso inicial.