# saiprasad6469/online-outpass-system architecture

> Architecture diagram of the GitHub repository saiprasad6469/online-outpass-system, 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/saiprasad6469/online-outpass-system
- Repository: https://github.com/saiprasad6469/online-outpass-system

## Overview

Online Outpass System digitizes campus leave requests: students authenticate, submit requests and documents, track decisions, and review history; admins approve or reject requests, while security-facing screens support gate verification. The React app routes role-specific pages to an Express API backed by MongoDB. The sampled code confirms request submission, admin review and persistence; the README documents the wider approval/status workflow. Security and reporting screens are present in the tree, but their runtime details were not sampled.

Main entry points: [`frontend/src/App.js`](https://github.com/saiprasad6469/online-outpass-system/blob/main/frontend/src/App.js) (Role-based routing), [`backend/routes/outpassRoutes.js`](https://github.com/saiprasad6469/online-outpass-system/blob/main/backend/routes/outpassRoutes.js) (Student request API), [`frontend/src/pages`](https://github.com/saiprasad6469/online-outpass-system/tree/main/frontend/src/pages) (Student workspace), [`backend/routes/adminOutpassRoutes.js`](https://github.com/saiprasad6469/online-outpass-system/blob/main/backend/routes/adminOutpassRoutes.js) (Admin pass API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_app["Role-based routing<br/>[App.js]"]
  node_student_views["Student workspace"]
  node_apply["Apply for pass<br/>[ApplyPass.jsx]"]
  node_status["Check status<br/>[CheckStatus.jsx]"]
  node_history["Pass history<br/>[ViewHistory.jsx]"]
  node_profile["Profile modal<br/>[ProfileModal.jsx]"]
  node_admin_views["Admin dashboard<br/>[admindashboard.jsx]"]
  node_manage["Review requests"]
  node_reports["Admin reports<br/>[AdminReports.jsx]"]
end

subgraph group_api["Backend API"]
  node_server["API server<br/>[server.js]"]
  node_student_api["Student request API<br/>[outpassRoutes.js]"]
  node_admin_api["Admin pass API"]
  node_accounts_api["Account routes<br/>[authRoutes.js]"]
  node_admin_auth["Admin authorization"]
end

subgraph group_records["Accounts and records"]
  node_student_record[("Student records<br/>[Student.js]")]
  node_admin_record[("Admin records<br/>[Admin.js]")]
  node_pass_record[("Outpass records<br/>[OutPass.js]")]
end

subgraph group_gate["Gate operations"]
  node_security_views["Security workflows"]
  node_security_api["Security and guard APIs<br/>[security.routes.js]"]
end

node_student(("Student"))
node_admin(("Admin / warden"))
node_security(("Security staff"))

node_student -->|"uses"| node_app
node_admin -->|"uses"| node_app
node_security -.->|"uses"| node_app
node_app -->|"routes to"| node_student_views
node_app -->|"routes to"| node_admin_views
node_app -->|"routes to"| node_security_views
node_student_views -.->|"includes"| node_apply
node_student_views -.->|"includes"| node_status
node_student_views -.->|"includes"| node_history
node_student_views -->|"renders"| node_profile
node_admin_views -->|"routes to"| node_manage
node_admin_views -->|"routes to"| node_reports
node_apply -->|"submits request"| node_student_api
node_status -->|"reads status"| node_student_api
node_history -->|"reads history"| node_student_api
node_manage -->|"fetches and updates"| node_admin_api
node_security_views -.->|"uses"| node_security_api
node_server -->|"mounts"| node_student_api
node_server -->|"mounts"| node_admin_api
node_server -->|"mounts"| node_accounts_api
node_server -->|"mounts"| node_security_api
node_student_api -->|"reads student"| node_student_record
node_student_api -->|"creates and reads"| node_pass_record
node_admin_api -->|"protects routes"| node_admin_auth
node_admin_api -->|"reads and updates"| node_pass_record
node_admin_api -->|"reads student details"| node_student_record
node_admin_auth -->|"loads admin"| node_admin_record
node_accounts_api -->|"uses account data"| node_student_record

click node_app "https://github.com/saiprasad6469/online-outpass-system/blob/main/frontend/src/App.js"
click node_student_views "https://github.com/saiprasad6469/online-outpass-system/tree/main/frontend/src/pages"
click node_apply "https://github.com/saiprasad6469/online-outpass-system/blob/main/frontend/src/pages/ApplyPass.jsx"
click node_status "https://github.com/saiprasad6469/online-outpass-system/blob/main/frontend/src/pages/CheckStatus.jsx"
click node_history "https://github.com/saiprasad6469/online-outpass-system/blob/main/frontend/src/pages/ViewHistory.jsx"
click node_profile "https://github.com/saiprasad6469/online-outpass-system/blob/main/frontend/src/components/ProfileModal.jsx"
click node_admin_views "https://github.com/saiprasad6469/online-outpass-system/blob/main/frontend/src/pages/admindashboard.jsx"
click node_manage "https://github.com/saiprasad6469/online-outpass-system/blob/main/frontend/src/pages/AdminManageRequests.jsx"
click node_reports "https://github.com/saiprasad6469/online-outpass-system/blob/main/frontend/src/pages/AdminReports.jsx"
click node_security_views "https://github.com/saiprasad6469/online-outpass-system/tree/main/frontend/src/pages"
click node_server "https://github.com/saiprasad6469/online-outpass-system/blob/main/backend/server.js"
click node_student_api "https://github.com/saiprasad6469/online-outpass-system/blob/main/backend/routes/outpassRoutes.js"
click node_admin_api "https://github.com/saiprasad6469/online-outpass-system/blob/main/backend/routes/adminOutpassRoutes.js"
click node_accounts_api "https://github.com/saiprasad6469/online-outpass-system/blob/main/backend/routes/authRoutes.js"
click node_admin_auth "https://github.com/saiprasad6469/online-outpass-system/blob/main/backend/middleware/adminAuthMiddleware.js"
click node_student_record "https://github.com/saiprasad6469/online-outpass-system/blob/main/backend/models/Student.js"
click node_admin_record "https://github.com/saiprasad6469/online-outpass-system/blob/main/backend/models/Admin.js"
click node_pass_record "https://github.com/saiprasad6469/online-outpass-system/blob/main/backend/models/OutPass.js"
click node_security_api "https://github.com/saiprasad6469/online-outpass-system/blob/main/backend/routes/security.routes.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_student_views,node_apply,node_status,node_history,node_profile,node_admin_views,node_manage,node_reports toneBlue
class node_server,node_student_api,node_admin_api,node_accounts_api,node_admin_auth toneAmber
class node_student_record,node_admin_record,node_pass_record toneMint
class node_security_views,node_security_api toneRose
class node_student,node_admin,node_security toneIndigo
```

## Components

### Web application

- [Role-based routing](https://github.com/saiprasad6469/online-outpass-system/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Student workspace](https://github.com/saiprasad6469/online-outpass-system/tree/main/frontend/src/pages): `frontend/src/pages`
- [Apply for pass](https://github.com/saiprasad6469/online-outpass-system/blob/main/frontend/src/pages/ApplyPass.jsx): `frontend/src/pages/ApplyPass.jsx`
- [Check status](https://github.com/saiprasad6469/online-outpass-system/blob/main/frontend/src/pages/CheckStatus.jsx): `frontend/src/pages/CheckStatus.jsx`
- [Pass history](https://github.com/saiprasad6469/online-outpass-system/blob/main/frontend/src/pages/ViewHistory.jsx): `frontend/src/pages/ViewHistory.jsx`
- [Profile modal](https://github.com/saiprasad6469/online-outpass-system/blob/main/frontend/src/components/ProfileModal.jsx): `frontend/src/components/ProfileModal.jsx`
- [Admin dashboard](https://github.com/saiprasad6469/online-outpass-system/blob/main/frontend/src/pages/admindashboard.jsx): `frontend/src/pages/admindashboard.jsx`
- [Review requests](https://github.com/saiprasad6469/online-outpass-system/blob/main/frontend/src/pages/AdminManageRequests.jsx): `frontend/src/pages/AdminManageRequests.jsx`
- [Admin reports](https://github.com/saiprasad6469/online-outpass-system/blob/main/frontend/src/pages/AdminReports.jsx): `frontend/src/pages/AdminReports.jsx`

### Backend API

- [API server](https://github.com/saiprasad6469/online-outpass-system/blob/main/backend/server.js): `backend/server.js`
- [Student request API](https://github.com/saiprasad6469/online-outpass-system/blob/main/backend/routes/outpassRoutes.js): `backend/routes/outpassRoutes.js`
- [Admin pass API](https://github.com/saiprasad6469/online-outpass-system/blob/main/backend/routes/adminOutpassRoutes.js): `backend/routes/adminOutpassRoutes.js`
- [Account routes](https://github.com/saiprasad6469/online-outpass-system/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Admin authorization](https://github.com/saiprasad6469/online-outpass-system/blob/main/backend/middleware/adminAuthMiddleware.js): `backend/middleware/adminAuthMiddleware.js`

### Accounts and records

- [Student records](https://github.com/saiprasad6469/online-outpass-system/blob/main/backend/models/Student.js): `backend/models/Student.js`
- [Admin records](https://github.com/saiprasad6469/online-outpass-system/blob/main/backend/models/Admin.js): `backend/models/Admin.js`
- [Outpass records](https://github.com/saiprasad6469/online-outpass-system/blob/main/backend/models/OutPass.js): `backend/models/OutPass.js`

### Gate operations

- [Security workflows](https://github.com/saiprasad6469/online-outpass-system/tree/main/frontend/src/pages): `frontend/src/pages`
- [Security and guard APIs](https://github.com/saiprasad6469/online-outpass-system/blob/main/backend/routes/security.routes.js): `backend/routes/security.routes.js`

### Other components

- **Student**
- **Admin / warden**
- **Security staff**

## Connections

- Student → Role-based routing: uses (evidence: `README.md`)
- Admin / warden → Role-based routing: uses (evidence: `README.md`)
- Security staff → Role-based routing: uses
- Role-based routing → Student workspace: routes to (evidence: `frontend/src/App.js`)
- Role-based routing → Admin dashboard: routes to (evidence: `frontend/src/App.js`)
- Role-based routing → Security workflows: routes to (evidence: `frontend/src/App.js`)
- Student workspace → Apply for pass: includes
- Student workspace → Check status: includes
- Student workspace → Pass history: includes
- Student workspace → Profile modal: renders (evidence: `frontend/src/pages/ApplyPass.jsx`)
- Admin dashboard → Review requests: routes to (evidence: `frontend/src/App.js`)
- Admin dashboard → Admin reports: routes to (evidence: `frontend/src/App.js`)
- Apply for pass → Student request API: submits request (evidence: `README.md`)
- Check status → Student request API: reads status (evidence: `README.md`)
- Pass history → Student request API: reads history (evidence: `README.md`)
- Review requests → Admin pass API: fetches and updates (evidence: `frontend/src/pages/AdminManageRequests.jsx`)
- Security workflows → Security and guard APIs: uses
- API server → Student request API: mounts (evidence: `backend/server.js`)
- API server → Admin pass API: mounts (evidence: `backend/server.js`)
- API server → Account routes: mounts (evidence: `backend/server.js`)
- API server → Security and guard APIs: mounts (evidence: `backend/server.js`)
- Student request API → Student records: reads student (evidence: `backend/routes/outpassRoutes.js`)
- Student request API → Outpass records: creates and reads (evidence: `backend/routes/outpassRoutes.js`)
- Admin pass API → Admin authorization: protects routes (evidence: `backend/routes/adminOutpassRoutes.js`)
- Admin pass API → Outpass records: reads and updates (evidence: `backend/routes/adminOutpassRoutes.js`)
- Admin pass API → Student records: reads student details (evidence: `backend/routes/adminOutpassRoutes.js`)
- Admin authorization → Admin records: loads admin (evidence: `backend/middleware/adminAuthMiddleware.js`)
- Account routes → Student records: uses account data (evidence: `backend/routes/authRoutes.js`)
