Skip to content

fuegoaustral/ticketera

BranchesTags

Repository files navigation

🎫 Ticketera de FA

Sistema de venta de tickets para eventos de Fuego Austral 🔥

Python Django AWS Lambda Zappa

📋 Índice

🚀 Características

  • 🎟️ Gestión de eventos - Crear y administrar eventos de manera sencilla
  • 💳 Pagos integrados - Integración con MercadoPago para procesamiento de pagos
  • 🔐 Autenticación - Login con Google OAuth2
  • 📧 Notificaciones - Sistema de emails automáticos
  • ☁️ Deploy automático - CI/CD con GitHub Actions
  • 🐍 Python 3.13 - Última versión de Python con mejoras de rendimiento

🛠️ Desarrollo Local

📋 Requisitos Previos

  • PostgreSQL (v16.8 en producción, v15.6+ en desarrollo. En cualquier momento migramos todo a 17) 🐘
  • Python 3.13 (última versión) 🐍
  • Git para clonar el repositorio 📦

⚙️ Configuración del Entorno

🔧 Variables de Entorno

Crea un archivo .env basado en el template:

cp env.example .env

📝 Configura las variables de base de datos en tu archivo .env:

  • DB_HOST - Host de tu base de datos PostgreSQL
  • DB_USER - Usuario de la base de datos
  • DB_DATABASE - Nombre de la base de datos
  • DB_PASSWORD - Contraseña de la base de datos

🐍 Configuración de Python

  1. Crear entorno virtual 🌐
python3.13 -m venv venv
source venv/bin/activate

💡 Tip: Para salir del entorno virtual ejecuta deactivate

  1. Instalar dependencias 📦
(venv)$ pip install -r requirements.txt
(venv)$ pip install -r requirements-dev.txt
  1. Configurar settings locales ⚙️
(venv)$ cp deprepagos/local_settings.py.example deprepagos/local_settings.py

🗄️ Base de Datos Local

  1. Iniciar PostgreSQL 🚀
# macOS
brew services start postgresql@17

# Ubuntu/Debian
sudo systemctl start postgresql
  1. Crear base de datos 🏗️
(venv)$ createdb deprepagos_development
  1. Aplicar migraciones 🔄
(venv)$ python manage.py migrate
  1. Crear usuario administrador 👤
(venv)$ python manage.py createsuperuser

🔄 Migración de Base de Datos

Si necesitas migrar datos desde PostgreSQL 15 (producción) a PostgreSQL 17 (local), usa nuestro script automatizado:

📋 Proceso de Migración

  1. Configurar variables de entorno en tu archivo .env:

    DB_HOST=tu_host_de_produccion
DB_USER=tu_usuario
DB_DATABASE=tu_database
DB_PASSWORD=tu_password

  2. Ejecutar migración completa:

    ./migrate_db.sh all

  3. O ejecutar paso a paso:

    ./migrate_db.sh dump      # Hacer dump desde producción
./migrate_db.sh create    # Crear nuevo schema
./migrate_db.sh restore   # Restaurar datos

🎯 Opciones del Script

  • dump - Hacer dump desde PostgreSQL 15 (producción)
  • create - Crear nuevo schema en PostgreSQL 17 (local)
  • restore - Restaurar dump en el nuevo schema
  • all - Ejecutar todo el proceso completo
  • help - Mostrar ayuda

⚙️ Configurar Django para Nuevo Schema

Después de la migración, actualiza tu local_settings.py:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'postgres',
        'USER': 'tu_usuario',
        'PASSWORD': 'tu_password',
        'HOST': 'localhost',
        'PORT': '5432',
        'OPTIONS': {
            'options': '-c search_path=ticketera_new,public'
        }
    }
}

💡 Tip: El script crea un schema llamado ticketera_new para mantener los datos separados del schema public

🔗 Integraciones Externas

💳 MercadoPago

  1. Crear usuario de prueba en MercadoPago 🧪

  2. Configurar variables:

    • MERCADOPAGO_PUBLIC_KEY
    • MERCADOPAGO_ACCESS_TOKEN
    • MERCADOPAGO_WEBHOOK_SECRET

  3. Configurar webhook apuntando a {tu_url_local}/webhooks/mercadopago 🔗

🌐 Para exponer tu servidor local: Usa Cloudflare Tunnel o ngrok

🔐 Google OAuth2

  1. Crear proyecto en Google Cloud Platform ☁️
  2. Habilitar Google+ API 📡
  3. Crear credenciales OAuth 2.0 🔑
  4. Configurar variables:
    • GOOGLE_CLIENT_ID
    • GOOGLE_CLIENT_SECRET
  5. Agregar URI de redirección: {tu_url_local}/accounts/google/login/callback/ 🔄

