AgroFertil — Manual de Usuario

AgroFertil es un sistema enfocado en el control de la fertilización de cultivos con dosificación automática de fertilizantes según el área del lote, la etapa fenológica y el análisis de suelo. Gestiona parcelas, planes de siembra, programas nutricionales, semáforo foliar y reportes.

1. ¿Qué hace el sistema?

2. Objetivo: control de fertilización y dosificación automática

El propósito central de AgroFertil es que el productor o técnico agrícola pueda:

1. Registrar el área del cultivo (parcela/lote) en manzanas o metros cuadrados.
2. Definir el cultivo y plan de siembra (fecha, meta de rendimiento en qq).
3. Obtener automáticamente el programa de fertilización: qué fórmula aplicar, cuántos kg por manzana, cuántos kg en total para toda el área, y en qué momento del ciclo (días post-siembra).
4. Registrar en campo cada aplicación y hacer seguimiento con el semáforo foliar.

3. Conversión de área: manzanas ↔ metros cuadrados

En Nicaragua se usa la manzana (mz) como unidad agrícola. El sistema trabaja con ambas unidades y las convierte automáticamente al registrar o editar una parcela:

4. Instalación y primer acceso

1. Requisitos. Servidor con PHP 8+ y MySQL (XAMPP en local, o hosting con PHP/MySQL). Carpeta del proyecto accesible por navegador.
2. Instalar base de datos. Abra install.php en el navegador (enlace en pantalla de login). Esto crea tablas, datos iniciales (cultivos, etapas, fertilizantes) y el usuario administrador.
3. Iniciar sesión. Usuario por defecto: admin / contraseña: admin. Cambie la contraseña en producción.
4. Pantalla de inicio. Tras el login verá el panel principal con accesos rápidos, KPIs y alertas.

5. Flujo general recomendado

Cada parcela puede tener su propio plan activo. Use la barra de contexto (arriba) para elegir en qué parcela y plan está trabajando; todo el sistema se sincroniza con esa selección.

6. Registrar y gestionar parcelas

Menú Parcelas

1. Pulse Agregar parcela (botón verde o acceso rápido en Inicio).
2. Complete: nombre del lote, tipo de suelo y área:
   • Ingrese manzanas → el sistema calcula los m² (× 7 026).
   • O ingrese metros cuadrados → el sistema calcula las manzanas (÷ 7 026).
3. Ubicación en mapa. Use el mapa Leaflet para:
   • Usar mi ubicación (GPS del dispositivo).
   • Clic o arrastre del marcador en el mapa.
   • Búsqueda de lugar (limitada al departamento de Madriz, Nicaragua).
4. Guarde. La parcela aparece en la lista con filtros por nombre, suelo, estado y actividad.
5. Ver detalle: clic en una tarjeta para abrir historial (ciclos, análisis, variedad del cultivo).
6. Editar: modifique nombre, suelo, área o coordenadas.
7. Eliminar: si la parcela tiene historial (análisis, planes, dosis), el sistema pedirá confirmación antes de borrar todo.

7. Barra de contexto (parcela + plan activos)

Debajo del encabezado aparece una barra fija con:

8. Análisis de suelo

Menú Parcelas → Análisis, o botón flask en barra de contexto

1. Seleccione la parcela (si no viene preseleccionada por el contexto).
2. Ingrese fecha de muestreo, pH, N, P, K (ppm o unidades del laboratorio).
3. Opcional: temperatura (°C), humedad (%), observaciones.
4. Al guardar, el Motor NPK recalcula las dosis del plan activo de esa parcela según las condiciones del suelo.
5. Puede editar o eliminar análisis desde el historial de la parcela.

Ajustes que aplica el motor según análisis

9. Catálogo de cultivos y etapas fenológicas

Menú Cultivos

Antes de crear un plan, el cultivo debe existir en el catálogo con sus etapas fenológicas (momentos del ciclo).

1. Ver cultivos instalados (Maíz, Frijol, Tomate, Chile, etc.) con categoría Granos básicos u Hortalizas.
2. Agregar cultivo: nombre, variedad, categoría y tipo. Al crear, el sistema puede cargar etapas base automáticamente.
3. Etapas fenológicas por cultivo: nombre, día inicio, día fin, % de N, P, K repartidos en el ciclo, y nota de manejo.
4. La suma de % N, P y K de todas las etapas debe ser coherente (el sistema avisa si no cuadra).

