Saltar al contenido principal

wiki-home

Ver en Git

home

FieldView

Tabla de contenidos​

Visión general​

FieldView es una extensión para Auravant que permite importar fácilmente capas y lotes desde la plataforma FieldView. A través de una integración SSO, los usuarios pueden acceder a sus datos de FieldView y sincronizarlos con su cuenta de Auravant, manteniendo los permisos y estructuras necesarias para una correcta visualización y análisis.

Principales funcionalidades:​

  1. Inicio de sesión con SSO de FieldView
  2. Importación de capas y lotes desde FieldView
  3. Gestión de permisos por campo y lote
  4. Visualización agrupada y filtrado de capas y lotes
  5. Acciones rápidas sobre capas (ver, eliminar, ocultar)

Funcionalidades​

1. Inicio de sesión con SSO​

Descripción:
La autenticación se realiza mediante Single Sign-On (SSO) con la cuenta de FieldView del usuario. Esto permite una integración segura y fluida, sin necesidad de múltiples credenciales.

Propósito:
Facilitar el acceso a los datos de FieldView manteniendo la seguridad y autenticación del sistema.

2. Importación de capas​

Descripción:
Una vez autenticado, el usuario puede visualizar una tabla con las capas agrupadas por campo de FieldView. Cada capa está asociada a un lote:

  • Si el lote no existe en Auravant, se podrá importar especificando:
  • El campo en Auravant donde se quiere crear el lote.
  • Un nuevo nombre para el lote (opcional, por defecto se mantiene el nombre de FieldView).
  • La posibilidad de crear un campo nuevo si se especifica un nombre que aún no existe.

Restricciones:

  • Solo se pueden importar lotes si el usuario tiene permisos para hacerlo en el campo seleccionado.
  • Solo se pueden importar capas si el usuario tiene permisos en el lote.

Filtros disponibles en la tabla de capas:

  1. Campaña
  2. Operación
  3. Campos
  4. Lotes (habilitado al seleccionar un campo)
  5. Estado:
  • No importado
  • Pendiente
  • Importado
  • Con errores
  • Eliminado

Estados y Acciones:

  • Pendiente: luego de la importación, la capa queda en espera hasta ser procesada por el backend.
  • Importado: permite visualizar o eliminar la capa.
  • Todas las capas pueden ser ocultadas en cualquier estado.

Acciones disponibles:

  • Ver capa (solo si está importada)
  • Eliminar capa (solo si está importada)
  • Ocultar capa (siempre disponible)

Selección de capas:

  • Se pueden seleccionar capas una por una con un checkbox.
  • O bien seleccionar todas las capas habilitadas para importar con un checkbox general.

Carga progresiva:

  • Al cargar la extensión se traen 100 capas.
  • Se pueden cargar más con el botón “Cargar más capas”.

3. Importación de lotes​

Descripción:
Desde la pestaña "Lotes no importados", se accede a una tabla que muestra todos los lotes de FieldView aún no importados, agrupados por campo. Cada lote puede ser:

  • Importado individualmente mediante un checkbox.
  • Importado en lote por campo mediante el botón “Importar todos”.

Filtros disponibles:

  1. Operación
  2. Campos
  3. Lotes

Stack Tecnológico​

Este proyecto está construido con tecnologías modernas para garantizar una experiencia ágil, robusta y mantenible.

Tecnologías principales​

  • React
  • Tailwind CSS
  • Radix UI
  • Lucide-react

Instalación​

# Clonar el repositorio
git clone https://git.auravant.com/it/extensiones/producto/fieldview

# Ingresar al directorio del proyecto
cd fieldview

# Instalar las dependencias
npm install

Notas del desarrollador​

Estados de capas​

Cuando una capa es importada, pasa al estado Pendiente. Esto indica que el backend la está procesando, y el tiempo de espera puede variar según el tamaño de la capa.

Permisos​

Los permisos para importar lotes y capas están estrictamente controlados:

  • Lotes: solo se pueden importar en campos donde el usuario tenga permisos.
  • Capas: solo se pueden importar en lotes permitidos.

Estructura de visualización​

La agrupación por campo de FieldView permite al usuario visualizar la jerarquía original de los datos, conservando su organización previa.

Optimización de carga​

  • Se cargan 100 capas al iniciar.
  • La carga es progresiva y controlada por el usuario.
  • El filtro de "Lotes" solo se habilita una vez que se selecciona un campo.

Contribuciones​

# Crear una nueva rama para tu funcionalidad
git checkout -b feature/nueva-funcionalidad

# Realizar los cambios y agregar un commit
git commit -m "Agrega nueva funcionalidad de importación por lote"

# Subir la rama y abrir una Pull Request
git push origin feature/nueva-funcionalidad

Pautas para contribuir​

  • Seguí las convenciones del código del proyecto.
  • Documentá cualquier cambio relevante en este archivo README.md.

Hecho con ❤️ por Nacho.