Skip to content

README.pt_BR.md

Latest commit

 

History

History
90 lines (69 loc) · 2.73 KB

README.pt_BR.md

File metadata and controls

90 lines (69 loc) · 2.73 KB

🌐 Português (BR) | Español

🎯 Soc Ops — Social Bingo

Quebre o gelo, faça conexões, vença no networking!

Soc Ops é um jogo interativo de bingo social projetado para encontros presenciais, eventos de equipe e conferências. Encontre pessoas que correspondam às perguntas, marque sua cartela e corra para conseguir 5 em linha!

✨ Funcionalidades

  • 🎲 Cartelas aleatórias — Cada jogador recebe uma disposição única
  • 💾 Progresso salvo automaticamente — Continue de onde parou
  • 🏆 Detecção de bingo — Vitória automática em linhas, colunas e diagonais
  • 🎉 Modal de celebração — Tela de vitória digna de confetes
  • 📱 Mobile-first — Funciona muito bem em celulares durante eventos

🚀 Início Rápido

Pré-requisitos

Executar Localmente

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

Testar

uv run pytest

Lint

uv run ruff check .

🎨 Personalize seu Jogo

Alterar Perguntas

Edite app/data.py para adicionar seus próprios prompts de apresentação:

questions_list: list[str] = [
    "tem um animal de estimação",
    "fala mais de 2 idiomas",
    "sua pergunta personalizada aqui",
    # ... 24+ perguntas para uma cartela completa
]

Guia do Workshop

👉 Siga o Guia do Lab para uma experiência prática com os agentes do GitHub Copilot.

🛠️ Tecnologias

  • Framework: FastAPI + Jinja2 + HTMX
  • Estilização: Utilitários CSS personalizados (inspirado no Tailwind)
  • Estado: Sessões server-side com persistência em cookies
  • Deploy: GitHub Pages via Actions

📁 Estrutura do Projeto

app/
├── templates/       # Templates Jinja2
│   ├── base.html
│   ├── home.html
│   └── components/  # bingo_board, bingo_modal, game_screen, start_screen
├── static/          # Arquivos CSS & JS
├── models.py        # Estado do jogo & modelos de dados
├── game_logic.py    # Detecção de bingo & geração de cartelas
├── game_service.py  # Gerenciamento de sessão
├── data.py          # Banco de perguntas
└── main.py          # Rotas FastAPI
tests/
├── test_api.py      # Testes dos endpoints da API
└── test_game_logic.py  # Testes unitários da lógica do jogo

🚢 Deploy

Deploy automático no GitHub Pages a cada push para main:

  • Seu jogo: https://{usuario}.github.io/{nome-do-repo}

📝 Licença

MIT — use para o seu próximo evento!
⚡