Las Manos de Ophelia 💚

Plataforma humanitaria descentralizada para Venezuela

---

🎯 ¿Qué es esto?

Las Manos de Ophelia es una iniciativa ciudadana sin fines de lucro que canaliza ayuda humanitaria directamente a comunidades vulnerables de Venezuela mediante tecnología descentralizada (Web3), auditoría comunitaria en tiempo real y contratos inteligentes simulados.

El 100% del capital fluye mediante validación P2P directo a las zonas de emergencia — sin intermediación gubernamental, sin burocracia.

---

🏗️ Tecnologías

Capa	Tecnología
Frontend	HTML5 + Tailwind CSS + Vanilla JS
Backend	Firebase (Auth, Firestore, Storage, Functions)
Mapas	Leaflet.js
Iconos	Phosphor Icons
Simulación Web3	LocalStorage + Firebase Realtime DB

---

📁 Estructura del Proyecto

las-manos-de-ophelia/
├── index.html                  ← Landing page principal
├── login.html                  ← Autenticación de usuarios
├── voluntario.html             ← Portal de voluntarios
├── registro_donador.html       ← Registro de donadores
│
├── pages/                      ← Páginas informativas
├── dashboards/                 ← Paneles de control (rutas protegidas)
├── assets/
│   ├── img/                    ← Recursos gráficos
│   └── js/
│       ├── ophelia_utils.js    ← Utilidades globales
│       └── firebase_config.js  ← Configuración Firebase (local only)
│
├── config.example.js           ← Plantilla de configuración pública
├── firebase.json               ← Configuración Firebase Hosting
└── firestore.rules             ← Reglas de seguridad Firestore

---

🚀 Instalación Local

# 1. Clonar el repositorio
git clone https://github.com/TU_USUARIO/las-manos-de-ophelia.git
cd las-manos-de-ophelia

# 2. Configurar Firebase
cp config.example.js config.local.js
# Editar config.local.js con tus credenciales de Firebase

# 3. Instalar Firebase CLI (primera vez)
npm install -g firebase-tools

# 4. Iniciar sesión en Firebase
firebase login

# 5. Servir localmente
firebase serve

---

🔐 Seguridad

⚠️ Datos que NUNCA deben subirse al repositorio:

• Datos reales de beneficiarios o voluntarios
• Claves privadas de wallets
• Archivos .env o config.local.js
• Fotos o información identificable de personas

Para reportar una vulnerabilidad de seguridad, lee SECURITY.md.

---

🤝 Contribuir

Este es un proyecto de código abierto de carácter humanitario. Lee CONTRIBUTING.md antes de enviar un Pull Request.

---

📄 Licencia

Creative Commons BY-NC 4.0 — Libre para uso no comercial con atribución.

---

Hecho con 💚 para Venezuela