📋 PRD - Rutas de Solidaridad

Sistema de Gestión de Ayuda Humanitaria

🚀 Emergencia Venezuela

📌 Visión General del Proyecto

Propósito: Sistema web para gestionar la distribución de ayuda humanitaria a familias afectadas por el terremoto en La Guaira, Venezuela.

🌍 Contexto: Terremoto doble el 24 de junio en Venezuela. Principal afectación: estado La Guaira. Familias aisladas y desplazadas sin acceso a ayuda. Voluntarios organizándose para cubrir necesidades básicas.

Usuarios del Sistema

🛡️
Admin
Control total del sistema
🤝
Voluntarios
Registran y entregan ayuda
👨‍👩‍👧‍👦
Afectados
Se registran para recibir ayuda
🎁
Donantes
Registran donaciones

🎯 Alcance del Proyecto

✅ Dentro del Alcance

  • Registro de afectados con geolocalización
  • Sistema de inventario en tiempo real
  • Gestión de donaciones (dinero e insumos)
  • Asignación de voluntarios
  • Seguimiento de entregas
  • Mapa de necesidades
  • Dashboard con KPIs
  • Alertas de stock bajo
  • PWA para funcionamiento offline
  • Reportes y exportación de datos

❌ Fuera del Alcance (Fase 1)

  • Aplicación móvil nativa (será PWA)
  • Sistema de pagos en línea
  • Chat en tiempo real (futura fase)
  • Inteligencia artificial avanzada

🏗️ Arquitectura Técnica

⚛️
Frontend
React + Vite + Tailwind CSS
🗄️
Backend
Supabase (PostgreSQL + Auth)
🔒
Seguridad
RLS Row Level Security
🌐
Hosting
cPanel - voluntariado.foresve.com

📱 Funcionalidades Detalladas

1. 🔐 Sistema de Autenticación

2. 👨‍👩‍👧‍👦 Registro de Afectados

3. 🎁 Gestión de Donaciones

4. 📦 Sistema de Inventario

Stock Normal Stock Bajo Stock Crítico

5. 📋 Asignación de Ayuda

6. 🤝 Gestión de Voluntarios

7. 🗺️ Mapa y Geolocalización

8. 📊 Reportes y Analytics

📊
Dashboard con KPIs en tiempo real
📄
Reportes exportables a PDF y Excel
📈
Estadísticas de necesidades y productos
⏱️
Tiempo promedio de entrega

9. 🔄 Seguimiento de Afectados

10. 📱 PWA y Offline Mode

11. ⚙️ Administración

🗄️ Estructura de Base de Datos

11
Tablas Principales
4
Relaciones Clave
🔒
RLS
Row Level Security
📝
Auditoría
Trazabilidad completa
#TablaDescripción
1voluntariosDatos de voluntarios
2afectadosDatos de afectados
3donacionesRegistro de donaciones
4productosCatálogo de productos
5inventario_ubicacionStock por ubicación
6movimientos_inventarioHistorial de movimientos
7asignacionesAsignación de ayudas
8alertas_inventarioAlertas automáticas
9seguimiento_afectadosHistorial de seguimiento
10ubicacionesCentros de acopio
11categorias_productosCategorías

Relaciones Clave

donaciones → movimientos_inventario (ingreso)
asignaciones → movimientos_inventario (salida)
asignaciones → voluntarios y afectados
afectados → seguimiento_afectados

📱 Interfaces de Usuario

1. Dashboard Principal

┌─────────────────────────────────────────────┐ │ 🆘 RUTAS DE SOLIDARIDAD - DASHBOARD │ ├─────────────────────────────────────────────┤ │ 📊 ESTADÍSTICAS │ │ 156 48 23 89 │ │ Fam Don Vol Pend │ │ │ │ 📍 MAPA DE NECESIDADES │ │ [Google Maps con marcadores] │ │ │ │ ⚠️ ALERTAS │ │ • Stock crítico: Leche (12l) │ │ • 5 familias sin agua - Catia La Mar │ ├─────────────────────────────────────────────┤ │ [Dashboard] [Donaciones] [Inventario] │ │ [Afectados] [Voluntarios] [Reportes] │ └─────────────────────────────────────────────┘

