Thanks to visit codestin.com
Credit goes to github.com

Skip to content

VoluntApp es un proyecto educativo desarrollado con Python (Flask) que conecta a usuarios con oportunidades de voluntariado en Madrid. Ofrece registro e inicio de sesión para voluntarios, organizaciones y administradores, un mapa interactivo, inscripción a actividades, gestión de horas y generación de reportes, además de un panel de administración.

License

Notifications You must be signed in to change notification settings

marichu-kt/VoluntApp

Repository files navigation

VoluntApp - Plataforma de Voluntariado Social 🌍

VoluntApp Banner

¡Bienvenido/a a VoluntApp! Este proyecto es un prototipo educativo que integra varias tecnologías para demostrar cómo crear una aplicación web (y base para móvil) que conecte a personas con actividades de voluntariado y responsabilidad social.

✨ Características Principales

  • Registro e Inicio de Sesión (Flask-Login y WTForms)
    • Soporta distintos roles: voluntario, organización y administrador.
  • Mapa Interactivo (Folium)
    • Centrado en Madrid, con marcadores de organizaciones reales (Banco de Alimentos, Cruz Roja).
  • Gestión de Actividades
    • Crear y listar oportunidades de voluntariado.
    • Inscribirse y registrar la participación.
  • Registro de Horas
    • Cada usuario voluntario va sumando sus horas.
  • Reportes en PDF (ReportLab)
    • Permite exportar fácilmente el listado de actividades y horas.

⚙️ Tecnologías y Librerías

  • Python (3.x)
  • Flask (microframework web)
  • Flask-Login (gestión de sesiones de usuario)
  • Flask-WTF y WTForms (creación y validación de formularios)
  • SQLite (base de datos local)
  • Folium (integración de mapas interactivos)
  • ReportLab (generación de reportes en PDF)
  • Werkzeug Security (hashing de contraseñas)

🏗️ Estructura del Código

En un solo archivo VoluntApp.py para fines didácticos:

  1. Modelos (User, Organizacion, Actividad) con SQLAlchemy.
  2. Formularios WTForms (RegisterForm, LoginForm, ActividadForm).
  3. Rutas de Flask para registro, login, mapa, actividades, PDF, etc.
  4. Plantillas incrustadas mediante render_template_string (idealmente se usarían archivos HTML en /templates).
  5. Inicialización de la base de datos y creación de usuarios y organizaciones de ejemplo.

🚀 Ejecución

  1. Instalar dependencias:
    pip install flask flask_sqlalchemy flask_login flask_wtf wtforms folium reportlab
  2. Iniciar la aplicación:
    python VoluntApp.py

About

VoluntApp es un proyecto educativo desarrollado con Python (Flask) que conecta a usuarios con oportunidades de voluntariado en Madrid. Ofrece registro e inicio de sesión para voluntarios, organizaciones y administradores, un mapa interactivo, inscripción a actividades, gestión de horas y generación de reportes, además de un panel de administración.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages