Skip to content

CTF-405: Brackets

Statement

The system could support grouping participants into named brackets (for example beginner, intermediate, advanced) with separate scoreboards per bracket. Bracket assignment shall be configurable per participant by organizers. Participants shall see both their bracket scoreboard and the overall scoreboard.

Rationale

Brackets enable fair competition when participants have vastly different skill levels, a beginner competing against experts has no chance of placing, which is demotivating. For Shifter, brackets allow mixed-experience events where junior and senior consultants compete within their tier. (CTFd supports a similar brackets feature.)

Traceability

  • IMPLEMENTS → CODE_FILE shifter/shifter_platform/ctf/models/team.py (CTFBracket model)
  • IMPLEMENTS → CODE_FILE shifter/shifter_platform/ctf/services/bracket.py (Bracket CRUD and participant assignment service)
  • IMPLEMENTS → CODE_FILE shifter/shifter_platform/ctf/services/scoring/ (Bracket-filtered scoreboards (bracket_id param))
  • IMPLEMENTS → CODE_FILE shifter/shifter_platform/ctf/urls.py (Bracket admin and API URL routes)
  • IMPLEMENTS → CODE_FILE shifter/shifter_platform/ctf/forms/ (CTFBracketForm and bracket field on CTFParticipantForm)
  • IMPLEMENTS → CODE_FILE shifter/shifter_platform/ctf/admin/ (CTFBracketAdmin and bracket on CTFParticipantAdmin)
  • IMPLEMENTS → CODE_FILE shifter/shifter_platform/ctf/services/__init__.py (Bracket service exports)
  • IMPLEMENTS → CODE_FILE shifter/shifter_platform/ctf/migrations/0020_add_brackets.py (Migration for CTFBracket model and participant bracket FK)
  • TESTS → TEST shifter/shifter_platform/tests/ctf/test_brackets.py (Bracket model, service, scoring, and view tests)