# mustafaaltayeb5542/alzikrayat_project4_jwt architecture

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

- Interactive diagram: https://gitdiagram.com/mustafaaltayeb5542/alzikrayat_project4_jwt
- Repository: https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt

## Overview

Alzikrayat is a photo-sharing application with JWT-based accounts. Users register or log in, then browse a gallery, upload images, open photo details to comment, or delete photos they own; logout clears local credentials. The graph captures the documented UI and API capabilities, routing, authentication, data models, and upload storage. Edges reflect calls and dispatches shown in excerpts or README; unsampled page-to-API behavior is documented but not inferred as source-level calls.

Main entry points: [`client/src/api.js`](https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/client/src/api.js) (API client), [`client/src/App.jsx`](https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/client/src/App.jsx) (App routes), [`server/server.js`](https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/server/server.js) (Express API), [`server/routes/photoRoutes.js`](https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/server/routes/photoRoutes.js) (Photo routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["App routes<br/>[App.jsx]"]
  node_authpage["Account form<br/>[Auth.jsx]"]
  node_gallery["Photo gallery<br/>[Home.jsx]"]
  node_detail["Photo detail<br/>[PhotoDetail.jsx]"]
  node_upload["Upload form<br/>[Upload.jsx]"]
  node_authstate["Auth state<br/>[AuthContext.jsx]"]
  node_http["API client<br/>[api.js]"]
end

subgraph group_api["API and auth"]
  node_api_server["Express API<br/>[server.js]"]
  node_authroutes["Auth routes<br/>[authRoutes.js]"]
  node_phot_routes["Photo routes<br/>[photoRoutes.js]"]
  node_authmw["JWT middleware<br/>[authMiddleware.js]"]
  node_authctrl["Account controller<br/>[authController.js]"]
end

subgraph group_photos["Photo domain"]
  node_photctrl["Photo controller<br/>[photoController.js]"]
end

subgraph group_persistence["Data and files"]
  node_photo[("Photo records<br/>[Photo.js]")]
  node_comment[("Comment records<br/>[Comment.js]")]
  node_user[("User records<br/>[User.js]")]
  node_uploads[("Image files")]
end

node_visitor(("Visitor"))
node_browser(("Browser"))

node_visitor -->|"uses"| node_app
node_app -->|"routes to"| node_authpage
node_app -->|"routes to"| node_gallery
node_app -->|"routes to"| node_detail
node_app -->|"routes to"| node_upload
node_app -->|"checks session"| node_authstate
node_authpage -->|"calls auth"| node_authstate
node_authstate -->|"sends login"| node_http
node_authstate -->|"sends registration"| node_http
node_http -->|"HTTP requests"| node_api_server
node_http -->|"reads token"| node_browser
node_gallery -->|"fetches photos"| node_http
node_detail -->|"fetches details"| node_http
node_upload -->|"submits photo"| node_http
node_api_server -->|"mounts routes"| node_authroutes
node_api_server -->|"mounts routes"| node_phot_routes
node_authroutes -->|"dispatches"| node_authctrl
node_authroutes -->|"protects profile"| node_authmw
node_phot_routes -->|"dispatches"| node_photctrl
node_phot_routes -->|"protects writes"| node_authmw
node_authctrl -->|"reads and writes"| node_user
node_authmw -->|"loads user"| node_user
node_photctrl -->|"reads and writes"| node_photo
node_photctrl -->|"reads and writes"| node_comment
node_phot_routes -->|"stores uploads"| node_uploads
node_photctrl -->|"removes image"| node_uploads
node_api_server -->|"serves images"| node_browser

click node_app "https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/client/src/App.jsx"
click node_authpage "https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/client/src/pages/Auth.jsx"
click node_gallery "https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/client/src/pages/Home.jsx"
click node_detail "https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/client/src/pages/PhotoDetail.jsx"
click node_upload "https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/client/src/pages/Upload.jsx"
click node_authstate "https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/client/src/context/AuthContext.jsx"
click node_http "https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/client/src/api.js"
click node_api_server "https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/server/server.js"
click node_authroutes "https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/server/routes/authRoutes.js"
click node_phot_routes "https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/server/routes/photoRoutes.js"
click node_authmw "https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/server/middleware/authMiddleware.js"
click node_authctrl "https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/server/controllers/authController.js"
click node_photctrl "https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/server/controllers/photoController.js"
click node_photo "https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/server/models/Photo.js"
click node_comment "https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/server/models/Comment.js"
click node_user "https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/server/models/User.js"
click node_uploads "https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/tree/main/server/uploads"

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_authpage,node_gallery,node_detail,node_upload,node_authstate,node_http,node_browser toneBlue
class node_api_server,node_authroutes,node_phot_routes,node_authmw,node_authctrl toneAmber
class node_photctrl toneMint
class node_photo,node_comment,node_user,node_uploads toneRose
class node_visitor toneIndigo
```

## Components

### Web client

- [App routes](https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Account form](https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/client/src/pages/Auth.jsx): `client/src/pages/Auth.jsx`
- [Photo gallery](https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/client/src/pages/Home.jsx): `client/src/pages/Home.jsx`
- [Photo detail](https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/client/src/pages/PhotoDetail.jsx): `client/src/pages/PhotoDetail.jsx`
- [Upload form](https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/client/src/pages/Upload.jsx): `client/src/pages/Upload.jsx`
- [Auth state](https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`
- [API client](https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/client/src/api.js): `client/src/api.js`

### API and auth

- [Express API](https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/server/server.js): `server/server.js`
- [Auth routes](https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/server/routes/authRoutes.js): `server/routes/authRoutes.js`
- [Photo routes](https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/server/routes/photoRoutes.js): `server/routes/photoRoutes.js`
- [JWT middleware](https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/server/middleware/authMiddleware.js): `server/middleware/authMiddleware.js`
- [Account controller](https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/server/controllers/authController.js): `server/controllers/authController.js`

### Photo domain

- [Photo controller](https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/server/controllers/photoController.js): `server/controllers/photoController.js`

### Data and files

- [Photo records](https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/server/models/Photo.js): `server/models/Photo.js`
- [Comment records](https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/server/models/Comment.js): `server/models/Comment.js`
- [User records](https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/blob/main/server/models/User.js): `server/models/User.js`
- [Image files](https://github.com/mustafaaltayeb5542/alzikrayat_project4_jwt/tree/main/server/uploads): `server/uploads`

### Other components

- **Visitor**
- **Browser**

## Connections

- Visitor → App routes: uses (evidence: `README.md`)
- App routes → Account form: routes to (evidence: `client/src/App.jsx`)
- App routes → Photo gallery: routes to (evidence: `client/src/App.jsx`)
- App routes → Photo detail: routes to (evidence: `client/src/App.jsx`)
- App routes → Upload form: routes to (evidence: `client/src/App.jsx`)
- App routes → Auth state: checks session (evidence: `client/src/App.jsx`)
- Account form → Auth state: calls auth (evidence: `client/src/pages/Auth.jsx`)
- Auth state → API client: sends login (evidence: `client/src/context/AuthContext.jsx`)
- Auth state → API client: sends registration (evidence: `client/src/context/AuthContext.jsx`)
- API client → Express API: HTTP requests (evidence: `README.md`)
- API client → Browser: reads token (evidence: `client/src/api.js`)
- Photo gallery → API client: fetches photos (evidence: `client/src/pages/Home.jsx`)
- Photo detail → API client: fetches details (evidence: `client/src/pages/PhotoDetail.jsx`)
- Upload form → API client: submits photo (evidence: `client/src/pages/Upload.jsx`)
- Express API → Auth routes: mounts routes (evidence: `server/server.js`)
- Express API → Photo routes: mounts routes (evidence: `server/server.js`)
- Auth routes → Account controller: dispatches (evidence: `server/routes/authRoutes.js`)
- Auth routes → JWT middleware: protects profile (evidence: `server/routes/authRoutes.js`)
- Photo routes → Photo controller: dispatches (evidence: `server/routes/photoRoutes.js`)
- Photo routes → JWT middleware: protects writes (evidence: `server/routes/photoRoutes.js`)
- Account controller → User records: reads and writes (evidence: `server/controllers/authController.js`)
- JWT middleware → User records: loads user (evidence: `server/middleware/authMiddleware.js`)
- Photo controller → Photo records: reads and writes (evidence: `server/controllers/photoController.js`)
- Photo controller → Comment records: reads and writes (evidence: `server/controllers/photoController.js`)
- Photo routes → Image files: stores uploads (evidence: `server/routes/photoRoutes.js`)
- Photo controller → Image files: removes image (evidence: `server/controllers/photoController.js`)
- Express API → Browser: serves images (evidence: `server/server.js`)
