How anhelinabodak/kubebit works
Kubebit is a Flask-backed CTF management platform. Players submit flags and receive solve/point results; administrators manage users, teams, challenges, categories, and competition scoring, while container challenges can be started or stopped in team namespaces. The graph includes those documented product stages and the persistence, scoring, and Kubernetes-orchestration layers. Some API routes and frontend wiring are unsampled, so links without direct excerpt evidence are omitted; namespace operations and static challenges are included as documented capabilities.
Main entry points: app.py Flask API · db.py SQLAlchemy database · competition.py Competition settings · submission.py Flag submissions
Components 17
Platform API
- Flask API
src/app.py - Admin interface
src/static/admin/app.js - Player interface
src/static/users/app.js
CTF Domain
- User accounts
src/core/user.py - Team management
src/core/team.py - Challenge catalog
src/core/challenge.py - Flag submissions
src/core/submission.py - Competition settings
src/core/competition.py - Scoring rules
src/core/scoring.py
Challenge Runtime
- Container config lookup
src/core/runtime.py - Challenge deployment
src/start_stop_challenge.py - Team namespaces
src/namespaces_logic.py
Persistence
- Domain models
src/models.py - SQLAlchemy database
src/db.py
Other components
- Player or admin
- Kubernetes cluster
- PostgreSQL
Connections 23
- Player or admin → Flask API: uses
README.md - Admin interface → Flask API: calls API
- Player interface → Flask API: calls API
- Flask API → User accounts: authenticates users
src/app.py - Flask API → Team management: manages teams
src/app.py - Flask API → Challenge catalog: manages challenges
src/app.py - Flask API → Flag submissions: submits flags
src/app.py - Flask API → Competition settings: manages competition
src/app.py - Flag submissions → Competition settings: calculates awarded points
src/core/submission.py - Competition settings → Scoring rules: uses scoring rule
src/core/competition.py - User accounts → SQLAlchemy database: reads and writes
src/core/user.py - Team management → SQLAlchemy database: reads and writes
src/core/team.py - Challenge catalog → SQLAlchemy database: reads and writes
src/core/challenge.py - Flag submissions → SQLAlchemy database: reads and writes
src/core/submission.py - Competition settings → SQLAlchemy database: reads and writes
src/core/competition.py - Domain models → SQLAlchemy database: uses ORM
src/models.py - SQLAlchemy database → PostgreSQL: persists data
README.md - Flask API → Challenge deployment: starts and stops
src/app.py - Challenge deployment → Container config lookup: gets container config
src/start_stop_challenge.py - Container config lookup → Domain models: reads challenge
src/core/runtime.py - Challenge deployment → Kubernetes cluster: creates and deletes pods/services
src/start_stop_challenge.py - Flask API → Team namespaces: manages namespaces
- Team namespaces → Kubernetes cluster: creates namespaces
src/namespaces_logic.py