# akshitagaur-hub/student_os architecture

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

- Interactive diagram: https://gitdiagram.com/akshitagaur-hub/student_os
- Repository: https://github.com/akshitagaur-hub/student_os

## Overview

Student OS is a role-secured student-organization management platform. Members and administrators use the React app to authenticate, then manage memberships, events and tickets, announcements, merchandise orders, fundraisers, and finances; frontend service modules communicate with the FastAPI API, whose routes and services operate on PostgreSQL-backed domain data. The sampled code confirms routing, authentication, finance UI, merchandise UI, API setup, and database configuration. Other feature branches are retained from README and repository structure; their detailed runtime calls were not sampled, so those links are dashed.

Main entry points: [`frontend/pages/Dashboard.jsx`](https://github.com/akshitagaur-hub/student_os/blob/main/frontend/pages/Dashboard.jsx) (Operations dashboard), [`backend/app/main.py`](https://github.com/akshitagaur-hub/student_os/blob/main/backend/app/main.py) (API application), [`frontend/src/App.jsx`](https://github.com/akshitagaur-hub/student_os/blob/main/frontend/src/App.jsx) (App routing), [`backend/app/routers/auth.py`](https://github.com/akshitagaur-hub/student_os/blob/main/backend/app/routers/auth.py) (Authentication routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_routing["App routing<br/>[App.jsx]"]
  node_auth_page["Sign in / register<br/>[Auth.jsx]"]
  node_dashboard["Operations dashboard<br/>[Dashboard.jsx]"]
  node_auth_service["Authentication client<br/>[auth.js]"]
  node_api_client["HTTP API client<br/>[api.js]"]
  node_domain_clients["Feature API clients"]
end

subgraph group_api["API and access"]
  node_fastapi["API application<br/>[main.py]"]
  node_auth_routes["Authentication routes<br/>[auth.py]"]
  node_access_control["JWT and role guards<br/>[dependencies.py]"]
  node_feature_routes["Feature route handlers"]
  node_business_services["Business services"]
end

subgraph group_operations["Organization operations"]
  node_member_ui["Member management<br/>[Members.jsx]"]
  node_events_ui["Event management<br/>[Events.jsx]"]
  node_tickets_ui["Tickets and check-in<br/>[Tickets.jsx]"]
  node_announcements_ui["Announcements<br/>[Announcements.jsx]"]
  node_finance_ui["Financial reporting<br/>[Finance.jsx]"]
end

subgraph group_commerce["Sales and fundraising"]
  node_fundraisers_ui["Fundraisers and tasks<br/>[Fundraisers.jsx]"]
  node_merch_ui["Merchandise catalog<br/>[Merchandise.jsx]"]
  node_cart_checkout["Cart and checkout<br/>[Checkout.jsx]"]
  node_orders_ui["Order tracking<br/>[Orders.jsx]"]
end

subgraph group_persistence["Data persistence"]
  node_domain_models["Organization domain models"]
  node_db_session["Database sessions<br/>[database.py]"]
  node_postgres[("PostgreSQL database")]
end

node_user(("Member or admin"))

node_user -->|"uses"| node_routing
node_routing -->|"routes to"| node_auth_page
node_routing -->|"routes to"| node_dashboard
node_auth_page -->|"submits credentials"| node_auth_service
node_auth_service -->|"sends requests"| node_api_client
node_domain_clients -.->|"uses"| node_api_client
node_api_client -.->|"HTTP requests"| node_fastapi
node_fastapi -->|"registers"| node_auth_routes
node_fastapi -->|"registers"| node_feature_routes
node_auth_routes -->|"uses guards"| node_access_control
node_feature_routes -.->|"checks access"| node_access_control
node_feature_routes -.->|"delegates"| node_business_services
node_business_services -.->|"uses domain data"| node_domain_models
node_auth_routes -->|"queries users"| node_domain_models
node_fastapi -->|"configures"| node_db_session
node_db_session -->|"connects"| node_postgres
node_dashboard -.->|"opens"| node_events_ui
node_dashboard -.->|"opens"| node_member_ui
node_dashboard -.->|"opens"| node_tickets_ui
node_dashboard -.->|"opens"| node_announcements_ui
node_dashboard -.->|"opens"| node_finance_ui
node_dashboard -.->|"opens"| node_fundraisers_ui
node_dashboard -.->|"opens"| node_merch_ui
node_dashboard -.->|"opens"| node_orders_ui
node_merch_ui -->|"links to cart"| node_cart_checkout
node_cart_checkout -.->|"continues to orders"| node_orders_ui
node_finance_ui -.->|"submits finance actions"| node_domain_clients
node_merch_ui -.->|"manages products"| node_domain_clients

click node_routing "https://github.com/akshitagaur-hub/student_os/blob/main/frontend/src/App.jsx"
click node_auth_page "https://github.com/akshitagaur-hub/student_os/blob/main/frontend/pages/Auth.jsx"
click node_dashboard "https://github.com/akshitagaur-hub/student_os/blob/main/frontend/pages/Dashboard.jsx"
click node_member_ui "https://github.com/akshitagaur-hub/student_os/blob/main/frontend/pages/Members.jsx"
click node_events_ui "https://github.com/akshitagaur-hub/student_os/blob/main/frontend/pages/Events.jsx"
click node_tickets_ui "https://github.com/akshitagaur-hub/student_os/blob/main/frontend/pages/Tickets.jsx"
click node_announcements_ui "https://github.com/akshitagaur-hub/student_os/blob/main/frontend/pages/Announcements.jsx"
click node_finance_ui "https://github.com/akshitagaur-hub/student_os/blob/main/frontend/pages/Finance.jsx"
click node_fundraisers_ui "https://github.com/akshitagaur-hub/student_os/blob/main/frontend/pages/Fundraisers.jsx"
click node_merch_ui "https://github.com/akshitagaur-hub/student_os/blob/main/frontend/pages/Merchandise.jsx"
click node_cart_checkout "https://github.com/akshitagaur-hub/student_os/blob/main/frontend/pages/Checkout.jsx"
click node_orders_ui "https://github.com/akshitagaur-hub/student_os/blob/main/frontend/pages/Orders.jsx"
click node_auth_service "https://github.com/akshitagaur-hub/student_os/blob/main/frontend/services/auth.js"
click node_api_client "https://github.com/akshitagaur-hub/student_os/blob/main/frontend/services/api.js"
click node_domain_clients "https://github.com/akshitagaur-hub/student_os/tree/main/frontend/services"
click node_fastapi "https://github.com/akshitagaur-hub/student_os/blob/main/backend/app/main.py"
click node_auth_routes "https://github.com/akshitagaur-hub/student_os/blob/main/backend/app/routers/auth.py"
click node_access_control "https://github.com/akshitagaur-hub/student_os/blob/main/backend/app/dependencies.py"
click node_feature_routes "https://github.com/akshitagaur-hub/student_os/tree/main/backend/app/routers"
click node_business_services "https://github.com/akshitagaur-hub/student_os/tree/main/backend/app/services"
click node_domain_models "https://github.com/akshitagaur-hub/student_os/tree/main/backend/app/models"
click node_db_session "https://github.com/akshitagaur-hub/student_os/blob/main/backend/app/database.py"

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_routing,node_auth_page,node_dashboard,node_auth_service,node_api_client,node_domain_clients toneBlue
class node_fastapi,node_auth_routes,node_access_control,node_feature_routes,node_business_services toneAmber
class node_member_ui,node_events_ui,node_tickets_ui,node_announcements_ui,node_finance_ui toneMint
class node_fundraisers_ui,node_merch_ui,node_cart_checkout,node_orders_ui toneRose
class node_domain_models,node_db_session,node_postgres,node_user toneIndigo
```

## Components

### Web application

- [App routing](https://github.com/akshitagaur-hub/student_os/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Sign in / register](https://github.com/akshitagaur-hub/student_os/blob/main/frontend/pages/Auth.jsx): `frontend/pages/Auth.jsx`
- [Operations dashboard](https://github.com/akshitagaur-hub/student_os/blob/main/frontend/pages/Dashboard.jsx): `frontend/pages/Dashboard.jsx`
- [Authentication client](https://github.com/akshitagaur-hub/student_os/blob/main/frontend/services/auth.js): `frontend/services/auth.js`
- [HTTP API client](https://github.com/akshitagaur-hub/student_os/blob/main/frontend/services/api.js): `frontend/services/api.js`
- [Feature API clients](https://github.com/akshitagaur-hub/student_os/tree/main/frontend/services): `frontend/services`

### API and access

- [API application](https://github.com/akshitagaur-hub/student_os/blob/main/backend/app/main.py): `backend/app/main.py`
- [Authentication routes](https://github.com/akshitagaur-hub/student_os/blob/main/backend/app/routers/auth.py): `backend/app/routers/auth.py`
- [JWT and role guards](https://github.com/akshitagaur-hub/student_os/blob/main/backend/app/dependencies.py): `backend/app/dependencies.py`
- [Feature route handlers](https://github.com/akshitagaur-hub/student_os/tree/main/backend/app/routers): `backend/app/routers`
- [Business services](https://github.com/akshitagaur-hub/student_os/tree/main/backend/app/services): `backend/app/services`

### Organization operations

- [Member management](https://github.com/akshitagaur-hub/student_os/blob/main/frontend/pages/Members.jsx): `frontend/pages/Members.jsx`
- [Event management](https://github.com/akshitagaur-hub/student_os/blob/main/frontend/pages/Events.jsx): `frontend/pages/Events.jsx`
- [Tickets and check-in](https://github.com/akshitagaur-hub/student_os/blob/main/frontend/pages/Tickets.jsx): `frontend/pages/Tickets.jsx`
- [Announcements](https://github.com/akshitagaur-hub/student_os/blob/main/frontend/pages/Announcements.jsx): `frontend/pages/Announcements.jsx`
- [Financial reporting](https://github.com/akshitagaur-hub/student_os/blob/main/frontend/pages/Finance.jsx): `frontend/pages/Finance.jsx`

### Sales and fundraising

- [Fundraisers and tasks](https://github.com/akshitagaur-hub/student_os/blob/main/frontend/pages/Fundraisers.jsx): `frontend/pages/Fundraisers.jsx`
- [Merchandise catalog](https://github.com/akshitagaur-hub/student_os/blob/main/frontend/pages/Merchandise.jsx): `frontend/pages/Merchandise.jsx`
- [Cart and checkout](https://github.com/akshitagaur-hub/student_os/blob/main/frontend/pages/Checkout.jsx): `frontend/pages/Checkout.jsx`
- [Order tracking](https://github.com/akshitagaur-hub/student_os/blob/main/frontend/pages/Orders.jsx): `frontend/pages/Orders.jsx`

### Data persistence

- [Organization domain models](https://github.com/akshitagaur-hub/student_os/tree/main/backend/app/models): `backend/app/models`
- [Database sessions](https://github.com/akshitagaur-hub/student_os/blob/main/backend/app/database.py): `backend/app/database.py`
- **PostgreSQL database**

### Other components

- **Member or admin**

## Connections

- Member or admin → App routing: uses (evidence: `frontend/src/App.jsx`)
- App routing → Sign in / register: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Operations dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Sign in / register → Authentication client: submits credentials (evidence: `frontend/pages/Auth.jsx`)
- Authentication client → HTTP API client: sends requests (evidence: `frontend/services/auth.js`)
- Feature API clients → HTTP API client: uses (evidence: `frontend/services/auth.js`)
- HTTP API client → API application: HTTP requests
- API application → Authentication routes: registers (evidence: `backend/app/main.py`)
- API application → Feature route handlers: registers (evidence: `backend/app/main.py`)
- Authentication routes → JWT and role guards: uses guards (evidence: `backend/app/routers/auth.py`)
- Feature route handlers → JWT and role guards: checks access (evidence: `backend/app/routers/auth.py`)
- Feature route handlers → Business services: delegates
- Business services → Organization domain models: uses domain data (evidence: `backend/app/services/ticket_service.py`)
- Authentication routes → Organization domain models: queries users (evidence: `backend/app/routers/auth.py`)
- API application → Database sessions: configures (evidence: `backend/app/main.py`)
- Database sessions → PostgreSQL database: connects (evidence: `backend/app/database.py`)
- Operations dashboard → Event management: opens
- Operations dashboard → Member management: opens
- Operations dashboard → Tickets and check-in: opens
- Operations dashboard → Announcements: opens
- Operations dashboard → Financial reporting: opens
- Operations dashboard → Fundraisers and tasks: opens
- Operations dashboard → Merchandise catalog: opens
- Operations dashboard → Order tracking: opens
- Merchandise catalog → Cart and checkout: links to cart (evidence: `frontend/pages/Merchandise.jsx`)
- Cart and checkout → Order tracking: continues to orders
- Financial reporting → Feature API clients: submits finance actions (evidence: `frontend/pages/Finance.jsx`)
- Merchandise catalog → Feature API clients: manages products (evidence: `frontend/pages/Merchandise.jsx`)
