How etlonline/promptcompetition2025 works
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: api.ts Authenticated API client · index.ts HTTP route dispatcher · page.tsx Participant portal · submissions.ts Submission routes
Components 25
Web experience
- Authentication
components/auth-provider.tsx - Competition discovery
app/page.tsx
Competition workflow
- Participant portal
app/participant/page.tsx - Challenge participation
app/participant/[competitionId]/[challengeId]/page.tsx - Daily challenges
app/participant/daily-challenge/[challengeId]/page.tsx - Level 2 competition
app/participant/[competitionId]/level2/page.tsx - Participant results
app/participant/[competitionId]/results/page.tsx - Judge portal
app/judge/page.tsx - Judge scoring
app/judge/[competitionId]/[challengeId]/page.tsx - Public leaderboard
app/leaderboard/page.tsx
Administration
- Competition administration
app/admin/competitions/[competitionId]/dashboard/page.tsx - Judge and evaluation oversight
app/admin/competitions/[competitionId]/judge-evaluations/page.tsx - LLM evaluation review
app/admin/competitions/[competitionId]/llm-evaluations/page.tsx - User role management
components/SuperAdmin/UserRoleManager.tsx
API services
- Authenticated API client
lib/api.ts - HTTP route dispatcher
server/index.ts - Competition routes
server/routes/competitions.ts - Submission routes
server/routes/submissions.ts - Judge routes
server/routes/judge - Leaderboard routes
server/routes/leaderboard.ts - LLM evaluation routes
server/routes/llmevaluations.ts
Identity and data
- Firebase client services
lib/firebase.ts - Firestore
- Firebase Admin services
server/config/firebase-admin.ts
Other components
- Visitor / participant
Connections 30
- Visitor / participant → Competition discovery: browses
app/page.tsx - Visitor / participant → Authentication: signs in
- Competition discovery → Authenticated API client: loads competitions
app/page.tsx - Participant portal → Authenticated API client: loads competitions
app/participant/page.tsx - Participant portal → Firebase client services: reads participant data
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
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
components/SuperAdmin/UserRoleManager.tsx - Authenticated API client → HTTP route dispatcher: sends API requests
- HTTP route dispatcher → Competition routes: mounts routes
server/index.ts - HTTP route dispatcher → Submission routes: mounts routes
server/index.ts - HTTP route dispatcher → Judge routes: mounts routes
server/index.ts - HTTP route dispatcher → Leaderboard routes: mounts routes
server/index.ts - HTTP route dispatcher → LLM evaluation routes: mounts routes
server/index.ts - LLM evaluation routes → Firebase Admin services: queries submissions
server/routes/llmevaluations.ts - Firebase client services → Firestore: reads and writes
lib/firebase.ts - Firebase Admin services → Firestore: accesses data
- Public leaderboard → Firebase client services: loads leaderboard data
app/leaderboard/page.tsx - Public leaderboard → Firestore: queries leaderboard
app/leaderboard/page.tsx - Participant results → Authenticated API client: loads results