CTF-003: Hint System¶
Statement¶
The system should allow organizers to attach progressive, ordered hints to challenges that participants can unlock to receive guidance, with configurable point penalties that create a meaningful trade-off between assistance and score.
Rationale¶
Hints prevent participants from getting completely stuck while maintaining competitive balance through point penalties. Without them, less experienced participants disengage from difficult challenges, reducing training value. A hint system is a key engagement mechanism for keeping all skill levels active. (CTFd provides a similar hint capability.)
Traceability¶
- IMPLEMENTS → CODE_FILE
shifter/shifter_platform/ctf/models/(CTFHint and CTFHintUsage models, calculate_points_with_penalty(total_hint_penalty)) - IMPLEMENTS → CODE_FILE
shifter/shifter_platform/ctf/services/hint.py(Progressive hint service: add/remove/use_hint, sequential ordering, cumulative penalty) - TESTS → TEST
shifter/shifter_platform/tests/ctf/test_services/test_hint.py(Progressive hint tests: CRUD, sequential order, penalty cap, idempotent unlock, event state) - IMPLEMENTS → GITHUB_ISSUE
Brad-Edwards/bigrae#566(CTF-003: Hint System)