🌱 AGROX

Documento inicial del proyecto

AGROX es una plataforma digital diseñada para pequeños y medianos productores agrícolas de Nicaragua. Su propósito es brindar herramientas tecnológicas que les permitan registrar, analizar y mejorar la gestión de sus cultivos, optimizando costos, aumentando la productividad y garantizando mayor sostenibilidad en sus procesos.

---

📌 Descripción del proyecto

AGROX busca transformar la manera en que los agricultores gestionan su producción, ofreciendo:

• Registro digital de actividades agrícolas.
• Cálculo automático de costos por lote y cultivo.
• Paneles financieros dinámicos y visualizaciones en tiempo real.
• Comparativas entre ciclos productivos y variedades.
• Trazabilidad de la producción desde la siembra hasta la cosecha.
• Acceso a reportes claros y fáciles de interpretar.

Con estas funciones, AGROX contribuye a la toma de decisiones informadas, facilitando la planificación y reduciendo la incertidumbre en cada ciclo productivo.

---

⚙️ Tecnologías a utilizar

El desarrollo de AGROX requiere un conjunto de tecnologías modernas que permitan construir una aplicación ágil, escalable y accesible para los agricultores.

Frontend y Desarrollo Móvil

• React Native: Desarrollo de aplicaciones móviles multiplataforma (Android e iOS) con una sola base de código en JavaScript.
• Expo / Expo Go: Simplifica el uso de React Native al integrar librerías listas para usar. Facilita pruebas y despliegues sin configuraciones complejas.
• JavaScript (ES6+): Lenguaje base del proyecto, ideal para interfaces dinámicas y escalables.

📦 Dependencias de producción

📥 Comandos de instalación únicos (copiar-pegar)

```bash npm install @expo-google-fonts/inter@^0.4.1
@react-native-async-storage/async-storage@^2.1.2
@react-native-community/datetimepicker@8.4.1
@react-native-masked-view/masked-view@^0.3.2
@react-native-picker/picker@^2.11.1
@react-navigation/drawer@^7.5.7
@react-navigation/native@^7.1.17
@react-navigation/stack@^7.4.7
axios@^1.12.2
expo@^53.0.20
expo-app-loading@^2.1.1
expo-constants@^17.1.7
expo-env@^1.1.1
expo-font@~13.3.2
expo-image-picker@~16.1.4
expo-linear-gradient@^14.1.5
expo-location@^19.0.7
expo-secure-store@^14.2.3
expo-splash-screen@~0.30.10
expo-status-bar@~2.2.3
firebase@^12.1.0
font@^0.0.4
react@19.0.0
react-native@0.79.5
react-native-dotenv@^3.4.11
react-native-dropdown-picker@^5.4.6
react-native-gesture-handler@~2.24.0
react-native-keyboard-aware-scroll-view@^0.9.5
react-native-reanimated@~3.17.4
react-native-responsive-screen@^1.4.2
react-native-safe-area-context@5.4.0
react-native-screens@~4.11.1
react-native-vector-icons@^10.3.0

🛠️ Dependencias de desarrollo

npm install -D @babel/core@^7.20.0

Backend y Base de Datos

• Firebase: Servicios en la nube como autenticación, Firestore (NoSQL), base de datos en tiempo real, hosting y almacenamiento.
• API de clima gratuita: Integración de información meteorológica en tiempo real para la tarjeta de clima local.

Control de versiones y colaboración

• Nombre del proyecto en GitHub: AGROX
• GitHub: Gestión del código fuente, historial de cambios y colaboración en equipo.
• Git Bash: Consola para ejecutar comandos Git en Windows de forma ágil.

Entorno de desarrollo

• Visual Studio Code: Editor de código ligero y potente, con soporte para extensiones de React Native, Firebase y GitHub.

Pruebas y calidad

• Jest: Framework de pruebas unitarias en JavaScript para asegurar confiabilidad y validar la lógica de negocio.

---

💻 Instalación

1. Clona este repositorio:

   git clone https://github.com/JoshRod20/AGROX.git

2. Accede a la carpeta del proyecto:

   cd agrox 

3. Instala dependencias:

   npm install

4. Inicia la aplicación en Expo Go:

   npx expo start

5. Escanea el código QR desde la app Expo Go en tu dispositivo móvil para ver la aplicación en tiempo real.

---

📲 Guía de descarga e instalación para usuarios (solo Android)

1. Visita la landing

Desde tu móvil Android entra a: [En_Proceso]

2. Descarga el APK

Pulsa el botón “Descargar AGROX”; se descargará el archivo agrox-release.apk.

3. Permite instalaciones externas

• Abre el archivo descargado.
• Si aparece el aviso “Instalar aplicaciones de fuentes desconocidas”, activa la opción “Permitir de esta fuente” solo para AGROX.

4. Instala y abre

Toca INSTALAR; al finalizar pulsa ABRIR o busca el ícono 🌱 en tu pantalla de inicio.

5. ¡Empieza a usarla!

Regístrate con tu correo o cuenta de Google y crea tu primer lote de cultivo en menos de un minuto.

¿Problemas con la instalación?
Escríbenos por WhatsApp: +505 En proceso o usa el chat en la web.

🚀 Uso

1. Regístrate como agricultor y crea tu primer lote de cultivo.
2. Registra actividades agrícolas (siembra, fertilización, riego, etc.).
3. Consulta el panel financiero y reportes en tiempo real.
4. Accede a la tarjeta de clima para planificar tus actividades según el pronóstico.
5. Compara variedades o ciclos productivos para optimizar tus decisiones.

---

📄 Licencia

Este proyecto se desarrolla con fines educativos y sociales.
Licencia: MIT.

---