How harini-vm/dog-food works
Dog-Food is a self-hostable hackathon portal. Organizers configure events, teams submit projects, judges review assigned entries, and the platform computes and publishes signed results; participants and the public can also vote and comment. FastAPI routes coordinate these domain services, with PostgreSQL transactions supporting shared state. Separate capabilities cover REST access, event import/export, certificates, webhooks, pairwise judging, and audit verification. Edges follow explicit source-index references or README statements; unsampled wiring is omitted rather than inferred.
Main entry points: app.py Application setup · integrations.py Integration routes · organize.py Organizer routes · api.py REST API
Components 26
Application and access
- Application setup
src/dogfood/app.py - Authentication
src/dogfood/auth.py - Authorization
src/dogfood/authz.py - Web rendering
src/dogfood/web.py - REST API
src/dogfood/routes/api.py
Events and submissions
- Organizer routes
src/dogfood/routes/organize.py - People and teams
src/dogfood/routes/people.py - Event management
src/dogfood/services/events.py - Team management
src/dogfood/services/teams.py - Project submissions
src/dogfood/services/submissions.py
Judging and results
- Judge routes
src/dogfood/routes/judge.py - Judge assignment
src/dogfood/services/assign.py - Rubric scoring
src/dogfood/services/scoring.py - Pairwise judging
src/dogfood/services/pairwise.py - Results and publishing
src/dogfood/services/results.py
Public participation
- Public gallery
src/dogfood/routes/public.py - Voting routes
src/dogfood/routes/vote.py - Voting service
src/dogfood/services/voting.py - Comments
src/dogfood/services/comments.py
Integrations and records
- Integration routes
src/dogfood/routes/integrations.py - Event import export
src/dogfood/services/importer.py - Certificates
src/dogfood/services/certificates.py - Webhook delivery
src/dogfood/services/webhooks.py - Audit log
src/dogfood/audit.py
Other components
- Users
- PostgreSQL
src/dogfood/db.py
Connections 44
- Users → Application setup: uses portal
README.md - Application setup → Authentication: configures
src/dogfood/app.py - Application setup → REST API: registers
src/dogfood/app.py - Application setup → Organizer routes: registers
src/dogfood/app.py - Application setup → People and teams: registers
src/dogfood/app.py - Application setup → Judge routes: registers
src/dogfood/app.py - Application setup → Public gallery: registers
src/dogfood/app.py - Application setup → Voting routes: registers
src/dogfood/app.py - Application setup → Integration routes: registers
src/dogfood/app.py - REST API → Authentication: uses
src/dogfood/routes/api.py - REST API → Authorization: uses
src/dogfood/routes/api.py - REST API → Rubric scoring: calls
src/dogfood/routes/api.py - REST API → Results and publishing: calls
src/dogfood/routes/api.py - REST API → Pairwise judging: calls
src/dogfood/routes/api.py - Organizer routes → Event management: calls
src/dogfood/routes/organize.py - Organizer routes → Judge assignment: calls
src/dogfood/routes/organize.py - Organizer routes → Results and publishing: calls
src/dogfood/routes/organize.py - Organizer routes → Pairwise judging: calls
src/dogfood/routes/organize.py - Organizer routes → Voting service: calls
src/dogfood/routes/organize.py - Organizer routes → Project submissions: calls
src/dogfood/routes/organize.py - People and teams → Event management: calls
src/dogfood/routes/people.py - People and teams → Team management: calls
src/dogfood/routes/people.py - Judge routes → Pairwise judging: calls
src/dogfood/routes/judge.py - Judge routes → Rubric scoring: calls
src/dogfood/routes/judge.py - Public gallery → Comments: calls
src/dogfood/routes/public.py - Public gallery → Results and publishing: calls
src/dogfood/routes/public.py - Public gallery → Project submissions: calls
src/dogfood/routes/public.py - Voting routes → Voting service: calls
src/dogfood/routes/vote.py - Voting routes → Comments: calls
src/dogfood/routes/vote.py - Integration routes → Event import export: calls
src/dogfood/routes/integrations.py - Integration routes → Certificates: calls
src/dogfood/routes/integrations.py - Integration routes → Results and publishing: calls
src/dogfood/routes/integrations.py - Integration routes → Webhook delivery: calls
src/dogfood/routes/integrations.py - Integration routes → Authentication: uses
src/dogfood/routes/integrations.py - Integration routes → Web rendering: renders
src/dogfood/routes/integrations.py - Results and publishing → Webhook delivery: emits events
src/dogfood/services/results.py - Team management → Project submissions: uses
src/dogfood/services/teams.py - Event management → PostgreSQL: reads and writes
src/dogfood/services/events.py - Project submissions → PostgreSQL: reads and writes
src/dogfood/services/submissions.py - Rubric scoring → PostgreSQL: reads and writes
src/dogfood/services/scoring.py - Voting service → PostgreSQL: reads and writes
src/dogfood/services/voting.py - Webhook delivery → PostgreSQL: queues deliveries
src/dogfood/services/webhooks.py - Audit log → PostgreSQL: records chain
src/dogfood/audit.py - Integration routes → Audit log: uses
src/dogfood/routes/integrations.py