# team-asterix264016/team-asterix-website architecture

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

- Interactive diagram: https://gitdiagram.com/team-asterix264016/team-asterix-website
- Repository: https://github.com/team-asterix264016/team-asterix-website

## Overview

Team Asterix is an engineering-team portal with a React frontend and Express/MongoDB API. Visitors explore the team and its autonomous-mobility work; workshop participants register, attend sessions, submit projects, and take quizzes; administrators manage portal content and workshop operations. The graph preserves those distinct product areas and the documented intro-to-3D experience. Several route implementations were not sampled, so some frontend-to-API relationships are shown as unverified rather than asserted as source-confirmed calls.

Main entry points: [`server/src/index.js`](https://github.com/team-asterix264016/team-asterix-website/blob/main/server/src/index.js) (Express API), [`src/context/WebsiteDataContext.jsx`](https://github.com/team-asterix264016/team-asterix-website/blob/main/src/context/WebsiteDataContext.jsx) (Site Data Provider), [`src/lib/api.js`](https://github.com/team-asterix264016/team-asterix-website/blob/main/src/lib/api.js) (API Client), [`src/App.jsx`](https://github.com/team-asterix264016/team-asterix-website/blob/main/src/App.jsx) (Portal App)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Portal Experience"]
  node_intro["Scroll Intro"]
  node_vehicle["3D Vehicle Scene<br/>[Car3DCanvas.jsx]"]
  node_portal["Portal App<br/>[App.jsx]"]
end

subgraph group_content["Team Content"]
  node_site_data["Site Data Provider"]
  node_team_showcase["Team Showcase"]
  node_recruitment["Recruitment Briefs"]
  node_community_auth["Community Identity"]
  node_admin_dashboard["Admin Control Center<br/>[AdminDashboard.jsx]"]
end

subgraph group_workshop["Workshop Platform"]
  node_workshop_page["Workshop Portal<br/>[WorkshopPage.jsx]"]
  node_profile["Participant Profile"]
  node_attendance_checkin["Attendance Check-in"]
  node_project_submission["Project Submission"]
  node_workshop_admin["Workshop Administration"]
  node_workshop_packages["Workshop Packages"]
end

subgraph group_quiz["Quiz Engine"]
  node_quiz_runner["Quiz Runner<br/>[QuizRunner.jsx]"]
  node_quiz_admin["Quiz Management<br/>[QuizAdmin.jsx]"]
end

subgraph group_backend["API and Persistence"]
  node_attendance_api["Attendance API<br/>[attendance.js]"]
  node_workshop_api["Workshop API<br/>[workshop.js]"]
  node_quiz_api["Quiz API<br/>[quiz.js]"]
  node_api_client["API Client<br/>[api.js]"]
  node_express_api["Express API<br/>[index.js]"]
  node_mongodb[("MongoDB Access<br/>[mongodb.js]")]
  node_imagekit["ImageKit Media<br/>[imagekit.js]"]
end

node_visitor(("Visitor"))
node_participant(("Participant"))
node_administrator(("Administrator"))

node_visitor -->|"explores"| node_portal
node_portal -->|"renders"| node_intro
node_portal -.->|"transitions to"| node_vehicle
node_visitor -->|"views"| node_team_showcase
node_team_showcase -.->|"reads content"| node_site_data
node_site_data -->|"requests API"| node_api_client
node_site_data -->|"syncs site data"| node_express_api
node_recruitment -->|"supplies briefs"| node_site_data
node_participant -->|"registers"| node_workshop_page
node_workshop_page -->|"uses packages"| node_workshop_packages
node_workshop_page -.->|"requests workshop services"| node_workshop_api
node_participant -->|"views profile"| node_profile
node_participant -->|"checks in"| node_attendance_checkin
node_attendance_checkin -.->|"submits check-in"| node_attendance_api
node_participant -->|"submits project"| node_project_submission
node_project_submission -.->|"submits project"| node_workshop_api
node_administrator -->|"manages portal"| node_admin_dashboard
node_admin_dashboard -->|"opens management"| node_workshop_admin
node_administrator -->|"configures quizzes"| node_quiz_admin
node_participant -->|"takes quiz"| node_quiz_runner
node_quiz_runner -->|"requests quiz"| node_api_client
node_quiz_runner -.->|"submits and retrieves results"| node_quiz_api
node_quiz_admin -->|"manages quizzes"| node_api_client
node_quiz_admin -.->|"configures quizzes"| node_quiz_api
node_administrator -.->|"edits site content"| node_site_data
node_api_client -->|"sends requests"| node_express_api
node_express_api -->|"connects database"| node_mongodb
node_express_api -->|"mounts routes"| node_attendance_api
node_express_api -->|"mounts routes"| node_workshop_api
node_express_api -->|"mounts routes"| node_quiz_api
node_admin_dashboard -->|"uploads media"| node_api_client
node_express_api -->|"checks configuration"| node_imagekit
node_community_auth -->|"reads registrations"| node_site_data

click node_intro "https://github.com/team-asterix264016/team-asterix-website/blob/main/src/components/IntroScrollSequence.jsx"
click node_vehicle "https://github.com/team-asterix264016/team-asterix-website/blob/main/src/components/Car3DCanvas.jsx"
click node_portal "https://github.com/team-asterix264016/team-asterix-website/blob/main/src/App.jsx"
click node_site_data "https://github.com/team-asterix264016/team-asterix-website/blob/main/src/context/WebsiteDataContext.jsx"
click node_team_showcase "https://github.com/team-asterix264016/team-asterix-website/blob/main/src/components/SubsystemDetail.jsx"
click node_recruitment "https://github.com/team-asterix264016/team-asterix-website/blob/main/src/data/recruitmentProblemStatements.js"
click node_community_auth "https://github.com/team-asterix264016/team-asterix-website/blob/main/src/context/CommunityAuthContext.jsx"
click node_workshop_page "https://github.com/team-asterix264016/team-asterix-website/blob/main/src/components/WorkshopPage.jsx"
click node_profile "https://github.com/team-asterix264016/team-asterix-website/blob/main/src/components/ParticipantProfilePage.jsx"
click node_attendance_checkin "https://github.com/team-asterix264016/team-asterix-website/blob/main/src/components/WorkshopAttendanceCheckin.jsx"
click node_project_submission "https://github.com/team-asterix264016/team-asterix-website/blob/main/src/components/WorkshopProjectSubmissionPage.jsx"
click node_workshop_admin "https://github.com/team-asterix264016/team-asterix-website/blob/main/src/components/admin/WorkshopRegistrationsAdmin.jsx"
click node_attendance_api "https://github.com/team-asterix264016/team-asterix-website/blob/main/server/src/routes/attendance.js"
click node_workshop_api "https://github.com/team-asterix264016/team-asterix-website/blob/main/server/src/routes/workshop.js"
click node_quiz_runner "https://github.com/team-asterix264016/team-asterix-website/blob/main/src/components/quiz/QuizRunner.jsx"
click node_quiz_admin "https://github.com/team-asterix264016/team-asterix-website/blob/main/src/components/admin/QuizAdmin.jsx"
click node_quiz_api "https://github.com/team-asterix264016/team-asterix-website/blob/main/server/src/routes/quiz.js"
click node_admin_dashboard "https://github.com/team-asterix264016/team-asterix-website/blob/main/src/components/admin/AdminDashboard.jsx"
click node_api_client "https://github.com/team-asterix264016/team-asterix-website/blob/main/src/lib/api.js"
click node_express_api "https://github.com/team-asterix264016/team-asterix-website/blob/main/server/src/index.js"
click node_mongodb "https://github.com/team-asterix264016/team-asterix-website/blob/main/server/src/db/mongodb.js"
click node_imagekit "https://github.com/team-asterix264016/team-asterix-website/blob/main/server/src/lib/imagekit.js"
click node_workshop_packages "https://github.com/team-asterix264016/team-asterix-website/blob/main/server/src/config/workshopPackages.js"

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_intro,node_vehicle,node_portal toneBlue
class node_site_data,node_team_showcase,node_recruitment,node_community_auth,node_admin_dashboard toneAmber
class node_workshop_page,node_profile,node_attendance_checkin,node_project_submission,node_workshop_admin,node_workshop_packages toneMint
class node_quiz_runner,node_quiz_admin toneRose
class node_attendance_api,node_workshop_api,node_quiz_api,node_api_client,node_express_api,node_mongodb,node_imagekit,node_visitor,node_participant,node_administrator toneIndigo
```

## Components

### Portal Experience

- [Scroll Intro](https://github.com/team-asterix264016/team-asterix-website/blob/main/src/components/IntroScrollSequence.jsx): `src/components/IntroScrollSequence.jsx`
- [3D Vehicle Scene](https://github.com/team-asterix264016/team-asterix-website/blob/main/src/components/Car3DCanvas.jsx): `src/components/Car3DCanvas.jsx`
- [Portal App](https://github.com/team-asterix264016/team-asterix-website/blob/main/src/App.jsx): `src/App.jsx`

### Team Content

- [Site Data Provider](https://github.com/team-asterix264016/team-asterix-website/blob/main/src/context/WebsiteDataContext.jsx): `src/context/WebsiteDataContext.jsx`
- [Team Showcase](https://github.com/team-asterix264016/team-asterix-website/blob/main/src/components/SubsystemDetail.jsx): `src/components/SubsystemDetail.jsx`
- [Recruitment Briefs](https://github.com/team-asterix264016/team-asterix-website/blob/main/src/data/recruitmentProblemStatements.js): `src/data/recruitmentProblemStatements.js`
- [Community Identity](https://github.com/team-asterix264016/team-asterix-website/blob/main/src/context/CommunityAuthContext.jsx): `src/context/CommunityAuthContext.jsx`
- [Admin Control Center](https://github.com/team-asterix264016/team-asterix-website/blob/main/src/components/admin/AdminDashboard.jsx): `src/components/admin/AdminDashboard.jsx`

### Workshop Platform

- [Workshop Portal](https://github.com/team-asterix264016/team-asterix-website/blob/main/src/components/WorkshopPage.jsx): `src/components/WorkshopPage.jsx`
- [Participant Profile](https://github.com/team-asterix264016/team-asterix-website/blob/main/src/components/ParticipantProfilePage.jsx): `src/components/ParticipantProfilePage.jsx`
- [Attendance Check-in](https://github.com/team-asterix264016/team-asterix-website/blob/main/src/components/WorkshopAttendanceCheckin.jsx): `src/components/WorkshopAttendanceCheckin.jsx`
- [Project Submission](https://github.com/team-asterix264016/team-asterix-website/blob/main/src/components/WorkshopProjectSubmissionPage.jsx): `src/components/WorkshopProjectSubmissionPage.jsx`
- [Workshop Administration](https://github.com/team-asterix264016/team-asterix-website/blob/main/src/components/admin/WorkshopRegistrationsAdmin.jsx): `src/components/admin/WorkshopRegistrationsAdmin.jsx`
- [Workshop Packages](https://github.com/team-asterix264016/team-asterix-website/blob/main/server/src/config/workshopPackages.js): `server/src/config/workshopPackages.js`

### Quiz Engine

- [Quiz Runner](https://github.com/team-asterix264016/team-asterix-website/blob/main/src/components/quiz/QuizRunner.jsx): `src/components/quiz/QuizRunner.jsx`
- [Quiz Management](https://github.com/team-asterix264016/team-asterix-website/blob/main/src/components/admin/QuizAdmin.jsx): `src/components/admin/QuizAdmin.jsx`

### API and Persistence

- [Attendance API](https://github.com/team-asterix264016/team-asterix-website/blob/main/server/src/routes/attendance.js): `server/src/routes/attendance.js`
- [Workshop API](https://github.com/team-asterix264016/team-asterix-website/blob/main/server/src/routes/workshop.js): `server/src/routes/workshop.js`
- [Quiz API](https://github.com/team-asterix264016/team-asterix-website/blob/main/server/src/routes/quiz.js): `server/src/routes/quiz.js`
- [API Client](https://github.com/team-asterix264016/team-asterix-website/blob/main/src/lib/api.js): `src/lib/api.js`
- [Express API](https://github.com/team-asterix264016/team-asterix-website/blob/main/server/src/index.js): `server/src/index.js`
- [MongoDB Access](https://github.com/team-asterix264016/team-asterix-website/blob/main/server/src/db/mongodb.js): `server/src/db/mongodb.js`
- [ImageKit Media](https://github.com/team-asterix264016/team-asterix-website/blob/main/server/src/lib/imagekit.js): `server/src/lib/imagekit.js`

### Other components

- **Visitor**
- **Participant**
- **Administrator**

## Connections

- Visitor → Portal App: explores (evidence: `src/App.jsx`)
- Portal App → Scroll Intro: renders (evidence: `src/App.jsx`)
- Portal App → 3D Vehicle Scene: transitions to (evidence: `README.md`)
- Visitor → Team Showcase: views
- Team Showcase → Site Data Provider: reads content (evidence: `README.md`)
- Site Data Provider → API Client: requests API (evidence: `src/context/WebsiteDataContext.jsx`)
- Site Data Provider → Express API: syncs site data (evidence: `README.md`)
- Recruitment Briefs → Site Data Provider: supplies briefs (evidence: `src/context/WebsiteDataContext.jsx`)
- Participant → Workshop Portal: registers (evidence: `README.md`)
- Workshop Portal → Workshop Packages: uses packages (evidence: `src/components/WorkshopPage.jsx`)
- Workshop Portal → Workshop API: requests workshop services
- Participant → Participant Profile: views profile (evidence: `README.md`)
- Participant → Attendance Check-in: checks in (evidence: `README.md`)
- Attendance Check-in → Attendance API: submits check-in
- Participant → Project Submission: submits project (evidence: `README.md`)
- Project Submission → Workshop API: submits project
- Administrator → Admin Control Center: manages portal (evidence: `README.md`)
- Admin Control Center → Workshop Administration: opens management (evidence: `src/components/admin/AdminDashboard.jsx`)
- Administrator → Quiz Management: configures quizzes (evidence: `README.md`)
- Participant → Quiz Runner: takes quiz (evidence: `README.md`)
- Quiz Runner → API Client: requests quiz (evidence: `src/components/quiz/QuizRunner.jsx`)
- Quiz Runner → Quiz API: submits and retrieves results
- Quiz Management → API Client: manages quizzes (evidence: `src/components/admin/QuizAdmin.jsx`)
- Quiz Management → Quiz API: configures quizzes
- Administrator → Site Data Provider: edits site content (evidence: `README.md`)
- API Client → Express API: sends requests (evidence: `src/lib/api.js`)
- Express API → MongoDB Access: connects database (evidence: `server/src/index.js`)
- Express API → Attendance API: mounts routes (evidence: `server/src/index.js`)
- Express API → Workshop API: mounts routes (evidence: `server/src/index.js`)
- Express API → Quiz API: mounts routes (evidence: `server/src/index.js`)
- Admin Control Center → API Client: uploads media (evidence: `src/components/admin/AdminDashboard.jsx`)
- Express API → ImageKit Media: checks configuration (evidence: `server/src/index.js`)
- Community Identity → Site Data Provider: reads registrations (evidence: `src/context/CommunityAuthContext.jsx`)
