[CU-86e1jnzkv]: ranking reports — include projectCode, admin/public endpoints, Spanish Excel export

[isaAJ05]

• Implemented in the gateway the recommended approach (separate admin and public endpoints).
• Endpoints support JSON and downloadable XLSX and apply ranking ordering, tie-break rules, and visibility constraints.

What’s included (ready)

• Admin endpoint
  • GET /events/:eventId/rankings
  • Requires permission: manage:events
  • Returns full ranking (all positions and grades)
• Public endpoint
  • GET /events/:eventId/rankings/public
  • No authentication required
  • Returns 403 when visible_public is false
  • Applies positions limit from ranking configuration
  • Hides grades/average when grade_visible is false

Query parameters supported

• format: json or excel (downloadable .xlsx)
• categoryId (optional)
• category_id (optional alias)

Ordering & tie-breaks

• Primary: averageGrade (descending)
• Tie-break: tiebreakOrder from TieBreaks table (lower wins)
• Fallback: stable lexical by projectName then projectId

Excel export behavior

• Downloadable .xlsx when format=excel
• Column order (Spanish): Posición, Código, Proyecto, Categoría, Participantes, Calificaciones, Puntaje Final
• For public exports with grade_visible=false, grade columns and average are returned empty
• The export uses a stable header+autofilter layout, header frozen, styled header row (blue), centered Código/Posición columns — avoids previous Excel repair issues

Files of interest

• events.service.ts
• events.controller.ts

Notes

• Non-breaking API additions: projectCode added to ranking result.
• Route rename: PATCH ranking-config/:id → update-ranking-config/:id (update consumers/docs).

[J-Povea21]

Task linked: CU-86e1jnzkv Event Service - Ranking report endpoint with Excel/JSON export

[MrManini]

Nice work!