# dcebo/convention-website architecture

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

- Interactive diagram: https://gitdiagram.com/dcebo/convention-website
- Repository: https://github.com/dcebo/convention-website

## Overview

Collect-It-Con is a convention website for discovering event information, vendors, venue details, faction contests, and participation opportunities, with ticket-purchase and contact/newsletter paths. Visitors enter through site pages; the clearest evidenced journey is the home page linking to event information and ticket buying. The faction experience has a distinct data-to-service-to-dashboard flow, while contact submissions reach an email service. Several route capabilities are documented by the tree but their internal wiring was not sampled, so those branches are represented without speculative connections.

Main entry points: [`src/components/factions/FactionDashboard.tsx`](https://github.com/dcebo/convention-website/blob/main/src/components/factions/FactionDashboard.tsx) (Faction dashboard), [`src/services/factionService.ts`](https://github.com/dcebo/convention-website/blob/main/src/services/factionService.ts) (Faction service), [`src/app/page.tsx`](https://github.com/dcebo/convention-website/blob/main/src/app/page.tsx) (Home page), [`src/components/factions/FactionLeaderboard.tsx`](https://github.com/dcebo/convention-website/blob/main/src/components/factions/FactionLeaderboard.tsx) (Leaderboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Site &amp; information"]
  node_home["Home page<br/>[page.tsx]"]
  node_about["About<br/>[page.tsx]"]
  node_site_layout["Shared layout<br/>[PageLayout.tsx]"]
end

subgraph group_community["Faction competition"]
  node_faction_pages["Faction pages<br/>[page.tsx]"]
  node_contest_page["Contest page<br/>[page.tsx]"]
  node_faction_ui["Faction dashboard"]
  node_leaderboard["Leaderboard"]
  node_history_chart["History chart"]
  node_faction_catalog["Faction definitions<br/>[factions.ts]"]
  node_faction_service["Faction service<br/>[factionService.ts]"]
  node_faction_store[("Faction storage<br/>[factionDatabase.ts]")]
  node_qr_generator["QR generation<br/>[qrcode.ts]"]
  node_faction_types["Faction models<br/>[factions.ts]"]
end

subgraph group_market["Marketplace &amp; venue"]
  node_vendor_application["Vendor directory &amp; application<br/>[page.tsx]"]
  node_vendor_list["Vendor listings<br/>[vendors.ts]"]
  node_venue_page["Venue map page<br/>[page.tsx]"]
  node_venue_map["Venue map view<br/>[VenueMap.tsx]"]
  node_venue_data["Map data<br/>[venueMap.ts]"]
end

subgraph group_transactions["Tickets &amp; outreach"]
  node_ticket_page["Ticket purchase page<br/>[page.tsx]"]
  node_checkout["Checkout form<br/>[CheckoutForm.tsx]"]
  node_payment_service["Payment service<br/>[paymentService.ts]"]
  node_contact_page["Contact page<br/>[page.tsx]"]
  node_contact_api["Contact endpoint<br/>[route.ts]"]
  node_newsletter_api["Newsletter endpoint<br/>[route.ts]"]
  node_email_service["Email service<br/>[email.ts]"]
  node_contact_config["Contact settings<br/>[contactInfo.ts]"]
  node_newsletter_page["Newsletter signup<br/>[route.ts]"]
end

subgraph group_operations["Participation"]
  node_participation_pages["Participation information<br/>[page.tsx]"]
  node_events_page["Events &amp; programming<br/>[page.tsx]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_home
node_home -->|"links to"| node_about
node_home -->|"links to"| node_ticket_page
node_faction_pages -->|"renders"| node_faction_ui
node_contest_page -->|"uses"| node_faction_service
node_contest_page -->|"reads"| node_faction_catalog
node_faction_ui -->|"reads"| node_faction_catalog
node_faction_ui -->|"requests stats"| node_faction_service
node_faction_ui -->|"renders"| node_leaderboard
node_faction_ui -->|"renders"| node_history_chart
node_leaderboard -->|"requests data"| node_faction_service
node_faction_service -->|"reads and writes"| node_faction_store
node_faction_service -->|"generates codes"| node_qr_generator
node_faction_service -->|"uses models"| node_faction_types
node_faction_ui -->|"uses models"| node_faction_types
node_leaderboard -->|"uses models"| node_faction_types
node_vendor_application -.->|"lists vendors"| node_vendor_list
node_venue_map -->|"reads"| node_venue_data
node_venue_map -->|"reads"| node_vendor_list
node_venue_page -.->|"shows map"| node_venue_map
node_ticket_page -.->|"offers checkout"| node_checkout
node_checkout -.->|"processes payment"| node_payment_service
node_contact_page -->|"reads settings"| node_contact_config
node_contact_api -->|"sends messages"| node_email_service
node_newsletter_api -->|"sends messages"| node_email_service
node_email_service -->|"reads address"| node_contact_config

click node_home "https://github.com/dcebo/convention-website/blob/main/src/app/page.tsx"
click node_about "https://github.com/dcebo/convention-website/blob/main/src/app/about/page.tsx"
click node_site_layout "https://github.com/dcebo/convention-website/blob/main/src/components/layout/PageLayout.tsx"
click node_faction_pages "https://github.com/dcebo/convention-website/blob/main/src/app/factions/page.tsx"
click node_contest_page "https://github.com/dcebo/convention-website/blob/main/src/app/things-to-do/programming/contests/page.tsx"
click node_faction_ui "https://github.com/dcebo/convention-website/blob/main/src/components/factions/FactionDashboard.tsx"
click node_leaderboard "https://github.com/dcebo/convention-website/blob/main/src/components/factions/FactionLeaderboard.tsx"
click node_history_chart "https://github.com/dcebo/convention-website/blob/main/src/components/factions/FactionHistoryChart.tsx"
click node_faction_catalog "https://github.com/dcebo/convention-website/blob/main/src/data/factions.ts"
click node_faction_service "https://github.com/dcebo/convention-website/blob/main/src/services/factionService.ts"
click node_faction_store "https://github.com/dcebo/convention-website/blob/main/src/lib/factionDatabase.ts"
click node_qr_generator "https://github.com/dcebo/convention-website/blob/main/src/lib/qrcode.ts"
click node_faction_types "https://github.com/dcebo/convention-website/blob/main/src/types/factions.ts"
click node_vendor_application "https://github.com/dcebo/convention-website/blob/main/src/app/participate/vendors/page.tsx"
click node_vendor_list "https://github.com/dcebo/convention-website/blob/main/src/data/vendors.ts"
click node_venue_page "https://github.com/dcebo/convention-website/blob/main/src/app/things-to-do/venue-map/page.tsx"
click node_venue_map "https://github.com/dcebo/convention-website/blob/main/src/components/venue/VenueMap.tsx"
click node_venue_data "https://github.com/dcebo/convention-website/blob/main/src/data/venueMap.ts"
click node_ticket_page "https://github.com/dcebo/convention-website/blob/main/src/app/buy-now/page.tsx"
click node_checkout "https://github.com/dcebo/convention-website/blob/main/src/components/tickets/CheckoutForm.tsx"
click node_payment_service "https://github.com/dcebo/convention-website/blob/main/src/services/paymentService.ts"
click node_contact_page "https://github.com/dcebo/convention-website/blob/main/src/app/contact/page.tsx"
click node_contact_api "https://github.com/dcebo/convention-website/blob/main/src/app/api/contact/route.ts"
click node_newsletter_api "https://github.com/dcebo/convention-website/blob/main/src/app/api/newsletter/route.ts"
click node_email_service "https://github.com/dcebo/convention-website/blob/main/src/lib/email.ts"
click node_contact_config "https://github.com/dcebo/convention-website/blob/main/src/config/contactInfo.ts"
click node_newsletter_page "https://github.com/dcebo/convention-website/blob/main/src/app/api/newsletter/route.ts"
click node_participation_pages "https://github.com/dcebo/convention-website/blob/main/src/app/participate/volunteer/page.tsx"
click node_events_page "https://github.com/dcebo/convention-website/blob/main/src/app/things-to-do/programming/events/page.tsx"

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_home,node_about,node_site_layout toneBlue
class node_faction_pages,node_contest_page,node_faction_ui,node_leaderboard,node_history_chart,node_faction_catalog,node_faction_service,node_faction_store,node_qr_generator,node_faction_types toneAmber
class node_vendor_application,node_vendor_list,node_venue_page,node_venue_map,node_venue_data toneMint
class node_ticket_page,node_checkout,node_payment_service,node_contact_page,node_contact_api,node_newsletter_api,node_email_service,node_contact_config,node_newsletter_page toneRose
class node_participation_pages,node_events_page,node_visitor toneIndigo
```

## Components

### Site & information

- [Home page](https://github.com/dcebo/convention-website/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [About](https://github.com/dcebo/convention-website/blob/main/src/app/about/page.tsx): `src/app/about/page.tsx`
- [Shared layout](https://github.com/dcebo/convention-website/blob/main/src/components/layout/PageLayout.tsx): `src/components/layout/PageLayout.tsx`

### Faction competition

- [Faction pages](https://github.com/dcebo/convention-website/blob/main/src/app/factions/page.tsx): `src/app/factions/page.tsx`
- [Contest page](https://github.com/dcebo/convention-website/blob/main/src/app/things-to-do/programming/contests/page.tsx): `src/app/things-to-do/programming/contests/page.tsx`
- [Faction dashboard](https://github.com/dcebo/convention-website/blob/main/src/components/factions/FactionDashboard.tsx): `src/components/factions/FactionDashboard.tsx`
- [Leaderboard](https://github.com/dcebo/convention-website/blob/main/src/components/factions/FactionLeaderboard.tsx): `src/components/factions/FactionLeaderboard.tsx`
- [History chart](https://github.com/dcebo/convention-website/blob/main/src/components/factions/FactionHistoryChart.tsx): `src/components/factions/FactionHistoryChart.tsx`
- [Faction definitions](https://github.com/dcebo/convention-website/blob/main/src/data/factions.ts): `src/data/factions.ts`
- [Faction service](https://github.com/dcebo/convention-website/blob/main/src/services/factionService.ts): `src/services/factionService.ts`
- [Faction storage](https://github.com/dcebo/convention-website/blob/main/src/lib/factionDatabase.ts): `src/lib/factionDatabase.ts`
- [QR generation](https://github.com/dcebo/convention-website/blob/main/src/lib/qrcode.ts): `src/lib/qrcode.ts`
- [Faction models](https://github.com/dcebo/convention-website/blob/main/src/types/factions.ts): `src/types/factions.ts`

### Marketplace & venue

- [Vendor directory & application](https://github.com/dcebo/convention-website/blob/main/src/app/participate/vendors/page.tsx): `src/app/participate/vendors/page.tsx`
- [Vendor listings](https://github.com/dcebo/convention-website/blob/main/src/data/vendors.ts): `src/data/vendors.ts`
- [Venue map page](https://github.com/dcebo/convention-website/blob/main/src/app/things-to-do/venue-map/page.tsx): `src/app/things-to-do/venue-map/page.tsx`
- [Venue map view](https://github.com/dcebo/convention-website/blob/main/src/components/venue/VenueMap.tsx): `src/components/venue/VenueMap.tsx`
- [Map data](https://github.com/dcebo/convention-website/blob/main/src/data/venueMap.ts): `src/data/venueMap.ts`

### Tickets & outreach

- [Ticket purchase page](https://github.com/dcebo/convention-website/blob/main/src/app/buy-now/page.tsx): `src/app/buy-now/page.tsx`
- [Checkout form](https://github.com/dcebo/convention-website/blob/main/src/components/tickets/CheckoutForm.tsx): `src/components/tickets/CheckoutForm.tsx`
- [Payment service](https://github.com/dcebo/convention-website/blob/main/src/services/paymentService.ts): `src/services/paymentService.ts`
- [Contact page](https://github.com/dcebo/convention-website/blob/main/src/app/contact/page.tsx): `src/app/contact/page.tsx`
- [Contact endpoint](https://github.com/dcebo/convention-website/blob/main/src/app/api/contact/route.ts): `src/app/api/contact/route.ts`
- [Newsletter endpoint](https://github.com/dcebo/convention-website/blob/main/src/app/api/newsletter/route.ts): `src/app/api/newsletter/route.ts`
- [Email service](https://github.com/dcebo/convention-website/blob/main/src/lib/email.ts): `src/lib/email.ts`
- [Contact settings](https://github.com/dcebo/convention-website/blob/main/src/config/contactInfo.ts): `src/config/contactInfo.ts`
- [Newsletter signup](https://github.com/dcebo/convention-website/blob/main/src/app/api/newsletter/route.ts): `src/app/api/newsletter/route.ts`

### Participation

- [Participation information](https://github.com/dcebo/convention-website/blob/main/src/app/participate/volunteer/page.tsx): `src/app/participate/volunteer/page.tsx`
- [Events & programming](https://github.com/dcebo/convention-website/blob/main/src/app/things-to-do/programming/events/page.tsx): `src/app/things-to-do/programming/events/page.tsx`

### Other components

- **Visitor**

## Connections

- Visitor → Home page: opens
- Home page → About: links to (evidence: `src/app/page.tsx`)
- Home page → Ticket purchase page: links to (evidence: `src/app/page.tsx`)
- Faction pages → Faction dashboard: renders (evidence: `src/app/factions/page.tsx`)
- Contest page → Faction service: uses (evidence: `src/app/things-to-do/programming/contests/page.tsx`)
- Contest page → Faction definitions: reads (evidence: `src/app/things-to-do/programming/contests/page.tsx`)
- Faction dashboard → Faction definitions: reads (evidence: `src/components/factions/FactionDashboard.tsx`)
- Faction dashboard → Faction service: requests stats (evidence: `src/components/factions/FactionDashboard.tsx`)
- Faction dashboard → Leaderboard: renders (evidence: `src/components/factions/FactionDashboard.tsx`)
- Faction dashboard → History chart: renders (evidence: `src/components/factions/FactionDashboard.tsx`)
- Leaderboard → Faction service: requests data (evidence: `src/components/factions/FactionLeaderboard.tsx`)
- Faction service → Faction storage: reads and writes (evidence: `src/services/factionService.ts`)
- Faction service → QR generation: generates codes (evidence: `src/services/factionService.ts`)
- Faction service → Faction models: uses models (evidence: `src/services/factionService.ts`)
- Faction dashboard → Faction models: uses models (evidence: `src/components/factions/FactionDashboard.tsx`)
- Leaderboard → Faction models: uses models (evidence: `src/components/factions/FactionLeaderboard.tsx`)
- Vendor directory & application → Vendor listings: lists vendors
- Venue map view → Map data: reads (evidence: `src/components/venue/VenueMap.tsx`)
- Venue map view → Vendor listings: reads (evidence: `src/components/venue/VenueMap.tsx`)
- Venue map page → Venue map view: shows map
- Ticket purchase page → Checkout form: offers checkout
- Checkout form → Payment service: processes payment
- Contact page → Contact settings: reads settings (evidence: `src/app/contact/page.tsx`)
- Contact endpoint → Email service: sends messages (evidence: `src/app/api/contact/route.ts`)
- Newsletter endpoint → Email service: sends messages (evidence: `src/app/api/newsletter/route.ts`)
- Email service → Contact settings: reads address (evidence: `src/lib/email.ts`)
