Cabildo Gran Putumayo
Aplicación web en Django para gestionar eventos y usuarios, con generación y descarga de informes en PDF con WeasyPrint.
Django web application to manage events and users, with PDF report generation and downloads via WeasyPrint.
$ git clone https://github.com/YANCARLOSOFICIAL/cabildoGranPutumayo.git
$ cd cabildoGranPutumayo
// puntos clave
// key points
- Gestión de eventos: administración de eventos y usuarios con plantillas HTML y autenticación.
- Informes en PDF: generación y descarga de reportes con WeasyPrint directamente desde el servidor.
- Stack clásico y sólido: Django + MySQL, desplegable con entorno virtual y
requirements.txt.
// README.md del repositorio
Descargado del repositorio en cada build. Downloaded from the repository on every build.Proyecto Cabildo
Introducción
El proyecto Cabildo es una aplicación web desarrollada en Django que permite la gestión eficiente de eventos y usuarios. Esta aplicación ofrece una interfaz de usuario intuitiva basada en plantillas HTML, facilitando la administración de eventos y la autenticación de usuarios. Además, incluye la funcionalidad de generación y descarga de informes en formato PDF utilizando la biblioteca WeasyPrint.
Tecnologías Utilizadas
- Python
- Django
- MySQL
Instalación
Pasos de Instalación
Sigue los siguientes pasos para instalar y configurar el proyecto:
Clona el repositorio
Abre tu terminal y ejecuta los siguientes comandos:
cd cabildo_djangoCrea y activa un entorno virtual
Crea un entorno virtual y actívalo con los siguientes comandos:
python -m venv env env\Scripts\activate¿Error al activar el entorno virtual?
Si experimentas un error al intentar activar el entorno virtual, abre PowerShell como administrador y ejecuta:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUserLuego, cierra PowerShell.
Instala las dependencias
Instala todas las dependencias necesarias listadas en el archivo
requirements.txtejecutando:pip install -r requirements.txtInstala WeasyPrint en Windows
Para utilizar WeasyPrint en Windows, es necesario instalar algunas dependencias adicionales. Sigue estos pasos:
Instala Pango y GTK utilizando MSYS2. Descarga el instalador y sigue las instrucciones de instalación.
Después de la instalación, abre
MSYS2 UCRT64e ingresa los siguientes comandos:pacman -S mingw-w64-x86_64-pango pacman -S mingw-w64-x86_64-gtk4Si deseas desarrollar con GTK3, también puedes ejecutar:
pacman -S mingw-w64-ucrt-x86_64-gtk3Agrega el directorio
binde GTK a tu variable de entornoPATHsiguiendo estos pasos:Abre el cuadro de diálogo Ejecutar presionando
Win + R.Escribe el siguiente comando y presiona Enter:
sysdm.cplEn la ventana de Propiedades del sistema, ve a la pestaña
Opciones avanzadas.Haz clic en el botón
Variables de entorno.En
Variables del sistema, seleccionaPathy haz clic enEditar.Agrega la ruta al directorio
binde GTK:C:\msys64\ucrt64\bin
Configura la base de datos
Asegúrate de configurar correctamente tu base de datos en el archivo
settings.py.Aplica las migraciones
Ejecuta los siguientes comandos para aplicar las migraciones:
python manage.py makemigrations python manage.py migrateInicia el servidor de desarrollo
Para iniciar el servidor de desarrollo, utiliza el siguiente comando:
python manage.py runserver
Estructura del Proyecto
La estructura del proyecto es la siguiente:
proyecto_cabildo/
├── .gitignore
├── env
└── media
│ └── eventos
│ └── eventos.jpg
├── CabildoGranPutumayo/
│ ├── __pycache__
│ ├── __init__.py
│ ├── asgi.py
│ ├── settings.py
│ ├── urls.py
│ └── wsgi.py
└── main/
├── __pycache__
├── migrations/
├── static/
│ └── img/
├── templates/
│ ├── bases/
│ │ └── etc.html
│ ├── eventos/
│ │ └── etc.html
│ ├── login/
│ │ └── etc.html
│ └── usuarios/
│ └── etc.html
├── __init__.py
├── admin.py
├── apps.py
├── context_processors/
├── forms/
├── models.py
├── tests.py
├── url.py
└── views.py