10. Planes de siembra

Menú Planes

1. Pulse Nuevo plan (o botón en barra de contexto).
2. Seleccione parcela, cultivo, fecha de siembra y meta de rendimiento en quintales (qq).
3. Al guardar, el Motor NPK genera la dosificación completa por etapa.
4. Solo puede haber un plan activo por parcela; al activar uno nuevo en la misma parcela, el anterior pasa a finalizado.
5. En la lista de planes puede: Ver detalle, Editar fecha/meta/estado, Eliminar, o pulsar el icono de programa (clipboard) para cargar ese plan en Fertilización.

En la misma sección verá la tabla Dosificación recomendada — Motor NPK del plan en contexto, con columnas de momento, días post-siembra, fórmula, kg/mz, total y botón para marcar aplicado.

11. Fertilización — Programa del cultivo

Menú Fertilización → pestaña Programa del cultivo

Esta es la vista principal del programa nutricional. Muestra para cada momento fenológico:

Otras pestañas de Fertilización

Para detalle técnico del cálculo NPK, consulte el Manual del Motor NPK.

12. Semáforo de nutrición (bitácora de campo)

Menú Semáforo

1. Pulse Evaluar estado de cultivo.
2. Seleccione parcela y opcionalmente plan/cultivo.
3. Elija color: Verde (óptimo), Amarillo (precaución) o Rojo (crítico).
4. Indique elemento afectado (N, P, K, Ca, Mg…) y observaciones visuales.
5. Adjunte foto de la hoja y confirme GPS (captura automática si el navegador lo permite).
6. Los registros aparecen en la línea de tiempo (bitácora) y alimentan alertas del panel de inicio.

13. Reportes y exportación

Menú Reportes

• Pestañas: Resumen, Bitácora semáforo, Fertilizaciones, Análisis de suelo.
• Filtros: rango de fechas, parcela, estado del semáforo, cultivo, estado de fertilización.
• Gráficos: evolución de pH, NPK aplicado, alertas por parcela.
• Exportar Excel: descarga CSV con parcelas, análisis, dosificación y bitácora.
• Exportar PDF: abre vista de impresión del navegador (Guardar como PDF).

14. Administración de usuarios

Menú Usuarios (solo administrador)

• Agregar operadores o agrónomos con nombre y teléfono.
• Activar o desactivar cuentas.
• Eliminar usuarios que ya no necesiten acceso.

15. Resumen operativo — Checklist del ciclo

Use esta lista en cada campaña:

• Ejecutar install.php (solo la primera vez)
• Registrar todas las parcelas con mapa y área correcta
• Tomar y registrar análisis de suelo por parcela
• Verificar cultivos y etapas en catálogo
• Crear plan de siembra (parcela + cultivo + fecha + meta qq)
• Seleccionar parcela/plan en barra de contexto
• Revisar programa de fertilización (fórmula, kg, días post-siembra)
• Aplicar fertilizante en campo y marcar cada dosis como aplicada
• Registrar visitas en semáforo con foto cuando haya anomalías
• Exportar reporte al cierre del ciclo

Tabla resumen por módulo

16. Análisis general del sistema

Fortalezas

• Flujo integrado: parcela → análisis → plan → dosis → aplicación → seguimiento foliar.
• Motor NPK automático: reduce errores manuales en cálculo de fertilizante.
• Contexto por parcela (v3.0): cada lote con su plan y programa independiente.
• Información práctica en campo: fórmula, kg/mz, total para el área y días desde siembra.
• Mapa y GPS: ubicación precisa en Madriz; útil para visitas y semáforo.
• Funciona offline-friendly en local con XAMPP; exportación para respaldo.

Limitaciones actuales

• Las dosis se calculan automáticamente; no se editan manualmente nutriente por nutriente (solo marcar aplicado).
• La calculadora de fertilización es independiente del plan guardado (simulación).
• Roles de usuario básicos (no hay permisos granulares por módulo).
• Requiere conexión al servidor para guardar datos (no es app móvil nativa offline).

Recomendaciones de uso

17. Solución de problemas