# hemanth2607-cyber/dogfoodhack architecture

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

- Interactive diagram: https://gitdiagram.com/hemanth2607-cyber/dogfoodhack
- Repository: https://github.com/hemanth2607-cyber/dogfoodhack

## Overview

DOGFOOD is an offline-first hackathon submission and judging portal. Users enter through its HTTP application: the public can browse projects and vote, participants submit work, judges score assigned projects, and organizers manage the rubric and results. Scores feed severity profiling and normalized rankings; the platform also documents an offline scoring assistant and a verifiable audit trail. The excerpts establish database access, authentication, template rendering, and normalization calls. Other documented capabilities are included, but their internal wiring is not inferred where source excerpts do not show it.

Main entry points: [`src/main.py`](https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/main.py) (HTTP application), [`src/db.py`](https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/db.py) (SQLite database), [`src/normalization.py`](https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/normalization.py) (Score normalization), [`src/auth.py`](https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/auth.py) (Session and roles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Portal experience"]
  node_gallery["Project gallery<br/>[main.py]"]
  node_submissions["Project submissions<br/>[main.py]"]
  node_project_details["Project dossiers<br/>[main.py]"]
  node_community_vote["Community ballot<br/>[main.py]"]
  node_templates["HTML views"]
end

subgraph group_evaluation["Judging and results"]
  node_judge_scores["Judge scoring<br/>[main.py]"]
  node_ai_copilot["Offline rubric copilot<br/>[main.py]"]
  node_normalization["Score normalization<br/>[normalization.py]"]
  node_organizer_ops["Organizer operations<br/>[main.py]"]
  node_audit["Audit verification<br/>[main.py]"]
end

subgraph group_platform["Platform services"]
  node_application["HTTP application<br/>[main.py]"]
  node_authentication["Session and roles<br/>[auth.py]"]
end

subgraph group_persistence["Persistence"]
  node_sqlite[("SQLite database<br/>[db.py]")]
end

node_public(("Public guest"))
node_participant(("Participant"))
node_judge(("Judge"))
node_organizer(("Organizer"))

node_public -->|"browses"| node_application
node_participant -->|"submits"| node_application
node_judge -->|"scores projects"| node_application
node_organizer -->|"manages event"| node_application
node_application -->|"checks identity"| node_authentication
node_authentication -->|"looks up users"| node_sqlite
node_application -->|"queries data"| node_sqlite
node_application -->|"renders views"| node_templates
node_application -->|"serves gallery"| node_gallery
node_application -->|"handles submissions"| node_submissions
node_application -->|"serves dossiers"| node_project_details
node_application -->|"records votes"| node_community_vote
node_application -->|"handles ballots"| node_judge_scores
node_application -->|"offers suggestions"| node_ai_copilot
node_application -->|"calculates rankings"| node_normalization
node_normalization -->|"reads scores"| node_sqlite
node_application -->|"serves organizer tools"| node_organizer_ops
node_application -->|"verifies chain"| node_audit

click node_application "https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/main.py"
click node_gallery "https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/main.py"
click node_submissions "https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/main.py"
click node_project_details "https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/main.py"
click node_community_vote "https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/main.py"
click node_judge_scores "https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/main.py"
click node_ai_copilot "https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/main.py"
click node_normalization "https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/normalization.py"
click node_organizer_ops "https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/main.py"
click node_audit "https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/main.py"
click node_authentication "https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/auth.py"
click node_templates "https://github.com/hemanth2607-cyber/dogfoodhack/tree/main/templates"
click node_sqlite "https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/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_gallery,node_submissions,node_project_details,node_community_vote,node_templates toneBlue
class node_judge_scores,node_ai_copilot,node_normalization,node_organizer_ops,node_audit toneAmber
class node_application,node_authentication toneMint
class node_sqlite toneRose
class node_public,node_participant,node_judge,node_organizer toneIndigo
```

## Components

### Portal experience

- [Project gallery](https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/main.py): `src/main.py`
- [Project submissions](https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/main.py): `src/main.py`
- [Project dossiers](https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/main.py): `src/main.py`
- [Community ballot](https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/main.py): `src/main.py`
- [HTML views](https://github.com/hemanth2607-cyber/dogfoodhack/tree/main/templates): `templates`

### Judging and results

- [Judge scoring](https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/main.py): `src/main.py`
- [Offline rubric copilot](https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/main.py): `src/main.py`
- [Score normalization](https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/normalization.py): `src/normalization.py`
- [Organizer operations](https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/main.py): `src/main.py`
- [Audit verification](https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/main.py): `src/main.py`

### Platform services

- [HTTP application](https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/main.py): `src/main.py`
- [Session and roles](https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/auth.py): `src/auth.py`

### Persistence

- [SQLite database](https://github.com/hemanth2607-cyber/dogfoodhack/blob/main/src/db.py): `src/db.py`

### Other components

- **Public guest**
- **Participant**
- **Judge**
- **Organizer**

## Connections

- Public guest → HTTP application: browses (evidence: `README.md`)
- Participant → HTTP application: submits (evidence: `README.md`)
- Judge → HTTP application: scores projects (evidence: `README.md`)
- Organizer → HTTP application: manages event (evidence: `README.md`)
- HTTP application → Session and roles: checks identity (evidence: `src/main.py`)
- Session and roles → SQLite database: looks up users (evidence: `src/auth.py`)
- HTTP application → SQLite database: queries data (evidence: `src/main.py`)
- HTTP application → HTML views: renders views (evidence: `src/main.py`)
- HTTP application → Project gallery: serves gallery (evidence: `README.md`)
- HTTP application → Project submissions: handles submissions (evidence: `README.md`)
- HTTP application → Project dossiers: serves dossiers (evidence: `README.md`)
- HTTP application → Community ballot: records votes (evidence: `README.md`)
- HTTP application → Judge scoring: handles ballots (evidence: `src/main.py`)
- HTTP application → Offline rubric copilot: offers suggestions (evidence: `README.md`)
- HTTP application → Score normalization: calculates rankings (evidence: `src/main.py`)
- Score normalization → SQLite database: reads scores (evidence: `src/normalization.py`)
- HTTP application → Organizer operations: serves organizer tools (evidence: `src/main.py`)
- HTTP application → Audit verification: verifies chain (evidence: `README.md`)
