Fincas, invernaderos, hileras, ciclos

El registro organiza sus instalaciones en una jerarquía fija. Cada registro depende de un ciclo de cultivo, y cada nivel pertenece a una organización.

Diagrama de la jerarquía: la organización, que contiene las claves de API; luego la finca; el invernadero, con su tipo, ubicación y zona horaria; la hilera, con su superficie; y el ciclo de cultivo, con su variedad y fecha de plantación. Bajo el ciclo de cultivo: recorridos, cosechas, riego, lecturas, clima, pesos de fruto y previsiones guardadas. — Organización → finca → invernadero → hilera → ciclo de cultivo.

Los niveles

Finca: Un nombre. Agrupa invernaderos.
Invernadero: Un nombre, un tipo de invernadero (plástico, malla de sombra, refrigerado o cerrado climatizado), una latitud y una longitud opcionales para el clima, y una zona horaria IANA opcional. La zona horaria determina cómo se leen las horas sin desfase de los archivos de clima. Sin zona, se leen como UTC. El horario de verano y otros cambios de hora proceden de los datos de zonas horarias IANA del sistema.
Hilera: Un nombre y una superficie en m², ambos opcionales.
Ciclo de cultivo: Variedad, fecha de plantación, plantas por m² y superficie, todos opcionales. Los recorridos, cosechas, riego, lecturas, clima, pesos de fruto, resúmenes semanales y previsiones guardadas pertenecen todos a un ciclo.

Editar nombres y detalles

La página Configuración con el panel de edición del invernadero abierto a la derecha. El panel conserva el identificador demo-house y tiene campos para el nombre, el tipo de invernadero, la zona horaria, la latitud y la longitud, con los botones Guardar los cambios y Cancelar. — Edición de un invernadero en la página Configuración. La edición se abre en un panel; el identificador no cambia.

En la página Configuración (/app/setup), el árbol de la organización muestra todas las fincas, invernaderos, hileras y ciclos de cultivo. Editar en un nivel abre un panel con sus detalles; con la API, envíe un PATCH a la ruta del nivel. Los campos que no envíe conservan su valor. Un campo del ciclo enviado como null se borra.

Puede cambiar los nombres y los detalles: tipo de invernadero, ubicación, zona horaria, superficie, variedad, fecha de plantación y densidad.
Los identificadores no se pueden cambiar. Para renombrar un identificador, cree el nuevo nivel y traslade los datos volviendo a registrarlos.
Cambiar la zona horaria de un invernadero no mueve las lecturas guardadas. Conservan sus horas en UTC.
La latitud y la longitud se fijan juntas o se borran juntas.

Importar una lista de invernaderos

Para configurar muchos invernaderos a la vez, abra Configuración → Importar invernaderos (/app/setup/import) y suba un CSV con una línea por invernadero. Descargue la plantilla desde la página; sus columnas son farm, greenhouse, house_type, area_m2, rows, row_length_m, fruit_type, planting_date, cycle_name.

Guárdelo en UTF-8, con ; o , entre columnas. Un archivo admite como máximo 500 invernaderos y 1 MB.
Vista previa muestra lo que se crearía y cada línea por corregir. No se guarda nada hasta pulsar Aplicar.
Cada invernadero recibe sus líneas y un ciclo de cultivo por línea. Una finca, invernadero, línea o ciclo que ya existe con el mismo nombre se omite, así que importar el mismo archivo otra vez no crea nada nuevo.

Eliminar un nivel

La eliminación se rechaza mientras el nivel contenga algo. La respuesta es 409 y enumera lo que contiene. Para ver antes esos mismos conteos, consulte GET …/contents, que devuelve los invernaderos, hileras, ciclos, recorridos, lecturas, cosechas, entradas de riego, previsiones guardadas, resúmenes semanales y ajustes de peso de fruto bajo ese nivel.

Envíe ?cascade=true para eliminar el nivel con todo lo que contiene. En la aplicación, Eliminar abre una confirmación que enumera lo que se elimina con el nivel, y no se borra nada hasta que elija Eliminar todo.

La página Configuración con una confirmación de eliminación abierta para la hilera demo-row. Indica cuántos elementos se eliminarían con ella, con los botones Cancelar y Eliminar todo. — Una eliminación en la página Configuración enumera primero lo que se va con el nivel.

Los recorridos guardados se desvinculan, no se borran. El recorrido analizado puede seguir abriéndose por su identificador durante un tiempo, pero ya no cuenta para ninguna previsión.
Las previsiones guardadas bajo el nivel se eliminan con él.
Una eliminación no se puede deshacer. Exporte antes el ciclo a CSV si cree que podría necesitar las cifras.