📧 Testing de Emails

Usa Mailtrap para testing de emails 📬

  1. Crear cuenta en Mailtrap
  2. Obtener credenciales SMTP de Email Testing > Inboxes > SMTP
  3. Configurar en tu .env

🏃‍♂️ Ejecutar el Servidor

(venv)$ python manage.py runserver

¡Listo! 🎉 Tu aplicación estará disponible en http://127.0.0.1:8000

🛠️ Herramientas de Desarrollo

🗄️ Script de Migración de Base de Datos

El proyecto incluye un script automatizado para migrar datos entre diferentes versiones de PostgreSQL:

📁 Archivos Incluidos

  • migrate_db.sh - Script principal de migración
  • env.example - Template de variables de entorno

🚀 Uso Rápido

# Configurar variables de entorno
cp env.example .env
# Editar .env con tus datos

# Ejecutar migración completa
./migrate_db.sh all

🔧 Características del Script

  • ✅ Carga automática de variables desde .env
  • ✅ Compatibilidad con PostgreSQL 15 → 16+
  • ✅ Creación automática de base de datos ticketera_local
  • ✅ Dump optimizado con opciones avanzadas
  • ✅ Limpieza automática de archivos temporales
  • ✅ Manejo de foreign keys circulares
  • ✅ Mensajes informativos con colores
  • ✅ Manejo de errores robusto

📋 Comandos Disponibles

./migrate_db.sh help        # Mostrar ayuda
./migrate_db.sh check       # Verificar dependencias del sistema
./migrate_db.sh dump        # Hacer dump desde producción
./migrate_db.sh create      # Crear base de datos ticketera_local
./migrate_db.sh restore     # Restaurar datos
./migrate_db.sh cleanup     # Limpiar archivos de dump
./migrate_db.sh drop-db     # Eliminar base de datos ticketera_local
./migrate_db.sh test-local  # Verificar conexión local
./migrate_db.sh test-remote # Verificar conexión remota
./migrate_db.sh test-all    # Verificar ambas conexiones
./migrate_db.sh all         # Proceso completo

🔧 Verificación de Dependencias

El script verifica automáticamente que tengas todas las dependencias necesarias:

  • ✅ PostgreSQL 16+ (local)
  • ✅ Homebrew (para instalación)
  • ✅ Archivo .env (configuración)

Si faltan dependencias, el script te dará instrucciones específicas de instalación.

⚡ Optimizaciones del Dump

El script utiliza opciones avanzadas de pg_dump para mayor eficiencia:

  • --disable-triggers - Evita problemas con foreign keys circulares
  • --no-owner --no-privileges - Ignora permisos específicos del sistema
  • --exclude-schema - Excluye schemas del sistema y de Supabase
  • Limpieza automática - Elimina archivos de dump anteriores antes de crear nuevos
  • Eliminación robusta de BD - Termina conexiones activas antes de eliminar la base de datos
  • Manejo de conflictos - Ignora errores de schemas/tablas existentes durante la restauración
  • Estadísticas de archivos - Muestra el tamaño de cada archivo creado

🚀 Deploy

⚠️ IMPORTANTE: Todos los deploys se realizan exclusivamente por CI/CD (GitHub Actions). No se hacen deploys manuales.

🔄 Flujo de Deploy Completo

1️⃣ Desarrollo → Dev Environment

# 1. Crear feature branch desde dev
git checkout dev
git pull origin dev
git checkout -b feature/nueva-funcionalidad

# 2. Hacer cambios y commit
git add .
git commit -m "feat: agregar nueva funcionalidad"

# 3. Push y crear PR a dev
git push origin feature/nueva-funcionalidad
# Crear PR en GitHub: feature/nueva-funcionalidad → dev

⚡ Deploy automático a dev: Al mergear el PR a dev, GitHub Actions despliega automáticamente

2️⃣ Testing en Dev Environment

  • 🧪 Probar la funcionalidad en https://dev.fuegoaustral.org
  • ✅ Verificar que todo funciona correctamente
  • 🔍 Revisar logs y métricas

3️⃣ Dev → Production

# 1. Crear PR de dev a main
# En GitHub: Crear PR dev → main

# 2. Revisar y mergear
# Después de revisión, mergear el PR

# 3. Deploy automático a producción
# GitHub Actions despliega automáticamente a prod

🚀 Deploy automático a prod: Al mergear dev → main, se despliega automáticamente a producción

📋 Reglas de Deploy

