CTF-014: Customization & Extensibility¶
Statement¶
The platform could support extensibility and customization for CTF functionality including: custom challenge types and scoring modes registered as Django apps, configurable event branding (logo, colors, description) in the platform user interface, and multi-language support through the platform's language support. The CTF layer shall not build a standalone plugin system, theming engine, or translation infrastructure.
Rationale¶
Extensibility enables the platform to serve diverse use cases without core code changes. Custom challenge types are Django apps registered with CTF. Event branding is per-event data that the React SPA applies (ADR-029). Django gettext covers server-rendered text (ADR-016); the SPA has no translation layer yet (#91).
Traceability¶
- IMPLEMENTS → CODE_FILE
shifter/shifter_platform/ctf/extensions.py(Extension points: register_flag_validator and register_scoring_strategy for external Django apps) - IMPLEMENTS → CODE_FILE
shifter/shifter_platform/ctf/models/event.py(CTFEvent logo_url and theme_color branding fields) - CONSTRAINS → CONFIG
shifter/shifter_platform/config/settings.py(Django settings - LocaleMiddleware, USE_I18N=True and LOCALE_PATHS; no SPA translation catalog) - DOCUMENTS → GITHUB_ISSUE
Brad-Edwards/bigrae#627(CTF-014: Customization & Extensibility) - IMPLEMENTS → CODE_FILE
shifter/shifter_platform/ctf/communication_contracts.py(Closed, versioned content/audience/trigger/channel profiles: the CommunicationIntent extensibility seam extended by application change, not a plugin/theme/translation engine (ADR-051, #2048)) - IMPLEMENTS → GITHUB_ISSUE
Brad-Edwards/bigrae#2048(Communication extensibility realized as a closed seam that honors the shall-not-build-a-plugin-system constraint) - TESTS → TEST
shifter/shifter_platform/tests/ctf/test_communication_contracts.py(Closed content profile: media and link rejection, template-like text stays data (#2053)) - TESTS → TEST
shifter/shifter_platform/frontend/src/features/ctf/MarkdownContent.test.tsx(Closed renderer profile parameter; template-like text renders literally (#2053)) - IMPLEMENTS → GITHUB_ISSUE
2053(Closed content-profile seam and fail-closed unknown profiles in the participant inbox, with no plugin, theme or translation engine)