Emblemas

omegaUp inclui um sistema abrangente de emblemas para reconhecer as conquistas, marcos e contribuições dos usuários para a plataforma.

Visão geral

Os emblemas são concedidos automaticamente com base em consultas SQL executadas periodicamente por meio de cronjobs. Cada emblema possui seu próprio diretório contendo a lógica de consulta, descrições localizadas e casos de teste.

Categorias de emblemas

Marcos de resolução de problemas

Sequência de emblemas

Selos de especialista em idiomas

Conclusão do curso

Comunidade e contribuição

Emblemas Especiais

Implementação do selo

Estrutura de diretório

Cada emblema é definido em frontend/badges/[badge-name]/:

frontend/badges/
├── 100solvedProblems/
│   ├── icon.svg          # Badge icon
│   ├── localizations.json # Translations
│   ├── query.sql         # Award criteria
│   └── test.json         # Test cases
├── cppExpert/
│   └── ...
└── default_icon.svg      # Fallback icon

Estrutura de consulta

As consultas de selo retornam IDs de usuários qualificados:

-- Example: 100solvedProblems/query.sql
SELECT DISTINCT
    i.user_id
FROM
    Identities i
INNER JOIN
    (
        SELECT
            s.identity_id,
            COUNT(DISTINCT s.problem_id) AS solved_count
        FROM
            Submissions s
        INNER JOIN
            Runs r ON s.current_run_id = r.run_id
        WHERE
            r.verdict = 'AC'
        GROUP BY
            s.identity_id
        HAVING
            solved_count >= 100
    ) AS solved ON i.identity_id = solved.identity_id
WHERE
    i.user_id IS NOT NULL;

Formato de localização

Suporte multilíngue em localizations.json:

{
  "es": {
    "name": "100 Problemas resueltos",
    "description": "Otorgado a personas que han resuelto 100 problemas o más."
  },
  "en": {
    "name": "100 Solved Problems",
    "description": "User has solved 100 or more problems."
  },
  "pt": {
    "name": "100 Problemas Resolvidos",
    "description": "Concedido a pessoas que resolveram 100 ou mais problemas."
  }
}

Casos de teste

Validação em test.json:

{
  "users": ["test_user_1", "test_user_2"],
  "expected": {
    "test_user_1": true,
    "test_user_2": false
  }
}

Processamento de crachás

Execução do Cronjob

Os emblemas são concedidos por meio do cronjob de atribuição de emblemas:

# Run badge assignment
python3 stuff/cron/assign_badges.py

Fluxo de processamento

sequenceDiagram
    participant Cron as Cronjob
    participant DB as Database
    participant Badge as Badge Query

    Cron->>Badge: Load query.sql
    Badge->>DB: Execute query
    DB-->>Badge: Qualifying users
    Badge->>DB: Check existing awards
    Badge->>DB: Insert new awards
    Badge->>Cron: Report new badges

Exibição de crachá

Perfil do usuário

Os emblemas aparecem nos perfis de usuário no /profile/{username}/:

• Ícone do emblema (SVG)
• Nome localizado
• Data da premiação
• Descrição do emblema ao passar o mouse

API de emblema

Recuperar emblemas programaticamente:

# Get all badges
GET /api/Badge/list/

# Get user's badges
GET /api/Badge/myList/

# Get specific user's badges
GET /api/Badge/userList/?target_user={username}

# Get badge details
GET /api/Badge/badgeDetails/?badge_alias={alias}

Criando novos emblemas

Etapa 1: Criar diretório

mkdir frontend/badges/newBadgeName

Etapa 2: Escrever consulta

Crie query.sql que retorne valores user_id qualificados:

SELECT DISTINCT
    i.user_id
FROM
    Identities i
WHERE
    -- Your criteria here
    i.user_id IS NOT NULL;

Etapa 3: adicionar localizações

Crie localizations.json:

{
  "es": {
    "name": "Nuevo Badge",
    "description": "Descripción del badge."
  },
  "en": {
    "name": "New Badge",
    "description": "Badge description."
  }
}

Etapa 4: Adicionar ícone (opcional)

Crie icon.svg ou use o ícone padrão.

Etapa 5: Adicionar testes

Crie test.json com os resultados esperados.

Etapa 6: teste localmente

# Run badge tests
python3 stuff/cron/assign_badges.py --dry-run --badge=newBadgeName

Documentação Relacionada

• API de emblemas - Pontos de extremidade da API para emblemas
• Padrões de banco de dados - Padrões de consulta
• Cronjobs - Processamento em segundo plano