CTF-301: Hint Creation¶
Statement¶
The system should support creating one or more hints per challenge. Each hint shall have: content text (supporting Markdown), a display order for progressive revelation, and an optional point cost. Hints shall be ordered so participants see less-specific hints before more-specific ones.
Rationale¶
Hints are the primary scaffolding mechanism for participants who are stuck. Progressive hints (general first, specific later) let participants choose how much help they need, maintaining the challenge while preventing complete frustration. (CTFd models hints as ordered, per-challenge entities with costs.)
Traceability¶
- IMPLEMENTS → CODE_FILE
shifter/shifter_platform/ctf/models/(CTFHint model - text, penalty, order fields with FK to challenge) - IMPLEMENTS → CODE_FILE
shifter/shifter_platform/ctf/services/hint.py(Hint service - add_hint, update_hint, remove_hint, get_hints CRUD) - TESTS → TEST
shifter/shifter_platform/tests/ctf/test_services/test_hint.py(TestHintCRUD - add, remove, ordering tests for hint creation)