2. Registro de Afectado

┌─────────────────────────────────────────────┐ │ 👨‍👩‍👧‍👦 REGISTRAR AFECTADO │ ├─────────────────────────────────────────────┤ │ Nombre: [ ]│ │ Cédula: [ ]│ │ Teléfono: [______________ ]│ │ 📍 [GEOLOCALIZACIÓN AUTOMÁTICA ]│ │ │ │ Integrantes: │ │ Adultos:[] Niños:[] Mayores:[] │ │ │ │ Necesidades: │ │ ☑ Agua ☑ Alimentos ☐ Medicinas │ │ ☐ Ropa ☐ Pañales ☐ Otros │ │ │ │ Prioridad: [🔴 Alta] │ │ │ │ [REGISTRAR AFECTADO] │ └─────────────────────────────────────────────┘

3. Inventario en Tiempo Real

┌─────────────────────────────────────────────┐ │ 📦 INVENTARIO EN TIEMPO REAL │ ├─────────────────────────────────────────────┤ │ 🥫 1,450 💧 2,800 💊 340 👕 890 │ │ Alim Agua Med Ropa │ │ │ │ CATEGORÍAS: [Todo] [Alimentos] [Agua] │ │ │ │ Arroz ████████████░░ 850kg [85%] 🟢 │ │ Agua ██████████░░░░ 800l [60%] 🟡 │ │ Leche ██░░░░░░░░░░░░ 12l [10%] 🔴 │ │ │ │ [REGISTRAR MOVIMIENTO] [VER ALERTAS] │ └─────────────────────────────────────────────┘

4. Asignación de Ayuda

┌─────────────────────────────────────────────┐ │ 📋 ASIGNAR AYUDA │ ├─────────────────────────────────────────────┤ │ AFECTADO: María Rodríguez │ │ Prioridad: 🔴 Alta │ │ Familia: 4 integrantes │ │ │ │ DONACIONES DISPONIBLES: │ │ 🥫 20kg Arroz - Centro 1 │ │ 💧 10l Agua - Centro 2 │ │ │ │ VOLUNTARIO: [Juan Pérez ▼] │ │ │ │ [ASIGNAR AYUDA] [VER RUTA] │ └─────────────────────────────────────────────┘

🔄 Flujos de Trabajo Principales

Flujo 1: Donación → Inventario → Entrega

DONACIÓN → INVENTARIO → ASIGNACIÓN → ENTREGA → SEGUIMIENTO
Donante Stock + Alerta Afectado / Selección Voluntario / Entrega Historial / Actualización

Flujo 2: Registro de Afectado

LINK PÚBLICO → FORMULARIO → GEOLOCALIZACIÓN → PRIORIDAD → BASE DE DATOS

Flujo 3: Seguimiento

ASIGNACIÓN → VOLUNTARIO → ENTREGA → FOTO → ACTUALIZAR ESTADO → PRÓXIMO SEGUIMIENTO

🔐 Seguridad y Privacidad

🔒
RLS en todas las tablas
📝
Log de todas las acciones
👤
Roles: Admin, Voluntario, Público
🔍
Trazabilidad de cambios

🚀 Fases de Implementación

🔴 Fase 1 - Emergencia

Semana 1

  • Registro de afectados
  • Dashboard básico
  • Inventario simple

🟡 Fase 2 - Operativa

Semana 2-3

  • Sistema completo de donaciones
  • Gestión de voluntarios
  • Asignación de ayudas
  • Mapa de necesidades

🟢 Fase 3 - Optimización

Semana 4

  • PWA offline
  • Reportes avanzados
  • Notificaciones push
  • Análisis de datos

📋 Checklist de Entrega

📋 PRD - Rutas de Solidaridad

Versión 1.0 — Creado: 26/06/2024

Organización: Foresve — La Guaira, Venezuela

Este documento guía todo el desarrollo del sistema