# etlonline/promptcompetition2025 architecture

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

- Interactive diagram: https://gitdiagram.com/etlonline/promptcompetition2025
- Repository: https://github.com/etlonline/promptcompetition2025

## Overview

This is a web platform for running prompt-engineering competitions: participants register, enter challenges across Level 1 and qualifying Level 2, submit work, and follow evaluation and leaderboard results. Judges score submissions; administrators manage competitions, assignments, distribution, and results. The map combines sampled frontend/API wiring with README capabilities and indexed server route registration. Many route implementations and challenge pages were not sampled, so their internal calls are not asserted.

Main entry points: [`lib/api.ts`](https://github.com/etlonline/promptcompetition2025/blob/main/lib/api.ts) (Authenticated API client), [`server/index.ts`](https://github.com/etlonline/promptcompetition2025/blob/main/server/index.ts) (HTTP route dispatcher), [`app/participant/page.tsx`](https://github.com/etlonline/promptcompetition2025/blob/main/app/participant/page.tsx) (Participant portal), [`server/routes/submissions.ts`](https://github.com/etlonline/promptcompetition2025/blob/main/server/routes/submissions.ts) (Submission routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_auth["Authentication<br/>[auth-provider.tsx]"]
  node_landing["Competition discovery<br/>[page.tsx]"]
end

subgraph group_competition["Competition workflow"]
  node_participant_portal["Participant portal<br/>[page.tsx]"]
  node_challenge_entry["Challenge participation<br/>[page.tsx]"]
  node_daily_challenges["Daily challenges<br/>[page.tsx]"]
  node_level2["Level 2 competition<br/>[page.tsx]"]
  node_results["Participant results<br/>[page.tsx]"]
  node_judge_portal["Judge portal<br/>[page.tsx]"]
  node_judge_scoring["Judge scoring<br/>[page.tsx]"]
  node_leaderboard_ui["Public leaderboard<br/>[page.tsx]"]
end

subgraph group_operations["Administration"]
  node_admin["Competition administration<br/>[page.tsx]"]
  node_admin_judging["Judge and evaluation oversight<br/>[page.tsx]"]
  node_llm_eval_ui["LLM evaluation review<br/>[page.tsx]"]
  node_role_admin["User role management"]
end

subgraph group_backend["API services"]
  node_frontend_api["Authenticated API client<br/>[api.ts]"]
  node_server["HTTP route dispatcher<br/>[index.ts]"]
  node_competition_routes["Competition routes<br/>[competitions.ts]"]
  node_submission_routes["Submission routes<br/>[submissions.ts]"]
  node_judge_routes["Judge routes"]
  node_leaderboard_routes["Leaderboard routes<br/>[leaderboard.ts]"]
  node_llm_routes["LLM evaluation routes<br/>[llmevaluations.ts]"]
end

subgraph group_data["Identity and data"]
  node_firebase_client["Firebase client services<br/>[firebase.ts]"]
  node_firestore[("Firestore")]
  node_firebase_admin["Firebase Admin services<br/>[firebase-admin.ts]"]
end

node_visitor(("Visitor / participant"))

node_visitor -->|"browses"| node_landing
node_visitor -->|"signs in"| node_auth
node_landing -->|"loads competitions"| node_frontend_api
node_participant_portal -->|"loads competitions"| node_frontend_api
node_participant_portal -->|"reads participant data"| node_firebase_client
node_participant_portal -.->|"opens challenge"| node_challenge_entry
node_participant_portal -.->|"opens daily challenge"| node_daily_challenges
node_participant_portal -.->|"continues qualifying"| node_level2
node_challenge_entry -.->|"submits work"| node_submission_routes
node_daily_challenges -.->|"submits work"| node_submission_routes
node_level2 -.->|"submits work"| node_submission_routes
node_judge_portal -->|"loads assignments"| node_frontend_api
node_judge_scoring -.->|"records scores"| node_judge_routes
node_admin -.->|"manages competition"| node_frontend_api
node_admin_judging -.->|"reviews evaluations"| node_frontend_api
node_llm_eval_ui -.->|"loads evaluations"| node_frontend_api
node_llm_eval_ui -.->|"requests submissions"| node_llm_routes
node_role_admin -->|"manages roles"| node_frontend_api
node_frontend_api -.->|"sends API requests"| node_server
node_server -->|"mounts routes"| node_competition_routes
node_server -->|"mounts routes"| node_submission_routes
node_server -->|"mounts routes"| node_judge_routes
node_server -->|"mounts routes"| node_leaderboard_routes
node_server -->|"mounts routes"| node_llm_routes
node_llm_routes -->|"queries submissions"| node_firebase_admin
node_firebase_client -->|"reads and writes"| node_firestore
node_firebase_admin -.->|"accesses data"| node_firestore
node_leaderboard_ui -->|"loads leaderboard data"| node_firebase_client
node_leaderboard_ui -->|"queries leaderboard"| node_firestore
node_results -.->|"loads results"| node_frontend_api

click node_auth "https://github.com/etlonline/promptcompetition2025/blob/main/components/auth-provider.tsx"
click node_landing "https://github.com/etlonline/promptcompetition2025/blob/main/app/page.tsx"
click node_participant_portal "https://github.com/etlonline/promptcompetition2025/blob/main/app/participant/page.tsx"
click node_challenge_entry "https://github.com/etlonline/promptcompetition2025/blob/main/app/participant/%5BcompetitionId%5D/%5BchallengeId%5D/page.tsx"
click node_daily_challenges "https://github.com/etlonline/promptcompetition2025/blob/main/app/participant/daily-challenge/%5BchallengeId%5D/page.tsx"
click node_level2 "https://github.com/etlonline/promptcompetition2025/blob/main/app/participant/%5BcompetitionId%5D/level2/page.tsx"
click node_results "https://github.com/etlonline/promptcompetition2025/blob/main/app/participant/%5BcompetitionId%5D/results/page.tsx"
click node_judge_portal "https://github.com/etlonline/promptcompetition2025/blob/main/app/judge/page.tsx"
click node_judge_scoring "https://github.com/etlonline/promptcompetition2025/blob/main/app/judge/%5BcompetitionId%5D/%5BchallengeId%5D/page.tsx"
click node_leaderboard_ui "https://github.com/etlonline/promptcompetition2025/blob/main/app/leaderboard/page.tsx"
click node_admin "https://github.com/etlonline/promptcompetition2025/blob/main/app/admin/competitions/%5BcompetitionId%5D/dashboard/page.tsx"
click node_admin_judging "https://github.com/etlonline/promptcompetition2025/blob/main/app/admin/competitions/%5BcompetitionId%5D/judge-evaluations/page.tsx"
click node_llm_eval_ui "https://github.com/etlonline/promptcompetition2025/blob/main/app/admin/competitions/%5BcompetitionId%5D/llm-evaluations/page.tsx"
click node_role_admin "https://github.com/etlonline/promptcompetition2025/blob/main/components/SuperAdmin/UserRoleManager.tsx"
click node_frontend_api "https://github.com/etlonline/promptcompetition2025/blob/main/lib/api.ts"
click node_server "https://github.com/etlonline/promptcompetition2025/blob/main/server/index.ts"
click node_competition_routes "https://github.com/etlonline/promptcompetition2025/blob/main/server/routes/competitions.ts"
click node_submission_routes "https://github.com/etlonline/promptcompetition2025/blob/main/server/routes/submissions.ts"
click node_judge_routes "https://github.com/etlonline/promptcompetition2025/tree/main/server/routes/judge"
click node_leaderboard_routes "https://github.com/etlonline/promptcompetition2025/blob/main/server/routes/leaderboard.ts"
click node_llm_routes "https://github.com/etlonline/promptcompetition2025/blob/main/server/routes/llmevaluations.ts"
click node_firebase_client "https://github.com/etlonline/promptcompetition2025/blob/main/lib/firebase.ts"
click node_firebase_admin "https://github.com/etlonline/promptcompetition2025/blob/main/server/config/firebase-admin.ts"

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_auth,node_landing toneBlue
class node_participant_portal,node_challenge_entry,node_daily_challenges,node_level2,node_results,node_judge_portal,node_judge_scoring,node_leaderboard_ui toneAmber
class node_admin,node_admin_judging,node_llm_eval_ui,node_role_admin toneMint
class node_frontend_api,node_server,node_competition_routes,node_submission_routes,node_judge_routes,node_leaderboard_routes,node_llm_routes toneRose
class node_firebase_client,node_firestore,node_firebase_admin,node_visitor toneIndigo
```

## Components

### Web experience

- [Authentication](https://github.com/etlonline/promptcompetition2025/blob/main/components/auth-provider.tsx): `components/auth-provider.tsx`
- [Competition discovery](https://github.com/etlonline/promptcompetition2025/blob/main/app/page.tsx): `app/page.tsx`

### Competition workflow

- [Participant portal](https://github.com/etlonline/promptcompetition2025/blob/main/app/participant/page.tsx): `app/participant/page.tsx`
- [Challenge participation](https://github.com/etlonline/promptcompetition2025/blob/main/app/participant/%5BcompetitionId%5D/%5BchallengeId%5D/page.tsx): `app/participant/[competitionId]/[challengeId]/page.tsx`
- [Daily challenges](https://github.com/etlonline/promptcompetition2025/blob/main/app/participant/daily-challenge/%5BchallengeId%5D/page.tsx): `app/participant/daily-challenge/[challengeId]/page.tsx`
- [Level 2 competition](https://github.com/etlonline/promptcompetition2025/blob/main/app/participant/%5BcompetitionId%5D/level2/page.tsx): `app/participant/[competitionId]/level2/page.tsx`
- [Participant results](https://github.com/etlonline/promptcompetition2025/blob/main/app/participant/%5BcompetitionId%5D/results/page.tsx): `app/participant/[competitionId]/results/page.tsx`
- [Judge portal](https://github.com/etlonline/promptcompetition2025/blob/main/app/judge/page.tsx): `app/judge/page.tsx`
- [Judge scoring](https://github.com/etlonline/promptcompetition2025/blob/main/app/judge/%5BcompetitionId%5D/%5BchallengeId%5D/page.tsx): `app/judge/[competitionId]/[challengeId]/page.tsx`
- [Public leaderboard](https://github.com/etlonline/promptcompetition2025/blob/main/app/leaderboard/page.tsx): `app/leaderboard/page.tsx`

### Administration

- [Competition administration](https://github.com/etlonline/promptcompetition2025/blob/main/app/admin/competitions/%5BcompetitionId%5D/dashboard/page.tsx): `app/admin/competitions/[competitionId]/dashboard/page.tsx`
- [Judge and evaluation oversight](https://github.com/etlonline/promptcompetition2025/blob/main/app/admin/competitions/%5BcompetitionId%5D/judge-evaluations/page.tsx): `app/admin/competitions/[competitionId]/judge-evaluations/page.tsx`
- [LLM evaluation review](https://github.com/etlonline/promptcompetition2025/blob/main/app/admin/competitions/%5BcompetitionId%5D/llm-evaluations/page.tsx): `app/admin/competitions/[competitionId]/llm-evaluations/page.tsx`
- [User role management](https://github.com/etlonline/promptcompetition2025/blob/main/components/SuperAdmin/UserRoleManager.tsx): `components/SuperAdmin/UserRoleManager.tsx`

### API services

- [Authenticated API client](https://github.com/etlonline/promptcompetition2025/blob/main/lib/api.ts): `lib/api.ts`
- [HTTP route dispatcher](https://github.com/etlonline/promptcompetition2025/blob/main/server/index.ts): `server/index.ts`
- [Competition routes](https://github.com/etlonline/promptcompetition2025/blob/main/server/routes/competitions.ts): `server/routes/competitions.ts`
- [Submission routes](https://github.com/etlonline/promptcompetition2025/blob/main/server/routes/submissions.ts): `server/routes/submissions.ts`
- [Judge routes](https://github.com/etlonline/promptcompetition2025/tree/main/server/routes/judge): `server/routes/judge`
- [Leaderboard routes](https://github.com/etlonline/promptcompetition2025/blob/main/server/routes/leaderboard.ts): `server/routes/leaderboard.ts`
- [LLM evaluation routes](https://github.com/etlonline/promptcompetition2025/blob/main/server/routes/llmevaluations.ts): `server/routes/llmevaluations.ts`

### Identity and data

- [Firebase client services](https://github.com/etlonline/promptcompetition2025/blob/main/lib/firebase.ts): `lib/firebase.ts`
- **Firestore**
- [Firebase Admin services](https://github.com/etlonline/promptcompetition2025/blob/main/server/config/firebase-admin.ts): `server/config/firebase-admin.ts`

### Other components

- **Visitor / participant**

## Connections

- Visitor / participant → Competition discovery: browses (evidence: `app/page.tsx`)
- Visitor / participant → Authentication: signs in
- Competition discovery → Authenticated API client: loads competitions (evidence: `app/page.tsx`)
- Participant portal → Authenticated API client: loads competitions (evidence: `app/participant/page.tsx`)
- Participant portal → Firebase client services: reads participant data (evidence: `app/participant/page.tsx`)
- Participant portal → Challenge participation: opens challenge
- Participant portal → Daily challenges: opens daily challenge
- Participant portal → Level 2 competition: continues qualifying
- Challenge participation → Submission routes: submits work
- Daily challenges → Submission routes: submits work
- Level 2 competition → Submission routes: submits work
- Judge portal → Authenticated API client: loads assignments (evidence: `app/judge/page.tsx`)
- Judge scoring → Judge routes: records scores
- Competition administration → Authenticated API client: manages competition
- Judge and evaluation oversight → Authenticated API client: reviews evaluations
- LLM evaluation review → Authenticated API client: loads evaluations
- LLM evaluation review → LLM evaluation routes: requests submissions
- User role management → Authenticated API client: manages roles (evidence: `components/SuperAdmin/UserRoleManager.tsx`)
- Authenticated API client → HTTP route dispatcher: sends API requests
- HTTP route dispatcher → Competition routes: mounts routes (evidence: `server/index.ts`)
- HTTP route dispatcher → Submission routes: mounts routes (evidence: `server/index.ts`)
- HTTP route dispatcher → Judge routes: mounts routes (evidence: `server/index.ts`)
- HTTP route dispatcher → Leaderboard routes: mounts routes (evidence: `server/index.ts`)
- HTTP route dispatcher → LLM evaluation routes: mounts routes (evidence: `server/index.ts`)
- LLM evaluation routes → Firebase Admin services: queries submissions (evidence: `server/routes/llmevaluations.ts`)
- Firebase client services → Firestore: reads and writes (evidence: `lib/firebase.ts`)
- Firebase Admin services → Firestore: accesses data
- Public leaderboard → Firebase client services: loads leaderboard data (evidence: `app/leaderboard/page.tsx`)
- Public leaderboard → Firestore: queries leaderboard (evidence: `app/leaderboard/page.tsx`)
- Participant results → Authenticated API client: loads results
