Insignias

omegaUp incluye un sistema integral de insignias para reconocer los logros, hitos y contribuciones de los usuarios a la plataforma.

Descripción general

Las insignias se otorgan automáticamente en función de consultas SQL que se ejecutan periódicamente mediante cronjobs. Cada insignia tiene su propio directorio que contiene la lógica de consulta, descripciones localizadas y casos de prueba.

Categorías de insignias

Hitos en la resolución de problemas

Insignias de racha

Insignias de experto en idiomas

Finalización del curso

Comunidad y contribución

Insignias especiales

Implementación de insignias

Estructura del directorio

Cada insignia está definida en 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

Estructura de consulta

Las consultas de insignias devuelven ID de usuarios que califican:

-- 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 localización

Soporte multilingüe en 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 prueba

Validación en test.json:

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

Procesamiento de insignias

Ejecución de cronjob

Las insignias se otorgan mediante el cronjob de asignación de insignias:

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

Flujo de procesamiento

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

Visualización de insignias

Perfil de usuario

Las insignias aparecen en los perfiles de usuario en /profile/{username}/:

• Icono de insignia (SVG)
• Nombre localizado
• Fecha de adjudicación
• Descripción de la insignia al pasar el mouse

API de insignia

Recuperar insignias mediante programación:

# 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}

Creando nuevas insignias

Paso 1: Crear directorio

mkdir frontend/badges/newBadgeName

Paso 2: escribir consulta

Cree query.sql que devuelva valores user_id calificados:

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

Paso 3: Agregar localizaciones

Crear localizations.json:

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

Paso 4: Agregar ícono (opcional)

Cree icon.svg o utilice el icono predeterminado.

Paso 5: Agregar pruebas

Cree test.json con los resultados esperados.

Paso 6: Pruebe localmente

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

Documentación relacionada

• API de insignias - Puntos finales de API para insignias
• Patrones de base de datos - Patrones de consulta
• Cronjobs - Procesamiento en segundo plano