Skip to content

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)