# harini-vm/dog-food architecture

> Architecture diagram of the GitHub repository harini-vm/dog-food, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/harini-vm/dog-food
- Repository: https://github.com/harini-vm/dog-food

## Overview

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: [`src/dogfood/app.py`](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/app.py) (Application setup), [`src/dogfood/routes/integrations.py`](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/routes/integrations.py) (Integration routes), [`src/dogfood/routes/organize.py`](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/routes/organize.py) (Organizer routes), [`src/dogfood/routes/api.py`](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/routes/api.py) (REST API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application and access"]
  node_app["Application setup<br/>[app.py]"]
  node_auth["Authentication<br/>[auth.py]"]
  node_authz["Authorization<br/>[authz.py]"]
  node_web["Web rendering<br/>[web.py]"]
  node_api["REST API<br/>[api.py]"]
end

subgraph group_event["Events and submissions"]
  node_organize["Organizer routes<br/>[organize.py]"]
  node_people["People and teams<br/>[people.py]"]
  node_events["Event management<br/>[events.py]"]
  node_teams["Team management<br/>[teams.py]"]
  node_submissions["Project submissions<br/>[submissions.py]"]
end

subgraph group_judging["Judging and results"]
  node_judge["Judge routes<br/>[judge.py]"]
  node_assignment["Judge assignment<br/>[assign.py]"]
  node_scoring["Rubric scoring<br/>[scoring.py]"]
  node_pairwise["Pairwise judging<br/>[pairwise.py]"]
  node_results["Results and publishing<br/>[results.py]"]
end

subgraph group_community["Public participation"]
  node_public["Public gallery<br/>[public.py]"]
  node_vote["Voting routes<br/>[vote.py]"]
  node_voting["Voting service<br/>[voting.py]"]
  node_comments["Comments<br/>[comments.py]"]
end

subgraph group_integrations["Integrations and records"]
  node_integrations_route["Integration routes<br/>[integrations.py]"]
  node_importer["Event import export<br/>[importer.py]"]
  node_certificates["Certificates<br/>[certificates.py]"]
  node_webhooks["Webhook delivery<br/>[webhooks.py]"]
  node_audit["Audit log<br/>[audit.py]"]
end

node_users(("Users"))
node_database[("PostgreSQL<br/>[db.py]")]

node_users -->|"uses portal"| node_app
node_app -->|"configures"| node_auth
node_app -->|"registers"| node_api
node_app -->|"registers"| node_organize
node_app -->|"registers"| node_people
node_app -->|"registers"| node_judge
node_app -->|"registers"| node_public
node_app -->|"registers"| node_vote
node_app -->|"registers"| node_integrations_route
node_api -->|"uses"| node_auth
node_api -->|"uses"| node_authz
node_api -->|"calls"| node_scoring
node_api -->|"calls"| node_results
node_api -->|"calls"| node_pairwise
node_organize -->|"calls"| node_events
node_organize -->|"calls"| node_assignment
node_organize -->|"calls"| node_results
node_organize -->|"calls"| node_pairwise
node_organize -->|"calls"| node_voting
node_organize -->|"calls"| node_submissions
node_people -->|"calls"| node_events
node_people -->|"calls"| node_teams
node_judge -->|"calls"| node_pairwise
node_judge -->|"calls"| node_scoring
node_public -->|"calls"| node_comments
node_public -->|"calls"| node_results
node_public -->|"calls"| node_submissions
node_vote -->|"calls"| node_voting
node_vote -->|"calls"| node_comments
node_integrations_route -->|"calls"| node_importer
node_integrations_route -->|"calls"| node_certificates
node_integrations_route -->|"calls"| node_results
node_integrations_route -->|"calls"| node_webhooks
node_integrations_route -->|"uses"| node_auth
node_integrations_route -->|"renders"| node_web
node_results -->|"emits events"| node_webhooks
node_teams -->|"uses"| node_submissions
node_events -->|"reads and writes"| node_database
node_submissions -->|"reads and writes"| node_database
node_scoring -->|"reads and writes"| node_database
node_voting -->|"reads and writes"| node_database
node_webhooks -->|"queues deliveries"| node_database
node_audit -->|"records chain"| node_database
node_integrations_route -->|"uses"| node_audit

click node_app "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/app.py"
click node_auth "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/auth.py"
click node_authz "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/authz.py"
click node_web "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/web.py"
click node_api "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/routes/api.py"
click node_organize "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/routes/organize.py"
click node_people "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/routes/people.py"
click node_events "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/services/events.py"
click node_teams "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/services/teams.py"
click node_submissions "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/services/submissions.py"
click node_judge "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/routes/judge.py"
click node_assignment "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/services/assign.py"
click node_scoring "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/services/scoring.py"
click node_pairwise "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/services/pairwise.py"
click node_results "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/services/results.py"
click node_public "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/routes/public.py"
click node_vote "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/routes/vote.py"
click node_voting "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/services/voting.py"
click node_comments "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/services/comments.py"
click node_integrations_route "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/routes/integrations.py"
click node_importer "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/services/importer.py"
click node_certificates "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/services/certificates.py"
click node_webhooks "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/services/webhooks.py"
click node_audit "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/audit.py"
click node_database "https://github.com/harini-vm/dog-food/blob/main/src/dogfood/db.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_auth,node_authz,node_web,node_api,node_users toneBlue
class node_organize,node_people,node_events,node_teams,node_submissions,node_database toneAmber
class node_judge,node_assignment,node_scoring,node_pairwise,node_results toneMint
class node_public,node_vote,node_voting,node_comments toneRose
class node_integrations_route,node_importer,node_certificates,node_webhooks,node_audit toneIndigo
```

## Components

### Application and access

- [Application setup](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/app.py): `src/dogfood/app.py`
- [Authentication](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/auth.py): `src/dogfood/auth.py`
- [Authorization](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/authz.py): `src/dogfood/authz.py`
- [Web rendering](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/web.py): `src/dogfood/web.py`
- [REST API](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/routes/api.py): `src/dogfood/routes/api.py`

### Events and submissions

- [Organizer routes](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/routes/organize.py): `src/dogfood/routes/organize.py`
- [People and teams](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/routes/people.py): `src/dogfood/routes/people.py`
- [Event management](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/services/events.py): `src/dogfood/services/events.py`
- [Team management](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/services/teams.py): `src/dogfood/services/teams.py`
- [Project submissions](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/services/submissions.py): `src/dogfood/services/submissions.py`

### Judging and results

- [Judge routes](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/routes/judge.py): `src/dogfood/routes/judge.py`
- [Judge assignment](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/services/assign.py): `src/dogfood/services/assign.py`
- [Rubric scoring](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/services/scoring.py): `src/dogfood/services/scoring.py`
- [Pairwise judging](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/services/pairwise.py): `src/dogfood/services/pairwise.py`
- [Results and publishing](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/services/results.py): `src/dogfood/services/results.py`

### Public participation

- [Public gallery](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/routes/public.py): `src/dogfood/routes/public.py`
- [Voting routes](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/routes/vote.py): `src/dogfood/routes/vote.py`
- [Voting service](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/services/voting.py): `src/dogfood/services/voting.py`
- [Comments](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/services/comments.py): `src/dogfood/services/comments.py`

### Integrations and records

- [Integration routes](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/routes/integrations.py): `src/dogfood/routes/integrations.py`
- [Event import export](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/services/importer.py): `src/dogfood/services/importer.py`
- [Certificates](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/services/certificates.py): `src/dogfood/services/certificates.py`
- [Webhook delivery](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/services/webhooks.py): `src/dogfood/services/webhooks.py`
- [Audit log](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/audit.py): `src/dogfood/audit.py`

### Other components

- **Users**
- [PostgreSQL](https://github.com/harini-vm/dog-food/blob/main/src/dogfood/db.py): `src/dogfood/db.py`

## Connections

- Users → Application setup: uses portal (evidence: `README.md`)
- Application setup → Authentication: configures (evidence: `src/dogfood/app.py`)
- Application setup → REST API: registers (evidence: `src/dogfood/app.py`)
- Application setup → Organizer routes: registers (evidence: `src/dogfood/app.py`)
- Application setup → People and teams: registers (evidence: `src/dogfood/app.py`)
- Application setup → Judge routes: registers (evidence: `src/dogfood/app.py`)
- Application setup → Public gallery: registers (evidence: `src/dogfood/app.py`)
- Application setup → Voting routes: registers (evidence: `src/dogfood/app.py`)
- Application setup → Integration routes: registers (evidence: `src/dogfood/app.py`)
- REST API → Authentication: uses (evidence: `src/dogfood/routes/api.py`)
- REST API → Authorization: uses (evidence: `src/dogfood/routes/api.py`)
- REST API → Rubric scoring: calls (evidence: `src/dogfood/routes/api.py`)
- REST API → Results and publishing: calls (evidence: `src/dogfood/routes/api.py`)
- REST API → Pairwise judging: calls (evidence: `src/dogfood/routes/api.py`)
- Organizer routes → Event management: calls (evidence: `src/dogfood/routes/organize.py`)
- Organizer routes → Judge assignment: calls (evidence: `src/dogfood/routes/organize.py`)
- Organizer routes → Results and publishing: calls (evidence: `src/dogfood/routes/organize.py`)
- Organizer routes → Pairwise judging: calls (evidence: `src/dogfood/routes/organize.py`)
- Organizer routes → Voting service: calls (evidence: `src/dogfood/routes/organize.py`)
- Organizer routes → Project submissions: calls (evidence: `src/dogfood/routes/organize.py`)
- People and teams → Event management: calls (evidence: `src/dogfood/routes/people.py`)
- People and teams → Team management: calls (evidence: `src/dogfood/routes/people.py`)
- Judge routes → Pairwise judging: calls (evidence: `src/dogfood/routes/judge.py`)
- Judge routes → Rubric scoring: calls (evidence: `src/dogfood/routes/judge.py`)
- Public gallery → Comments: calls (evidence: `src/dogfood/routes/public.py`)
- Public gallery → Results and publishing: calls (evidence: `src/dogfood/routes/public.py`)
- Public gallery → Project submissions: calls (evidence: `src/dogfood/routes/public.py`)
- Voting routes → Voting service: calls (evidence: `src/dogfood/routes/vote.py`)
- Voting routes → Comments: calls (evidence: `src/dogfood/routes/vote.py`)
- Integration routes → Event import export: calls (evidence: `src/dogfood/routes/integrations.py`)
- Integration routes → Certificates: calls (evidence: `src/dogfood/routes/integrations.py`)
- Integration routes → Results and publishing: calls (evidence: `src/dogfood/routes/integrations.py`)
- Integration routes → Webhook delivery: calls (evidence: `src/dogfood/routes/integrations.py`)
- Integration routes → Authentication: uses (evidence: `src/dogfood/routes/integrations.py`)
- Integration routes → Web rendering: renders (evidence: `src/dogfood/routes/integrations.py`)
- Results and publishing → Webhook delivery: emits events (evidence: `src/dogfood/services/results.py`)
- Team management → Project submissions: uses (evidence: `src/dogfood/services/teams.py`)
- Event management → PostgreSQL: reads and writes (evidence: `src/dogfood/services/events.py`)
- Project submissions → PostgreSQL: reads and writes (evidence: `src/dogfood/services/submissions.py`)
- Rubric scoring → PostgreSQL: reads and writes (evidence: `src/dogfood/services/scoring.py`)
- Voting service → PostgreSQL: reads and writes (evidence: `src/dogfood/services/voting.py`)
- Webhook delivery → PostgreSQL: queues deliveries (evidence: `src/dogfood/services/webhooks.py`)
- Audit log → PostgreSQL: records chain (evidence: `src/dogfood/audit.py`)
- Integration routes → Audit log: uses (evidence: `src/dogfood/routes/integrations.py`)
