Skip to content

README.es.md

Latest commit

 

History

History
90 lines (69 loc) · 2.77 KB

README.es.md

File metadata and controls

90 lines (69 loc) · 2.77 KB

🌐 Português (BR) | Español

🎯 Soc Ops — Social Bingo

¡Rompe el hielo, haz conexiones, gana en networking!

Soc Ops es un juego interactivo de bingo social diseñado para encuentros presenciales, eventos de equipo y conferencias. ¡Encuentra personas que coincidan con las preguntas, marca tu cartón y corre para conseguir 5 en fila!

✨ Características

  • 🎲 Tableros aleatorios — Cada jugador recibe una disposición única
  • 💾 Progreso guardado automáticamente — Continúa donde lo dejaste
  • 🏆 Detección de bingo — Detección automática de victorias en filas, columnas y diagonales
  • 🎉 Modal de celebración — Pantalla de victoria digna de confeti
  • 📱 Mobile-first — Funciona genial en teléfonos durante eventos

🚀 Inicio Rápido

Requisitos previos

Ejecutar localmente

uv sync
uv run uvicorn app.main:app --reload --port 8000
# Abrir http://localhost:8000

Pruebas

uv run pytest

Lint

uv run ruff check .

🎨 Personaliza tu Juego

Cambiar Preguntas

Edita app/data.py para agregar tus propios prompts de presentación:

questions_list: list[str] = [
    "tiene una mascota",
    "habla más de 2 idiomas",
    "tu pregunta personalizada aquí",
    # ... 24+ preguntas para un tablero completo
]

Guía del Workshop

👉 Sigue la Guía del Lab para una experiencia práctica con los agentes de GitHub Copilot.

🛠️ Tecnologías

  • Framework: FastAPI + Jinja2 + HTMX
  • Estilos: Utilidades CSS personalizadas (inspirado en Tailwind)
  • Estado: Sesiones server-side con persistencia en cookies
  • Despliegue: GitHub Pages via Actions

📁 Estructura del Proyecto

app/
├── templates/       # Plantillas Jinja2
│   ├── base.html
│   ├── home.html
│   └── components/  # bingo_board, bingo_modal, game_screen, start_screen
├── static/          # Archivos CSS & JS
├── models.py        # Estado del juego & modelos de datos
├── game_logic.py    # Detección de bingo & generación de tableros
├── game_service.py  # Gestión de sesiones
├── data.py          # Banco de preguntas
└── main.py          # Rutas FastAPI
tests/
├── test_api.py      # Pruebas de endpoints de API
└── test_game_logic.py  # Pruebas unitarias de lógica del juego

🚢 Despliegue

Se despliega automáticamente en GitHub Pages con cada push a main:

  • Tu juego: https://{usuario}.github.io/{nombre-del-repo}

📝 Licencia

MIT — ¡úsalo para tu próximo evento!
⚡