Guía para docentes

1. Usar un juego en clase

• Los juegos disponibles están en teaching.beer-lab.org (lo que ven tus estudiantes) y, desde tu lado, en teaching-admin.beer-lab.org: panel, salas, configuraciones, duración y qué resultados muestra cada uno.
• Escribe al laboratorio indicando el juego, la materia, el número de estudiantes y la fecha; te damos acceso al panel del juego (https://<juego>.beer-lab.org/login). Con eso puedes correr tantas sesiones como grupos tengas.
• Los estudiantes no necesitan cuenta ni instalar nada: abren teaching.beer-lab.org desde el celular, buscan el juego indicado por el docente y eligen su idioma.

2. Paso a paso de una sesión

1. Antes de la clase: entra al panel (https://<juego>.beer-lab.org/login, usuario admin), crea una sesión desde Demo y recórrela con dos o tres pestañas para conocer las pantallas y el reporte.
2. En clase: Rooms → salón de tu idioma → Create session. Elige la configuración (por ejemplo, una ronda o diez rondas) y el número de participantes, con algunos de sobra. El idioma es por sesión: una sesión creada en el salón en español solo recibe a quienes entran por el botón Español, y viceversa. Si tu grupo es mixto, elige un idioma para toda la sesión o crea una sesión por idioma.
3. Proyecta o comparte teaching.beer-lab.org e indica el nombre del juego y el idioma. Cada estudiante busca el juego en el directorio, pulsa el botón de su idioma y espera en la pantalla de bienvenida hasta que se completa el grupo.
4. Sigue el avance en Monitor. Si alguien se queda atrás, ahí ves en qué página está.
5. Al final, pestaña Report de la sesión (en los juegos que la incluyen) para proyectar los resultados agregados y discutirlos; Data → Export para bajar el CSV si quieres trabajarlo en clase.
6. Rooms → Close session para dejar la sala lista para el siguiente grupo.

3. Proponer un juego nuevo

Cualquier docente puede proponer un juego de oTree para la colección. Requisitos para que quepa en la ruta de docencia:

• Interfaz para participantes en celular, con portada del BEER Lab, instrucciones y control de comprensión.
• Resultados para proyectar: idealmente un reporte agregado (pestaña Report) o, al menos, datos exportables que se puedan graficar en clase.
• Salas (Rooms) por idioma o por variante, para que las sesiones se creen sin tocar configuración.
• Textos sin terminaciones (a)/(o); nada de datos personales de estudiantes.

Parte de la plantilla del laboratorio — pública en github.com/ecastrom/otree_template, con páginas de ejemplo y guía de diseño — o del juego del dictador ya publicado, que sirve de ejemplo de un juego docente completo (tres variantes, dos idiomas, reporte para docentes); pide su código al correo del laboratorio.

Estructura y reglas técnicas

mi_juego/
├── settings.py          ← en la raíz; ROOMS y SESSION_CONFIGS aquí
├── requirements.txt     ← otree==6.x.y  y  psycopg2-binary
├── mi_app/              ← __init__.py, templates/, admin_report.html (opcional)
├── _static/  _templates/ ← logotipo, página de bienvenida de la sala

• ADMIN_PASSWORD = environ.get('OTREE_ADMIN_PASSWORD') y SECRET_KEY = environ.get('OTREE_SECRET_KEY', ...); no definas DATABASE_URL, DEBUG ni AUTH_LEVEL.
• Prueba antes de enviar: otree test <config> para cada configuración y un recorrido completo en un celular.
• Nombre del subdominio: el del juego, en minúsculas, 3–20 caracteres (dictator, ultimatum, bienes-publicos).

4. Enviar el proyecto

Comprime la carpeta en <nombre>-v1.zip (sin .venv, db.sqlite3, __pycache__ ni datos) y envíalo a [email protected] con el asunto [oTree] <nombre> v1 — docencia. Incluye en el correo:

settings.py y requirements.txt deben quedar en la raíz del zip (o dentro de una sola carpeta); el servidor acepta hasta 40 MB. No hace falta Procfile, runtime.txt ni Dockerfile: el servidor usa su propia receta (Python 3.11 y oTree según tu requirements.txt).

5. Qué pasa después

1. El laboratorio revisa y despliega el juego en https://<nombre>.beer-lab.org, lo agrega a teaching.beer-lab.org y a la página de docentes, y te avisa por correo. El acceso al panel se entrega aparte.
2. Si la construcción falla, recibes el error y una sugerencia de corrección; envías <nombre>-v2.zip.
3. Actualizaciones: nuevo zip con número de versión. Si cambiaste los modelos (campos), la base de datos se reinicia; descarga antes los datos que quieras conservar.
4. Retiro: pídelo por correo; el laboratorio guarda un respaldo y elimina el sitio.
5. Cuando el laboratorio publica un juego nuevo (el tuyo o el de otra persona), todas las direcciones de beer-lab.org dejan de responder unos 15 segundos (aparece la página «Error 1033» de Cloudflare; basta con recargar y el avance de los participantes se conserva). No se publican juegos durante clases programadas: avisa tus fechas.

Detalles técnicos y Dockerfile del servidor: guía técnica GUIDE_FOR_RESEARCHERS.md, publicada junto con la plantilla de oTree del laboratorio.

6. Licencia y reutilización

Salvo indicación contraria, los textos de este sitio y las guías docentes del BEER Lab se publican bajo licencia CC BY 4.0: puedes usarlos, copiarlos, traducirlos y adaptarlos para tus clases, en cualquier institución, siempre que cites la fuente. Sugerencia de crédito: «Título de la guía, autoría. BEER Lab, Tecnológico de Monterrey. CC BY 4.0».

Los juegos propuestos por otras personas conservan las condiciones que indiquen sus autores. Los documentos de trabajo pertenecen a sus autores. El código de los juegos y los logotipos del Tec y del BEER Lab no forman parte de la licencia.