FireOPS: Trazabilidad Logística en Incendios Forestales y Eventos de Quema Controlada 🚒🛡️🔗

Este proyecto es una Aplicación Descentralizada (dApp) basada en tecnología Blockchain (EVM) y diseñada para ser desplegada en redes de la familia Ethereum (como Mainnet, Sepolia o Polygon). Su propósito es gestionar la logística, el inventario y la cadena de custodia en el combate de Incendios Forestales y la ejecución de Quemas Controladas preventivas.

📋 Requisitos Previos

Antes de comenzar, asegúrese de tener instalado:

• Node.js (v18 o superior)
• NPM (v9 o superior)
• Foundry (Forge, Anvil, Cast) - Instrucciones de instalación
• jq (Herramienta para procesar JSON en scripts) - sudo apt install jq (en Linux/WSL)

🚀 Guía de Instalación Rápida

Siga estos pasos para poner en marcha el sistema en su máquina local:

1. Clonar el repositorio e instalar dependencias

# Instalar dependencias del core y herramientas
npm install

# Instalar dependencias del frontend
cd frontend
npm install
cd ..

2. Configuración de Variables de Entorno

# Crear el archivo .env a partir del ejemplo
cp .env.example .env

Nota: El archivo .env ya viene pre-configurado para funcionar en localhost (127.0.0.1).

3. Iniciar la Blockchain Local (Anvil)

Abra una nueva terminal y ejecute:

npm run start-anvil

Este comando inicia Anvil con 20 cuentas predeterminadas y persistencia de estado.

4. Despliegue y Sembrado (Bootstrap)

En la terminal principal, ejecute el script de inicialización automática:

npm run bootstrap

Este script automatiza:

1. Despliegue del Smart Contract.
2. Sincronización de la dirección del contrato en el .env y el Frontend.
3. Sincronización de ABIs.
4. Carga inicial de Inventario y Roles (Alice, Bob, Sung, etc.).

5. Iniciar la Interfaz Web

cd frontend
npm run dev

Acceda a http://localhost:5173 en su navegador.

---

🖥️ Opción Avanzada: Centro de Mando Táctico (Dashboard)

Si dispone de tmux instalado, puede arrancar todo el ecosistema (Anvil + Bootstrap + Frontend + Logs) en una sola terminal unificada:

npm run monitor

Este comando divide su pantalla en 4 paneles operativos para un monitoreo en tiempo real de la blockchain y la red.

---

🛠️ Credenciales de Prueba (Metamask)

Para interactuar con la dApp, importe las siguientes cuentas predeterminadas de Anvil en Metamask:

Actor	Cuenta #	Dirección	Rol en Sistema
Administrador	0	0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266	Gestión Global / Auditor
Base Operativa	1	0x70997970C51812dc3A010C7d01b50e0d17dc79C8	Alice Liang - Logística / Devoluciones
Jefe de Escena	4	0x15d34AAf54267DB7D7c367839AAf71A00a2C6A65	Aura Frasier (Cmdte Incidentes)
Brigadista	7	0x14dC79964da2C08b23698B3D3cc7Ca32193d9955	Sung Jin-woo (Personal Campo)

Clave Privada General (Cta #0): 0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80

---

📄 Documentación Adicional

• Informe Técnico
• Libreto de Simulación
• Arquitectura de Datos

Desarrollado por: CBT Propósito: PFM Ethereum para CodeCrypto Academy.