# hammami-ghassen/devondeck architecture

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

- Interactive diagram: https://gitdiagram.com/hammami-ghassen/devondeck
- Repository: https://github.com/hammami-ghassen/devondeck

## Overview

DevOnDeck is a marketplace connecting developers with organization-posted job offers. Organizations create and manage offers and review applicants; developers browse offers, maintain profiles, and apply. Administrators manage users. The React app routes these role-specific workflows and calls an Express API backed by MongoDB models. Client-to-server links are shown as unverified because the sampled code does not expose the page request details or a direct client/server integration declaration.

Main entry points: [`client/src/App.js`](https://github.com/hammami-ghassen/devondeck/blob/main/client/src/App.js) (Page router), [`client/src/utils/axios.js`](https://github.com/hammami-ghassen/devondeck/blob/main/client/src/utils/axios.js) (API client), [`server/server.js`](https://github.com/hammami-ghassen/devondeck/blob/main/server/server.js) (Express app), [`server/middleware/authMiddleware.js`](https://github.com/hammami-ghassen/devondeck/blob/main/server/middleware/authMiddleware.js) (JWT role checks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_app["Page router<br/>[App.js]"]
  node_authpages["Sign in / register<br/>[Register.jsx]"]
  node_offerbrowse["Offer browsing<br/>[Home.jsx]"]
  node_offerdetails["Offer details<br/>[offerDetails.jsx]"]
  node_profile["Developer profile"]
  node_createoffer["Create offer<br/>[CreateOffer.jsx]"]
  node_editoffer["Edit offer<br/>[EditOffer.jsx]"]
  node_orgdashboard["Organization dashboard"]
  node_applicants["Applicants<br/>[ApplicantsList.jsx]"]
  node_admindashboard["Admin dashboard<br/>[AdminDashboard.jsx]"]
  node_httpclient["API client<br/>[axios.js]"]
end

subgraph group_api["API workflows"]
  node_api["Express app<br/>[server.js]"]
  node_adminroutes["Admin routes<br/>[adminRoutes.js]"]
  node_admincontroller["User administration<br/>[adminController.js]"]
  node_org_routes["Organization routes<br/>[orgRoutes.js]"]
  node_orgcontroller["Offer management<br/>[orgController.js]"]
  node_offerroutes["Offer routes<br/>[offerRoutes.js]"]
  node_offercontroller["Offer operations<br/>[offerController.js]"]
  node_devroutes["Developer routes<br/>[devRoutes.js]"]
  node_devcontroller["Developer operations<br/>[devController.js]"]
  node_applicationroutes["Application routes"]
  node_applicationcontroller["Application handling"]
end

subgraph group_identity["Identity and access"]
  node_authroutes["Auth routes<br/>[authRoutes.js]"]
  node_authcontroller["Auth handling<br/>[authController.js]"]
  node_authguard["JWT role checks<br/>[authMiddleware.js]"]
end

subgraph group_data["MongoDB domain data"]
  node_user[("User records<br/>[userModel.js]")]
  node_offer[("Offer records<br/>[offerModel.js]")]
  node_application[("Applications")]
  node_database[("MongoDB connection<br/>[db.js]")]
end

node_browser(("User"))

node_browser -->|"opens"| node_app
node_app -->|"routes to"| node_authpages
node_app -->|"routes to"| node_offerbrowse
node_app -->|"routes to"| node_offerdetails
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_createoffer
node_app -->|"routes to"| node_editoffer
node_app -->|"routes to"| node_orgdashboard
node_app -->|"routes to"| node_applicants
node_app -->|"routes to"| node_admindashboard
node_authpages -->|"calls"| node_httpclient
node_offerbrowse -->|"calls"| node_httpclient
node_offerdetails -->|"calls"| node_httpclient
node_profile -->|"calls"| node_httpclient
node_createoffer -->|"calls"| node_httpclient
node_editoffer -->|"calls"| node_httpclient
node_orgdashboard -->|"calls"| node_httpclient
node_applicants -->|"calls"| node_httpclient
node_admindashboard -->|"calls"| node_httpclient
node_httpclient -.->|"requests"| node_api
node_api -->|"connects"| node_database
node_api -->|"mounts"| node_authroutes
node_api -->|"mounts"| node_adminroutes
node_api -->|"mounts"| node_org_routes
node_api -->|"mounts"| node_offerroutes
node_api -->|"mounts"| node_devroutes
node_api -->|"mounts"| node_applicationroutes
node_authroutes -->|"dispatches"| node_authcontroller
node_authroutes -->|"uses"| node_authguard
node_adminroutes -->|"dispatches"| node_admincontroller
node_adminroutes -->|"protects"| node_authguard
node_org_routes -->|"dispatches"| node_orgcontroller
node_org_routes -->|"protects"| node_authguard
node_offerroutes -->|"dispatches"| node_offercontroller
node_offerroutes -->|"protects"| node_authguard
node_devroutes -->|"dispatches"| node_devcontroller
node_applicationroutes -->|"dispatches"| node_applicationcontroller
node_applicationroutes -->|"protects"| node_authguard
node_authcontroller -->|"reads / writes"| node_user
node_authguard -->|"loads user"| node_user
node_admincontroller -->|"manages"| node_user
node_orgcontroller -->|"reads / writes"| node_offer
node_orgcontroller -->|"deletes related"| node_application
node_offercontroller -->|"uses"| node_offer
node_offercontroller -->|"uses"| node_application
node_devcontroller -->|"uses"| node_user
node_devcontroller -->|"uses"| node_offer
node_devcontroller -->|"uses"| node_application

click node_app "https://github.com/hammami-ghassen/devondeck/blob/main/client/src/App.js"
click node_authpages "https://github.com/hammami-ghassen/devondeck/blob/main/client/src/Pages/Register.jsx"
click node_offerbrowse "https://github.com/hammami-ghassen/devondeck/blob/main/client/src/Pages/Home.jsx"
click node_offerdetails "https://github.com/hammami-ghassen/devondeck/blob/main/client/src/Pages/offerDetails.jsx"
click node_profile "https://github.com/hammami-ghassen/devondeck/blob/main/client/src/Pages/DeveloperProfile.jsx"
click node_createoffer "https://github.com/hammami-ghassen/devondeck/blob/main/client/src/Pages/CreateOffer.jsx"
click node_editoffer "https://github.com/hammami-ghassen/devondeck/blob/main/client/src/Pages/EditOffer.jsx"
click node_orgdashboard "https://github.com/hammami-ghassen/devondeck/blob/main/client/src/Pages/OrganizationDashboard.jsx"
click node_applicants "https://github.com/hammami-ghassen/devondeck/blob/main/client/src/Pages/ApplicantsList.jsx"
click node_admindashboard "https://github.com/hammami-ghassen/devondeck/blob/main/client/src/Pages/AdminDashboard.jsx"
click node_api "https://github.com/hammami-ghassen/devondeck/blob/main/server/server.js"
click node_authroutes "https://github.com/hammami-ghassen/devondeck/blob/main/server/routes/authRoutes.js"
click node_authcontroller "https://github.com/hammami-ghassen/devondeck/blob/main/server/controllers/authController.js"
click node_authguard "https://github.com/hammami-ghassen/devondeck/blob/main/server/middleware/authMiddleware.js"
click node_adminroutes "https://github.com/hammami-ghassen/devondeck/blob/main/server/routes/adminRoutes.js"
click node_admincontroller "https://github.com/hammami-ghassen/devondeck/blob/main/server/controllers/adminController.js"
click node_org_routes "https://github.com/hammami-ghassen/devondeck/blob/main/server/routes/orgRoutes.js"
click node_orgcontroller "https://github.com/hammami-ghassen/devondeck/blob/main/server/controllers/orgController.js"
click node_offerroutes "https://github.com/hammami-ghassen/devondeck/blob/main/server/routes/offerRoutes.js"
click node_offercontroller "https://github.com/hammami-ghassen/devondeck/blob/main/server/controllers/offerController.js"
click node_devroutes "https://github.com/hammami-ghassen/devondeck/blob/main/server/routes/devRoutes.js"
click node_devcontroller "https://github.com/hammami-ghassen/devondeck/blob/main/server/controllers/devController.js"
click node_applicationroutes "https://github.com/hammami-ghassen/devondeck/blob/main/server/routes/applicationRoutes.js"
click node_applicationcontroller "https://github.com/hammami-ghassen/devondeck/blob/main/server/controllers/applicationController.js"
click node_user "https://github.com/hammami-ghassen/devondeck/blob/main/server/models/userModel.js"
click node_offer "https://github.com/hammami-ghassen/devondeck/blob/main/server/models/offerModel.js"
click node_application "https://github.com/hammami-ghassen/devondeck/blob/main/server/models/applicationModel.js"
click node_database "https://github.com/hammami-ghassen/devondeck/blob/main/server/config/db.js"
click node_httpclient "https://github.com/hammami-ghassen/devondeck/blob/main/client/src/utils/axios.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_authpages,node_offerbrowse,node_offerdetails,node_profile,node_createoffer,node_editoffer,node_orgdashboard,node_applicants,node_admindashboard,node_httpclient,node_browser toneBlue
class node_api,node_adminroutes,node_admincontroller,node_org_routes,node_orgcontroller,node_offerroutes,node_offercontroller,node_devroutes,node_devcontroller,node_applicationroutes,node_applicationcontroller toneAmber
class node_authroutes,node_authcontroller,node_authguard toneMint
class node_user,node_offer,node_application,node_database toneRose
```

## Components

### Web application

- [Page router](https://github.com/hammami-ghassen/devondeck/blob/main/client/src/App.js): `client/src/App.js`
- [Sign in / register](https://github.com/hammami-ghassen/devondeck/blob/main/client/src/Pages/Register.jsx): `client/src/Pages/Register.jsx`
- [Offer browsing](https://github.com/hammami-ghassen/devondeck/blob/main/client/src/Pages/Home.jsx): `client/src/Pages/Home.jsx`
- [Offer details](https://github.com/hammami-ghassen/devondeck/blob/main/client/src/Pages/offerDetails.jsx): `client/src/Pages/offerDetails.jsx`
- [Developer profile](https://github.com/hammami-ghassen/devondeck/blob/main/client/src/Pages/DeveloperProfile.jsx): `client/src/Pages/DeveloperProfile.jsx`
- [Create offer](https://github.com/hammami-ghassen/devondeck/blob/main/client/src/Pages/CreateOffer.jsx): `client/src/Pages/CreateOffer.jsx`
- [Edit offer](https://github.com/hammami-ghassen/devondeck/blob/main/client/src/Pages/EditOffer.jsx): `client/src/Pages/EditOffer.jsx`
- [Organization dashboard](https://github.com/hammami-ghassen/devondeck/blob/main/client/src/Pages/OrganizationDashboard.jsx): `client/src/Pages/OrganizationDashboard.jsx`
- [Applicants](https://github.com/hammami-ghassen/devondeck/blob/main/client/src/Pages/ApplicantsList.jsx): `client/src/Pages/ApplicantsList.jsx`
- [Admin dashboard](https://github.com/hammami-ghassen/devondeck/blob/main/client/src/Pages/AdminDashboard.jsx): `client/src/Pages/AdminDashboard.jsx`
- [API client](https://github.com/hammami-ghassen/devondeck/blob/main/client/src/utils/axios.js): `client/src/utils/axios.js`

### API workflows

- [Express app](https://github.com/hammami-ghassen/devondeck/blob/main/server/server.js): `server/server.js`
- [Admin routes](https://github.com/hammami-ghassen/devondeck/blob/main/server/routes/adminRoutes.js): `server/routes/adminRoutes.js`
- [User administration](https://github.com/hammami-ghassen/devondeck/blob/main/server/controllers/adminController.js): `server/controllers/adminController.js`
- [Organization routes](https://github.com/hammami-ghassen/devondeck/blob/main/server/routes/orgRoutes.js): `server/routes/orgRoutes.js`
- [Offer management](https://github.com/hammami-ghassen/devondeck/blob/main/server/controllers/orgController.js): `server/controllers/orgController.js`
- [Offer routes](https://github.com/hammami-ghassen/devondeck/blob/main/server/routes/offerRoutes.js): `server/routes/offerRoutes.js`
- [Offer operations](https://github.com/hammami-ghassen/devondeck/blob/main/server/controllers/offerController.js): `server/controllers/offerController.js`
- [Developer routes](https://github.com/hammami-ghassen/devondeck/blob/main/server/routes/devRoutes.js): `server/routes/devRoutes.js`
- [Developer operations](https://github.com/hammami-ghassen/devondeck/blob/main/server/controllers/devController.js): `server/controllers/devController.js`
- [Application routes](https://github.com/hammami-ghassen/devondeck/blob/main/server/routes/applicationRoutes.js): `server/routes/applicationRoutes.js`
- [Application handling](https://github.com/hammami-ghassen/devondeck/blob/main/server/controllers/applicationController.js): `server/controllers/applicationController.js`

### Identity and access

- [Auth routes](https://github.com/hammami-ghassen/devondeck/blob/main/server/routes/authRoutes.js): `server/routes/authRoutes.js`
- [Auth handling](https://github.com/hammami-ghassen/devondeck/blob/main/server/controllers/authController.js): `server/controllers/authController.js`
- [JWT role checks](https://github.com/hammami-ghassen/devondeck/blob/main/server/middleware/authMiddleware.js): `server/middleware/authMiddleware.js`

### MongoDB domain data

- [User records](https://github.com/hammami-ghassen/devondeck/blob/main/server/models/userModel.js): `server/models/userModel.js`
- [Offer records](https://github.com/hammami-ghassen/devondeck/blob/main/server/models/offerModel.js): `server/models/offerModel.js`
- [Applications](https://github.com/hammami-ghassen/devondeck/blob/main/server/models/applicationModel.js): `server/models/applicationModel.js`
- [MongoDB connection](https://github.com/hammami-ghassen/devondeck/blob/main/server/config/db.js): `server/config/db.js`

### Other components

- **User**

## Connections

- User → Page router: opens (evidence: `client/src/App.js`)
- Page router → Sign in / register: routes to (evidence: `client/src/App.js`)
- Page router → Offer browsing: routes to (evidence: `client/src/App.js`)
- Page router → Offer details: routes to (evidence: `client/src/App.js`)
- Page router → Developer profile: routes to (evidence: `client/src/App.js`)
- Page router → Create offer: routes to (evidence: `client/src/App.js`)
- Page router → Edit offer: routes to (evidence: `client/src/App.js`)
- Page router → Organization dashboard: routes to (evidence: `client/src/App.js`)
- Page router → Applicants: routes to (evidence: `client/src/App.js`)
- Page router → Admin dashboard: routes to (evidence: `client/src/App.js`)
- Sign in / register → API client: calls (evidence: `client/src/Pages/Register.jsx`)
- Offer browsing → API client: calls (evidence: `client/src/Pages/Home.jsx`)
- Offer details → API client: calls (evidence: `client/src/Pages/offerDetails.jsx`)
- Developer profile → API client: calls (evidence: `client/src/Pages/DeveloperProfile.jsx`)
- Create offer → API client: calls (evidence: `client/src/Pages/CreateOffer.jsx`)
- Edit offer → API client: calls (evidence: `client/src/Pages/EditOffer.jsx`)
- Organization dashboard → API client: calls (evidence: `client/src/Pages/OrganizationDashboard.jsx`)
- Applicants → API client: calls (evidence: `client/src/Pages/ApplicantsList.jsx`)
- Admin dashboard → API client: calls (evidence: `client/src/Pages/AdminDashboard.jsx`)
- API client → Express app: requests
- Express app → MongoDB connection: connects (evidence: `server/server.js`)
- Express app → Auth routes: mounts (evidence: `server/server.js`)
- Express app → Admin routes: mounts (evidence: `server/server.js`)
- Express app → Organization routes: mounts (evidence: `server/server.js`)
- Express app → Offer routes: mounts (evidence: `server/server.js`)
- Express app → Developer routes: mounts (evidence: `server/server.js`)
- Express app → Application routes: mounts (evidence: `server/server.js`)
- Auth routes → Auth handling: dispatches (evidence: `server/routes/authRoutes.js`)
- Auth routes → JWT role checks: uses (evidence: `server/routes/authRoutes.js`)
- Admin routes → User administration: dispatches (evidence: `server/routes/adminRoutes.js`)
- Admin routes → JWT role checks: protects (evidence: `server/routes/adminRoutes.js`)
- Organization routes → Offer management: dispatches (evidence: `server/routes/orgRoutes.js`)
- Organization routes → JWT role checks: protects (evidence: `server/routes/orgRoutes.js`)
- Offer routes → Offer operations: dispatches (evidence: `server/routes/offerRoutes.js`)
- Offer routes → JWT role checks: protects (evidence: `server/routes/offerRoutes.js`)
- Developer routes → Developer operations: dispatches (evidence: `server/routes/devRoutes.js`)
- Application routes → Application handling: dispatches (evidence: `server/routes/applicationRoutes.js`)
- Application routes → JWT role checks: protects (evidence: `server/routes/applicationRoutes.js`)
- Auth handling → User records: reads / writes (evidence: `server/controllers/authController.js`)
- JWT role checks → User records: loads user (evidence: `server/middleware/authMiddleware.js`)
- User administration → User records: manages (evidence: `server/controllers/adminController.js`)
- Offer management → Offer records: reads / writes (evidence: `server/controllers/orgController.js`)
- Offer management → Applications: deletes related (evidence: `server/controllers/orgController.js`)
- Offer operations → Offer records: uses (evidence: `server/controllers/offerController.js`)
- Offer operations → Applications: uses (evidence: `server/controllers/offerController.js`)
- Developer operations → User records: uses (evidence: `server/controllers/devController.js`)
- Developer operations → Offer records: uses (evidence: `server/controllers/devController.js`)
- Developer operations → Applications: uses (evidence: `server/controllers/devController.js`)
