# ibrahimallmamun/stata architecture

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

- Interactive diagram: https://gitdiagram.com/ibrahimallmamun/stata
- Repository: https://github.com/ibrahimallmamun/stata

## Overview

STATA is a student-welfare and alumni platform. Visitors browse organizational content; members register, sign in, manage profiles and submit posts; staff administer content and communications. A distinct ASPL league supports season registration, rosters, teams and bidding. The graph reflects documented routing, API calls and storage/service references; several frontend page and backend controller details are inferred only from README capabilities and the source index, so their internal links are omitted.

Main entry points: [`frontend/src/App.tsx`](https://github.com/ibrahimallmamun/stata/blob/main/frontend/src/App.tsx) (Application router), [`frontend/src/lib/api.ts`](https://github.com/ibrahimallmamun/stata/blob/main/frontend/src/lib/api.ts) (API client), [`backend/src/routes/admin.routes.js`](https://github.com/ibrahimallmamun/stata/blob/main/backend/src/routes/admin.routes.js) (Admin routes), [`backend/src/config/database.js`](https://github.com/ibrahimallmamun/stata/blob/main/backend/src/config/database.js) (PostgreSQL via Prisma)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_spa["Application router<br/>[App.tsx]"]
  node_public_pages["Public pages"]
  node_member_pages["Member pages"]
  node_admin_pages["Admin pages"]
  node_aspl_pages["ASPL pages"]
  node_auth_context["Member auth state<br/>[AuthContext.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
end

subgraph group_api["API and identity"]
  node_api_server["Express API<br/>[index.js]"]
  node_public_routes["Public routes<br/>[public.routes.js]"]
  node_admin_routes["Admin routes<br/>[admin.routes.js]"]
  node_auth["Member authentication<br/>[auth.controller.js]"]
  node_member_middleware["Member authorization<br/>[memberAuth.js]"]
end

subgraph group_content["Community content"]
  node_content_controllers["Content and member management"]
  node_communications["Email campaigns"]
  node_email_service["Email delivery<br/>[emailService.js]"]
end

subgraph group_aspl["ASPL league"]
  node_aspl_routes["ASPL routes<br/>[aspl.routes.js]"]
  node_aspl_registration["League registration"]
  node_aspl_operations["League operations"]
end

subgraph group_infra["Data and media"]
  node_database[("PostgreSQL via Prisma<br/>[database.js]")]
  node_upload["Upload handling<br/>[upload.js]"]
  node_image_processing["Image processing<br/>[processImage.js]"]
end

node_visitor(("Visitor or member"))

node_visitor -->|"opens"| node_spa
node_spa -->|"routes to"| node_public_pages
node_spa -->|"routes to"| node_member_pages
node_spa -->|"routes to"| node_admin_pages
node_spa -->|"routes to"| node_aspl_pages
node_spa -->|"provides auth"| node_auth_context
node_auth_context -->|"calls"| node_api_client
node_public_pages -.->|"requests data"| node_api_client
node_member_pages -.->|"requests data"| node_api_client
node_admin_pages -->|"requests data"| node_api_client
node_aspl_pages -->|"requests data"| node_api_client
node_api_client -->|"sends HTTP requests"| node_api_server
node_api_server -->|"mounts"| node_public_routes
node_api_server -->|"mounts"| node_admin_routes
node_api_server -->|"mounts"| node_aspl_routes
node_public_routes -->|"routes auth requests"| node_auth
node_public_routes -->|"routes content requests"| node_content_controllers
node_admin_routes -->|"routes management requests"| node_content_controllers
node_admin_routes -->|"routes campaign requests"| node_communications
node_admin_routes -->|"applies authorization"| node_member_middleware
node_aspl_routes -->|"routes registration requests"| node_aspl_registration
node_aspl_routes -->|"routes league requests"| node_aspl_operations
node_auth -->|"reads and writes"| node_database
node_auth -->|"sends account email"| node_email_service
node_content_controllers -->|"reads and writes"| node_database
node_communications -->|"reads and writes"| node_database
node_communications -->|"uses delivery"| node_email_service
node_aspl_registration -->|"reads and writes"| node_database
node_aspl_operations -->|"uses Prisma"| node_database
node_content_controllers -->|"processes images"| node_image_processing
node_aspl_registration -->|"processes photos"| node_image_processing
node_public_routes -->|"configures uploads"| node_upload
node_admin_routes -->|"configures uploads"| node_upload
node_aspl_routes -->|"configures uploads"| node_upload

click node_spa "https://github.com/ibrahimallmamun/stata/blob/main/frontend/src/App.tsx"
click node_public_pages "https://github.com/ibrahimallmamun/stata/tree/main/frontend/src/pages"
click node_member_pages "https://github.com/ibrahimallmamun/stata/tree/main/frontend/src/pages"
click node_admin_pages "https://github.com/ibrahimallmamun/stata/tree/main/frontend/src/pages/admin"
click node_aspl_pages "https://github.com/ibrahimallmamun/stata/tree/main/frontend/src/pages/aspl"
click node_auth_context "https://github.com/ibrahimallmamun/stata/blob/main/frontend/src/contexts/AuthContext.tsx"
click node_api_client "https://github.com/ibrahimallmamun/stata/blob/main/frontend/src/lib/api.ts"
click node_api_server "https://github.com/ibrahimallmamun/stata/blob/main/backend/src/index.js"
click node_public_routes "https://github.com/ibrahimallmamun/stata/blob/main/backend/src/routes/public.routes.js"
click node_admin_routes "https://github.com/ibrahimallmamun/stata/blob/main/backend/src/routes/admin.routes.js"
click node_auth "https://github.com/ibrahimallmamun/stata/blob/main/backend/src/controllers/auth.controller.js"
click node_member_middleware "https://github.com/ibrahimallmamun/stata/blob/main/backend/src/middlewares/memberAuth.js"
click node_content_controllers "https://github.com/ibrahimallmamun/stata/tree/main/backend/src/controllers"
click node_communications "https://github.com/ibrahimallmamun/stata/blob/main/backend/src/controllers/email.controller.js"
click node_email_service "https://github.com/ibrahimallmamun/stata/blob/main/backend/src/utils/emailService.js"
click node_aspl_routes "https://github.com/ibrahimallmamun/stata/blob/main/backend/src/aspl/routes/aspl.routes.js"
click node_aspl_registration "https://github.com/ibrahimallmamun/stata/blob/main/backend/src/aspl/controllers/registration.controller.js"
click node_aspl_operations "https://github.com/ibrahimallmamun/stata/tree/main/backend/src/aspl/controllers"
click node_database "https://github.com/ibrahimallmamun/stata/blob/main/backend/src/config/database.js"
click node_upload "https://github.com/ibrahimallmamun/stata/blob/main/backend/src/config/upload.js"
click node_image_processing "https://github.com/ibrahimallmamun/stata/blob/main/backend/src/utils/processImage.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_spa,node_public_pages,node_member_pages,node_admin_pages,node_aspl_pages,node_auth_context,node_api_client toneBlue
class node_api_server,node_public_routes,node_admin_routes,node_auth,node_member_middleware toneAmber
class node_content_controllers,node_communications,node_email_service toneMint
class node_aspl_routes,node_aspl_registration,node_aspl_operations toneRose
class node_database,node_upload,node_image_processing,node_visitor toneIndigo
```

## Components

### Web experience

- [Application router](https://github.com/ibrahimallmamun/stata/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Public pages](https://github.com/ibrahimallmamun/stata/tree/main/frontend/src/pages): `frontend/src/pages`
- [Member pages](https://github.com/ibrahimallmamun/stata/tree/main/frontend/src/pages): `frontend/src/pages`
- [Admin pages](https://github.com/ibrahimallmamun/stata/tree/main/frontend/src/pages/admin): `frontend/src/pages/admin`
- [ASPL pages](https://github.com/ibrahimallmamun/stata/tree/main/frontend/src/pages/aspl): `frontend/src/pages/aspl`
- [Member auth state](https://github.com/ibrahimallmamun/stata/blob/main/frontend/src/contexts/AuthContext.tsx): `frontend/src/contexts/AuthContext.tsx`
- [API client](https://github.com/ibrahimallmamun/stata/blob/main/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`

### API and identity

- [Express API](https://github.com/ibrahimallmamun/stata/blob/main/backend/src/index.js): `backend/src/index.js`
- [Public routes](https://github.com/ibrahimallmamun/stata/blob/main/backend/src/routes/public.routes.js): `backend/src/routes/public.routes.js`
- [Admin routes](https://github.com/ibrahimallmamun/stata/blob/main/backend/src/routes/admin.routes.js): `backend/src/routes/admin.routes.js`
- [Member authentication](https://github.com/ibrahimallmamun/stata/blob/main/backend/src/controllers/auth.controller.js): `backend/src/controllers/auth.controller.js`
- [Member authorization](https://github.com/ibrahimallmamun/stata/blob/main/backend/src/middlewares/memberAuth.js): `backend/src/middlewares/memberAuth.js`

### Community content

- [Content and member management](https://github.com/ibrahimallmamun/stata/tree/main/backend/src/controllers): `backend/src/controllers`
- [Email campaigns](https://github.com/ibrahimallmamun/stata/blob/main/backend/src/controllers/email.controller.js): `backend/src/controllers/email.controller.js`
- [Email delivery](https://github.com/ibrahimallmamun/stata/blob/main/backend/src/utils/emailService.js): `backend/src/utils/emailService.js`

### ASPL league

- [ASPL routes](https://github.com/ibrahimallmamun/stata/blob/main/backend/src/aspl/routes/aspl.routes.js): `backend/src/aspl/routes/aspl.routes.js`
- [League registration](https://github.com/ibrahimallmamun/stata/blob/main/backend/src/aspl/controllers/registration.controller.js): `backend/src/aspl/controllers/registration.controller.js`
- [League operations](https://github.com/ibrahimallmamun/stata/tree/main/backend/src/aspl/controllers): `backend/src/aspl/controllers`

### Data and media

- [PostgreSQL via Prisma](https://github.com/ibrahimallmamun/stata/blob/main/backend/src/config/database.js): `backend/src/config/database.js`
- [Upload handling](https://github.com/ibrahimallmamun/stata/blob/main/backend/src/config/upload.js): `backend/src/config/upload.js`
- [Image processing](https://github.com/ibrahimallmamun/stata/blob/main/backend/src/utils/processImage.js): `backend/src/utils/processImage.js`

### Other components

- **Visitor or member**

## Connections

- Visitor or member → Application router: opens (evidence: `frontend/src/App.tsx`)
- Application router → Public pages: routes to (evidence: `frontend/src/App.tsx`)
- Application router → Member pages: routes to (evidence: `frontend/src/App.tsx`)
- Application router → Admin pages: routes to (evidence: `frontend/src/App.tsx`)
- Application router → ASPL pages: routes to (evidence: `frontend/src/App.tsx`)
- Application router → Member auth state: provides auth (evidence: `frontend/src/App.tsx`)
- Member auth state → API client: calls (evidence: `frontend/src/contexts/AuthContext.tsx`)
- Public pages → API client: requests data (evidence: `frontend/src/pages/admin/aspl/BidManager.tsx`)
- Member pages → API client: requests data (evidence: `frontend/src/pages/admin/aspl/BidManager.tsx`)
- Admin pages → API client: requests data (evidence: `frontend/src/pages/admin/Communications.tsx`)
- ASPL pages → API client: requests data (evidence: `frontend/src/pages/aspl/PlayersPage.tsx`)
- API client → Express API: sends HTTP requests (evidence: `README.md`)
- Express API → Public routes: mounts (evidence: `backend/src/index.js`)
- Express API → Admin routes: mounts (evidence: `backend/src/index.js`)
- Express API → ASPL routes: mounts (evidence: `backend/src/index.js`)
- Public routes → Member authentication: routes auth requests (evidence: `backend/src/routes/public.routes.js`)
- Public routes → Content and member management: routes content requests (evidence: `backend/src/routes/public.routes.js`)
- Admin routes → Content and member management: routes management requests (evidence: `backend/src/routes/admin.routes.js`)
- Admin routes → Email campaigns: routes campaign requests (evidence: `backend/src/routes/admin.routes.js`)
- Admin routes → Member authorization: applies authorization (evidence: `backend/src/routes/admin.routes.js`)
- ASPL routes → League registration: routes registration requests (evidence: `backend/src/aspl/routes/aspl.routes.js`)
- ASPL routes → League operations: routes league requests (evidence: `backend/src/aspl/routes/aspl.routes.js`)
- Member authentication → PostgreSQL via Prisma: reads and writes (evidence: `backend/src/controllers/auth.controller.js`)
- Member authentication → Email delivery: sends account email (evidence: `backend/src/controllers/auth.controller.js`)
- Content and member management → PostgreSQL via Prisma: reads and writes (evidence: `backend/src/controllers/post.controller.js`)
- Email campaigns → PostgreSQL via Prisma: reads and writes (evidence: `backend/src/controllers/email.controller.js`)
- Email campaigns → Email delivery: uses delivery (evidence: `backend/src/controllers/email.controller.js`)
- League registration → PostgreSQL via Prisma: reads and writes (evidence: `backend/src/aspl/controllers/registration.controller.js`)
- League operations → PostgreSQL via Prisma: uses Prisma (evidence: `backend/src/aspl/controllers/team.controller.js`)
- Content and member management → Image processing: processes images (evidence: `backend/src/controllers/post.controller.js`)
- League registration → Image processing: processes photos (evidence: `backend/src/aspl/controllers/registration.controller.js`)
- Public routes → Upload handling: configures uploads (evidence: `backend/src/routes/public.routes.js`)
- Admin routes → Upload handling: configures uploads (evidence: `backend/src/routes/admin.routes.js`)
- ASPL routes → Upload handling: configures uploads (evidence: `backend/src/aspl/routes/aspl.routes.js`)
