How akshitagaur-hub/student_os works
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: Dashboard.jsx Operations dashboard · main.py API application · App.jsx App routing · auth.py Authentication routes
Components 24
Web application
- App routing
frontend/src/App.jsx - Sign in / register
frontend/pages/Auth.jsx - Operations dashboard
frontend/pages/Dashboard.jsx - Authentication client
frontend/services/auth.js - HTTP API client
frontend/services/api.js - Feature API clients
frontend/services
API and access
- API application
backend/app/main.py - Authentication routes
backend/app/routers/auth.py - JWT and role guards
backend/app/dependencies.py - Feature route handlers
backend/app/routers - Business services
backend/app/services
Organization operations
- Member management
frontend/pages/Members.jsx - Event management
frontend/pages/Events.jsx - Tickets and check-in
frontend/pages/Tickets.jsx - Announcements
frontend/pages/Announcements.jsx - Financial reporting
frontend/pages/Finance.jsx
Sales and fundraising
- Fundraisers and tasks
frontend/pages/Fundraisers.jsx - Merchandise catalog
frontend/pages/Merchandise.jsx - Cart and checkout
frontend/pages/Checkout.jsx - Order tracking
frontend/pages/Orders.jsx
Data persistence
- Organization domain models
backend/app/models - Database sessions
backend/app/database.py - PostgreSQL database
Other components
- Member or admin
Connections 28
- Member or admin → App routing: uses
frontend/src/App.jsx - App routing → Sign in / register: routes to
frontend/src/App.jsx - App routing → Operations dashboard: routes to
frontend/src/App.jsx - Sign in / register → Authentication client: submits credentials
frontend/pages/Auth.jsx - Authentication client → HTTP API client: sends requests
frontend/services/auth.js - Feature API clients → HTTP API client: uses
frontend/services/auth.js - HTTP API client → API application: HTTP requests
- API application → Authentication routes: registers
backend/app/main.py - API application → Feature route handlers: registers
backend/app/main.py - Authentication routes → JWT and role guards: uses guards
backend/app/routers/auth.py - Feature route handlers → JWT and role guards: checks access
backend/app/routers/auth.py - Feature route handlers → Business services: delegates
- Business services → Organization domain models: uses domain data
backend/app/services/ticket_service.py - Authentication routes → Organization domain models: queries users
backend/app/routers/auth.py - API application → Database sessions: configures
backend/app/main.py - Database sessions → PostgreSQL database: connects
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
frontend/pages/Merchandise.jsx - Cart and checkout → Order tracking: continues to orders
- Financial reporting → Feature API clients: submits finance actions
frontend/pages/Finance.jsx - Merchandise catalog → Feature API clients: manages products
frontend/pages/Merchandise.jsx