✅ Permitido

  • ✅ Push a feature/* branches
  • ✅ PRs a dev branch
  • ✅ PRs de dev a main

🚫 Prohibido

  • 🚫 Push directo a dev (excepto hotfixes críticos o que estes vibrando expresion radical ✨ y sepas lo que estas haciendo. Mandale cumbia rey)
  • 🚫 Push directo a main (NUNCA)
  • 🚫 Deploys manuales con Zappa

🆘 Hotfixes Críticos

En caso de emergencia crítica:

# 1. Crear hotfix desde main
git checkout main
git pull origin main
git checkout -b hotfix/fix-critico

# 2. Aplicar fix y commit
git add .
git commit -m "hotfix: fix crítico urgente"

# 3. Push y crear PR directo a main
git push origin hotfix/fix-critico
# Crear PR: hotfix/fix-critico → main

# 4. OBLIGATORIO: Backport a dev después
git checkout dev
git cherry-pick <commit-hash>
git push origin dev

🏗️ Configuración Docker (Solo para Emergencias)

⚠️ Solo usar en emergencias: El deploy normal es 100% automático

# Construir imagen Docker
docker build . -t ticketera-zappashell

# Crear alias para facilitar el uso
alias zappashell='docker run -ti -e AWS_PROFILE=ticketera -v "$(pwd):/var/task" -v ~/.aws/:/root/.aws --rm ticketera-zappashell'

# Usar el shell (solo emergencias)
zappashell
zappashell> zappa update prod

📁 Archivos Estáticos

Los archivos estáticos se manejan automáticamente en el pipeline:

# Esto se ejecuta automáticamente en CI/CD
python manage.py collectstatic --settings=deprepagos.settings_prod

🎪 Agregar un Nuevo Evento

📖 Documentación completa: Google Doc

💡 Tip: Comparte este documento con el equipo de comunicación y diseño cuando prepares un nuevo evento

🏗️ Arquitectura

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   Frontend      │    │   Django App     │    │   AWS Lambda    │
│   (Templates)   │◄──►│   (Python 3.13)  │◄──►│   (Zappa)       │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                                │
                                ▼
                       ┌──────────────────┐
                       │   PostgreSQL     │
                       │   (RDS v16.8)    │
                       └──────────────────┘

🛠️ Tecnologías

  • Backend: Django 4.2 + Python 3.13 🐍
  • Base de Datos: PostgreSQL 16.8 (producción) / 15.6 (desarrollo) 🐘
  • Deploy: AWS Lambda + Zappa ☁️
  • CI/CD: GitHub Actions 🚀
  • Pagos: MercadoPago 💳
  • Auth: Google OAuth2 🔐
  • Emails: Django + SMTP 📧
  • Herramientas: Scripts de migración automatizados 🔧

🔧 Troubleshooting

❌ Problemas Comunes

🐍 Error de Python/PostgreSQL

# Si psql no se encuentra
export PATH="/opt/homebrew/Cellar/postgresql@17/17.6/bin:$PATH"

# Si hay problemas de permisos
sudo chown -R $(whoami) /opt/homebrew/var/postgresql@17

🗄️ Problemas de Base de Datos

# Verificar conexión a PostgreSQL
/opt/homebrew/Cellar/postgresql@17/17.6/bin/psql -d postgres -c "SELECT version();"

# Reiniciar PostgreSQL
brew services restart postgresql@17

# Ver logs de PostgreSQL
tail -f /opt/homebrew/var/log/postgresql@17.log

🔄 Problemas de Migración

# Verificar dependencias del sistema
./migrate_db.sh check

# Verificar conexiones
./migrate_db.sh test-all

# Verificar variables de entorno
./migrate_db.sh help

# Verificar conexión a base de datos remota manualmente
/opt/homebrew/Cellar/postgresql@16/16.10/bin/psql -h $DB_HOST -U $DB_USER -d $DB_DATABASE -c "SELECT 1;"

🚀 Problemas de Deploy

# Verificar AWS credentials
aws sts get-caller-identity

# Verificar Zappa
source venv/bin/activate && zappa status dev

# Ver logs de Lambda
zappa tail dev

📋 Comandos Útiles

# Verificar estado del proyecto
python manage.py check

# Verificar migraciones pendientes
python manage.py showmigrations

# Crear migraciones
python manage.py makemigrations

# Aplicar migraciones
python manage.py migrate

# Cargar datos de prueba
python manage.py loaddata fixtures/initial_data.json

📞 Soporte

¿Necesitas ayuda? 🤔

Hecho con ❤️ por el equipo de Fuego Austral 🔥

About

No description, website, or topics provided.

Resources

Readme
Activity
Custom properties

Stars

3 stars

Watchers

2 watching

Forks

2 forks
Report repository

Releases

No releases published

Packages

No packages published

Contributors 9

Languages