# team-asterix264016/asterix_website architecture

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

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

## Overview

Team Asterix’s BAJA SAEINDIA portal presents the team, vehicle, gallery, updates, recruitment, sponsorship, and paid workshops, with an admin interface for managing site content and operations. The main workflow runs from the React app through editable site data or domain-specific API requests to Express routes and persistent storage; workshop registration also supports payment. The README documents the opening animation, 3D scene, and offline content fallback. Some routes and page implementations were not sampled, so their internal links are omitted or shown only where documented.

Main entry points: [`src/components/admin/AdminDashboard.jsx`](https://github.com/team-asterix264016/asterix_website/blob/main/src/components/admin/AdminDashboard.jsx) (Admin dashboard), [`server/src/index.js`](https://github.com/team-asterix264016/asterix_website/blob/main/server/src/index.js) (Express API), [`server/src/routes`](https://github.com/team-asterix264016/asterix_website/tree/main/server/src/routes) (Other domain APIs), [`src/App.jsx`](https://github.com/team-asterix264016/asterix_website/blob/main/src/App.jsx) (Page router)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Public website"]
  node_app["Page router<br/>[App.jsx]"]
  node_intro["Intro sequence"]
  node_vehicle_scene["3D vehicle scene<br/>[Car3DCanvas.jsx]"]
  node_site_sections["Team site sections"]
  node_site_data["Website data context"]
end

subgraph group_engagement["Recruitment and engagement"]
  node_recruitment["Recruitment portal"]
  node_recruitment_briefs["Recruitment briefs"]
  node_sponsor["Sponsor inquiries<br/>[SponsorPage.jsx]"]
  node_newsletter["Newsletter signup"]
  node_workshop_page["Workshop registration<br/>[WorkshopPage.jsx]"]
end

subgraph group_admin["Content administration"]
  node_admin_dashboard["Admin dashboard<br/>[AdminDashboard.jsx]"]
  node_admin_recruitment["Recruitment admin"]
  node_admin_submissions["Submission review"]
  node_admin_workshops["Workshop administration"]
end

subgraph group_api["API and domain services"]
  node_workshop_packages["Workshop packages"]
  node_api_server["Express API<br/>[index.js]"]
  node_site_data_routes["Site data API<br/>[siteData.js]"]
  node_workshop_routes["Workshop API<br/>[workshop.js]"]
  node_domain_routes["Other domain APIs"]
  node_auth_routes["Authentication API<br/>[auth.js]"]
  node_auth_middleware["Token authorization<br/>[auth.js]"]
end

subgraph group_persistence["Persistence and integrations"]
  node_database[("MongoDB connection<br/>[mongodb.js]")]
  node_models["Domain models"]
  node_imagekit["ImageKit media service<br/>[imagekit.js]"]
  node_razorpay["Razorpay payments<br/>[razorpay.js]"]
end

node_visitor(("Site visitor"))
node_admin_user(("Admin user"))
node_payment_provider["Razorpay"]

node_visitor -->|"visits"| node_app
node_app -->|"renders"| node_intro
node_intro -->|"hands off scroll pose"| node_vehicle_scene
node_app -->|"renders"| node_site_sections
node_app -->|"provides content"| node_site_data
node_site_data -->|"fetches and saves"| node_site_data_routes
node_site_data -->|"calls API"| node_api_server
node_app -.->|"routes to"| node_recruitment
node_recruitment -->|"uses briefs"| node_recruitment_briefs
node_recruitment -.->|"submits applications"| node_domain_routes
node_visitor -.->|"sends inquiry"| node_sponsor
node_sponsor -.->|"submits inquiry"| node_domain_routes
node_visitor -.->|"subscribes"| node_newsletter
node_newsletter -.->|"submits signup"| node_domain_routes
node_visitor -->|"registers"| node_workshop_page
node_workshop_page -->|"requests registration"| node_workshop_routes
node_workshop_page -->|"reads packages"| node_workshop_packages
node_admin_user -->|"manages site"| node_admin_dashboard
node_admin_dashboard -->|"edits content"| node_site_data
node_admin_dashboard -->|"renders"| node_admin_recruitment
node_admin_dashboard -->|"opens review"| node_admin_submissions
node_admin_dashboard -->|"opens registrations"| node_admin_workshops
node_admin_dashboard -->|"uploads media"| node_domain_routes
node_api_server -->|"mounts"| node_site_data_routes
node_api_server -->|"mounts"| node_workshop_routes
node_api_server -->|"mounts"| node_domain_routes
node_api_server -->|"mounts"| node_auth_routes
node_api_server -->|"connects"| node_database
node_site_data_routes -->|"reads and writes"| node_database
node_workshop_routes -->|"reads and writes"| node_database
node_workshop_routes -->|"uses pricing"| node_workshop_packages
node_workshop_routes -->|"uses payments"| node_razorpay
node_razorpay -.->|"charges"| node_payment_provider
node_auth_routes -->|"protects routes"| node_auth_middleware
node_domain_routes -.->|"stores uploads"| node_imagekit
node_database -->|"initializes models"| node_models

click node_app "https://github.com/team-asterix264016/asterix_website/blob/main/src/App.jsx"
click node_intro "https://github.com/team-asterix264016/asterix_website/blob/main/src/components/IntroScrollSequence.jsx"
click node_vehicle_scene "https://github.com/team-asterix264016/asterix_website/blob/main/src/components/Car3DCanvas.jsx"
click node_site_sections "https://github.com/team-asterix264016/asterix_website/tree/main/src/components"
click node_site_data "https://github.com/team-asterix264016/asterix_website/blob/main/src/context/WebsiteDataContext.jsx"
click node_recruitment "https://github.com/team-asterix264016/asterix_website/blob/main/src/components/recruitment/SubmissionPortalPage.jsx"
click node_recruitment_briefs "https://github.com/team-asterix264016/asterix_website/blob/main/src/data/recruitmentProblemStatements.js"
click node_sponsor "https://github.com/team-asterix264016/asterix_website/blob/main/src/components/SponsorPage.jsx"
click node_newsletter "https://github.com/team-asterix264016/asterix_website/blob/main/src/components/CyberNewsletterCTA.jsx"
click node_workshop_page "https://github.com/team-asterix264016/asterix_website/blob/main/src/components/WorkshopPage.jsx"
click node_workshop_packages "https://github.com/team-asterix264016/asterix_website/blob/main/server/src/config/workshopPackages.js"
click node_admin_dashboard "https://github.com/team-asterix264016/asterix_website/blob/main/src/components/admin/AdminDashboard.jsx"
click node_admin_recruitment "https://github.com/team-asterix264016/asterix_website/blob/main/src/components/admin/RecruitmentAdmin.jsx"
click node_admin_submissions "https://github.com/team-asterix264016/asterix_website/blob/main/src/components/admin/SubmissionsAdmin.jsx"
click node_admin_workshops "https://github.com/team-asterix264016/asterix_website/blob/main/src/components/admin/WorkshopRegistrationsAdmin.jsx"
click node_api_server "https://github.com/team-asterix264016/asterix_website/blob/main/server/src/index.js"
click node_site_data_routes "https://github.com/team-asterix264016/asterix_website/blob/main/server/src/routes/siteData.js"
click node_workshop_routes "https://github.com/team-asterix264016/asterix_website/blob/main/server/src/routes/workshop.js"
click node_domain_routes "https://github.com/team-asterix264016/asterix_website/tree/main/server/src/routes"
click node_auth_routes "https://github.com/team-asterix264016/asterix_website/blob/main/server/src/routes/auth.js"
click node_auth_middleware "https://github.com/team-asterix264016/asterix_website/blob/main/server/src/middleware/auth.js"
click node_database "https://github.com/team-asterix264016/asterix_website/blob/main/server/src/db/mongodb.js"
click node_models "https://github.com/team-asterix264016/asterix_website/tree/main/server/src/models"
click node_imagekit "https://github.com/team-asterix264016/asterix_website/blob/main/server/src/lib/imagekit.js"
click node_razorpay "https://github.com/team-asterix264016/asterix_website/blob/main/server/src/lib/razorpay.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_app,node_intro,node_vehicle_scene,node_site_sections,node_site_data,node_admin_user toneBlue
class node_recruitment,node_recruitment_briefs,node_sponsor,node_newsletter,node_workshop_page toneAmber
class node_admin_dashboard,node_admin_recruitment,node_admin_submissions,node_admin_workshops toneMint
class node_workshop_packages,node_api_server,node_site_data_routes,node_workshop_routes,node_domain_routes,node_auth_routes,node_auth_middleware toneRose
class node_database,node_models,node_imagekit,node_razorpay,node_visitor,node_payment_provider toneIndigo
```

## Components

### Public website

- [Page router](https://github.com/team-asterix264016/asterix_website/blob/main/src/App.jsx): `src/App.jsx`
- [Intro sequence](https://github.com/team-asterix264016/asterix_website/blob/main/src/components/IntroScrollSequence.jsx): `src/components/IntroScrollSequence.jsx`
- [3D vehicle scene](https://github.com/team-asterix264016/asterix_website/blob/main/src/components/Car3DCanvas.jsx): `src/components/Car3DCanvas.jsx`
- [Team site sections](https://github.com/team-asterix264016/asterix_website/tree/main/src/components): `src/components`
- [Website data context](https://github.com/team-asterix264016/asterix_website/blob/main/src/context/WebsiteDataContext.jsx): `src/context/WebsiteDataContext.jsx`

### Recruitment and engagement

- [Recruitment portal](https://github.com/team-asterix264016/asterix_website/blob/main/src/components/recruitment/SubmissionPortalPage.jsx): `src/components/recruitment/SubmissionPortalPage.jsx`
- [Recruitment briefs](https://github.com/team-asterix264016/asterix_website/blob/main/src/data/recruitmentProblemStatements.js): `src/data/recruitmentProblemStatements.js`
- [Sponsor inquiries](https://github.com/team-asterix264016/asterix_website/blob/main/src/components/SponsorPage.jsx): `src/components/SponsorPage.jsx`
- [Newsletter signup](https://github.com/team-asterix264016/asterix_website/blob/main/src/components/CyberNewsletterCTA.jsx): `src/components/CyberNewsletterCTA.jsx`
- [Workshop registration](https://github.com/team-asterix264016/asterix_website/blob/main/src/components/WorkshopPage.jsx): `src/components/WorkshopPage.jsx`

### Content administration

- [Admin dashboard](https://github.com/team-asterix264016/asterix_website/blob/main/src/components/admin/AdminDashboard.jsx): `src/components/admin/AdminDashboard.jsx`
- [Recruitment admin](https://github.com/team-asterix264016/asterix_website/blob/main/src/components/admin/RecruitmentAdmin.jsx): `src/components/admin/RecruitmentAdmin.jsx`
- [Submission review](https://github.com/team-asterix264016/asterix_website/blob/main/src/components/admin/SubmissionsAdmin.jsx): `src/components/admin/SubmissionsAdmin.jsx`
- [Workshop administration](https://github.com/team-asterix264016/asterix_website/blob/main/src/components/admin/WorkshopRegistrationsAdmin.jsx): `src/components/admin/WorkshopRegistrationsAdmin.jsx`

### API and domain services

- [Workshop packages](https://github.com/team-asterix264016/asterix_website/blob/main/server/src/config/workshopPackages.js): `server/src/config/workshopPackages.js`
- [Express API](https://github.com/team-asterix264016/asterix_website/blob/main/server/src/index.js): `server/src/index.js`
- [Site data API](https://github.com/team-asterix264016/asterix_website/blob/main/server/src/routes/siteData.js): `server/src/routes/siteData.js`
- [Workshop API](https://github.com/team-asterix264016/asterix_website/blob/main/server/src/routes/workshop.js): `server/src/routes/workshop.js`
- [Other domain APIs](https://github.com/team-asterix264016/asterix_website/tree/main/server/src/routes): `server/src/routes`
- [Authentication API](https://github.com/team-asterix264016/asterix_website/blob/main/server/src/routes/auth.js): `server/src/routes/auth.js`
- [Token authorization](https://github.com/team-asterix264016/asterix_website/blob/main/server/src/middleware/auth.js): `server/src/middleware/auth.js`

### Persistence and integrations

- [MongoDB connection](https://github.com/team-asterix264016/asterix_website/blob/main/server/src/db/mongodb.js): `server/src/db/mongodb.js`
- [Domain models](https://github.com/team-asterix264016/asterix_website/tree/main/server/src/models): `server/src/models`
- [ImageKit media service](https://github.com/team-asterix264016/asterix_website/blob/main/server/src/lib/imagekit.js): `server/src/lib/imagekit.js`
- [Razorpay payments](https://github.com/team-asterix264016/asterix_website/blob/main/server/src/lib/razorpay.js): `server/src/lib/razorpay.js`

### Other components

- **Site visitor**
- **Admin user**
- **Razorpay**

## Connections

- Site visitor → Page router: visits (evidence: `README.md`)
- Page router → Intro sequence: renders (evidence: `src/App.jsx`)
- Intro sequence → 3D vehicle scene: hands off scroll pose (evidence: `README.md`)
- Page router → Team site sections: renders (evidence: `src/App.jsx`)
- Page router → Website data context: provides content (evidence: `src/App.jsx`)
- Website data context → Site data API: fetches and saves (evidence: `src/context/WebsiteDataContext.jsx`)
- Website data context → Express API: calls API (evidence: `README.md`)
- Page router → Recruitment portal: routes to
- Recruitment portal → Recruitment briefs: uses briefs (evidence: `src/components/recruitment/SubmissionPortalPage.jsx`)
- Recruitment portal → Other domain APIs: submits applications
- Site visitor → Sponsor inquiries: sends inquiry
- Sponsor inquiries → Other domain APIs: submits inquiry
- Site visitor → Newsletter signup: subscribes
- Newsletter signup → Other domain APIs: submits signup
- Site visitor → Workshop registration: registers (evidence: `README.md`)
- Workshop registration → Workshop API: requests registration (evidence: `src/components/WorkshopPage.jsx`)
- Workshop registration → Workshop packages: reads packages (evidence: `src/components/WorkshopPage.jsx`)
- Admin user → Admin dashboard: manages site (evidence: `README.md`)
- Admin dashboard → Website data context: edits content (evidence: `src/components/admin/AdminDashboard.jsx`)
- Admin dashboard → Recruitment admin: renders (evidence: `src/components/admin/AdminDashboard.jsx`)
- Admin dashboard → Submission review: opens review (evidence: `src/components/admin/AdminDashboard.jsx`)
- Admin dashboard → Workshop administration: opens registrations (evidence: `src/components/admin/AdminDashboard.jsx`)
- Admin dashboard → Other domain APIs: uploads media (evidence: `src/components/admin/AdminDashboard.jsx`)
- Express API → Site data API: mounts (evidence: `server/src/index.js`)
- Express API → Workshop API: mounts (evidence: `server/src/index.js`)
- Express API → Other domain APIs: mounts (evidence: `server/src/index.js`)
- Express API → Authentication API: mounts (evidence: `server/src/index.js`)
- Express API → MongoDB connection: connects (evidence: `server/src/index.js`)
- Site data API → MongoDB connection: reads and writes (evidence: `server/src/routes/siteData.js`)
- Workshop API → MongoDB connection: reads and writes (evidence: `server/src/routes/workshop.js`)
- Workshop API → Workshop packages: uses pricing (evidence: `server/src/routes/workshop.js`)
- Workshop API → Razorpay payments: uses payments (evidence: `server/src/routes/workshop.js`)
- Razorpay payments → Razorpay: charges
- Authentication API → Token authorization: protects routes (evidence: `server/src/routes/auth.js`)
- Other domain APIs → ImageKit media service: stores uploads
- MongoDB connection → Domain models: initializes models (evidence: `server/src/db/mongodb.js`)
