How bondandmass/hackathon-platform works
Hackathon Platform provides team formation, project submission, and judging/leaderboard workflows through three FastAPI services. Participants authenticate with Cognito, form teams, then submit a project file; judges score submissions, and users can view rankings. Each service owns its PostgreSQL tables, while submissions also use S3. The graph follows the documented service calls and the sampled route implementations; unsampled service internals are represented only at supported directory paths.
Main entry points: app/routes.py Submission routes · app/routes.py Judging routes · app/routes.py Team routes · db.py Team database
Components 21
Team service
- Team routes
team-service/app/routes.py - Team runtime
team-service/app/core - Team auth
team-service/app/core/auth.py - Team records
team-service/app/models.py - Team database
team-service/app/core/db.py
Submission service
- Submission routes
submission-service/app/routes.py - Submission runtime
submission-service/app/core - Submission auth
submission-service/app/core/auth.py - Submission records
submission-service/app/models.py - Submission database
submission-service/app/core/db.py - S3 file storage
submission-service/app/storage.py
Judging service
- Judging routes
judging-service/app/routes.py - Judging runtime
judging-service/app/core - Judging auth
judging-service/app/core/auth.py - Score records
judging-service/app/models.py - Judging database
judging-service/app/core/db.py - Scoring and ranking
judging-service/app/scoring.py
Platform services
- Amazon Cognito
- RDS PostgreSQL
- Amazon S3
Other components
- Platform user
Connections 29
- Platform user → Team routes: manages teams
README.md - Platform user → Submission routes: uploads projects
README.md - Platform user → Judging routes: scores projects
README.md - Team routes → Team auth: checks access
team-service/app/routes.py - Team routes → Team records: reads and writes
team-service/app/routes.py - Team routes → Team database: uses sessions
team-service/app/routes.py - Team auth → Amazon Cognito: validates tokens
team-service/app/core/auth.py - Team records → Team database: maps records
team-service/app/models.py - Submission routes → Submission auth: checks access
submission-service/app/routes.py - Submission routes → Team routes: looks up team
submission-service/app/routes.py - Submission routes → Submission records: reads and writes
submission-service/app/routes.py - Submission routes → Submission database: uses sessions
submission-service/app/routes.py - Submission routes → S3 file storage: stores files
submission-service/app/routes.py - Submission auth → Amazon Cognito: validates tokens
submission-service/app/core/auth.py - Submission records → Submission database: maps records
submission-service/app/models.py - S3 file storage → Amazon S3: uploads and links
submission-service/app/storage.py - Judging routes → Judging auth: checks access
judging-service/app/routes.py - Judging routes → Submission routes: checks submission
judging-service/app/routes.py - Judging routes → Score records: reads and writes
judging-service/app/routes.py - Judging routes → Judging database: uses sessions
judging-service/app/routes.py - Judging routes → Scoring and ranking: calculates rankings
judging-service/app/routes.py - Judging auth → Amazon Cognito: validates tokens
judging-service/app/core/auth.py - Score records → Judging database: maps records
judging-service/app/models.py - Team runtime → Team database: initializes tables
team-service/app/core/factory.py - Submission runtime → Submission database: initializes tables
submission-service/app/core/factory.py - Judging runtime → Judging database: initializes tables
judging-service/app/core/factory.py - Team database → RDS PostgreSQL: connects to
team-service/app/core/db.py - Submission database → RDS PostgreSQL: connects to
submission-service/app/core/db.py - Judging database → RDS PostgreSQL: connects to
judging-service/app/core/db.py