# atmikanayak/sidequest architecture

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

- Interactive diagram: https://gitdiagram.com/atmikanayak/sidequest
- Repository: https://github.com/atmikanayak/sidequest

## Overview

SideQuest is a student micro-task marketplace. A user signs in, discovers or posts tasks, negotiates participation, and progresses through orders; task posters manage applicants while freelancers complete work. The client also provides messaging, notifications, profiles, wallet views, and administrator tools. The server exposes Express routes whose controllers query PostgreSQL. The excerpts establish routing, task endpoints, authentication, and order/negotiation data access; several other feature areas are documented or represented in the tree but their detailed calls were not sampled.

Main entry points: [`client/src/App.jsx`](https://github.com/atmikanayak/sidequest/blob/dev/client/src/App.jsx) (React application), [`server/routes/tasks.js`](https://github.com/atmikanayak/sidequest/blob/dev/server/routes/tasks.js) (Task routes), [`server/routes/orders.js`](https://github.com/atmikanayak/sidequest/blob/dev/server/routes/orders.js) (Order routes), [`server/config/db.js`](https://github.com/atmikanayak/sidequest/blob/dev/server/config/db.js) (PostgreSQL)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Marketplace client"]
  node_webapp["React application<br/>[App.jsx]"]
  node_auth["Session and identity<br/>[AuthContext.jsx]"]
  node_settings["User settings"]
end

subgraph group_task["Task lifecycle"]
  node_task_discovery["Task discovery<br/>[Home.jsx]"]
  node_task_search["Task search<br/>[Search.jsx]"]
  node_task_post["Task posting<br/>[PostTask.jsx]"]
  node_task_manage["Task management<br/>[MyTasks.jsx]"]
  node_task_detail["Task details<br/>[TaskDetail.jsx]"]
end

subgraph group_exchange["Orders and exchange"]
  node_negotiation["Offer negotiation"]
  node_order_views["Order workflow<br/>[OrderDetail.jsx]"]
  node_wallet["Wallet<br/>[Wallet.jsx]"]
end

subgraph group_social["Community features"]
  node_messages["Messaging<br/>[MessageDetail.jsx]"]
  node_notifications["Notifications<br/>[Notifications.jsx]"]
  node_profiles["Profiles<br/>[UserProfile.jsx]"]
  node_admin["Administration<br/>[AdminTasks.jsx]"]
end

subgraph group_server["API and persistence"]
  node_api_server["Express API<br/>[server.js]"]
  node_task_routes["Task routes<br/>[tasks.js]"]
  node_task_controller["Task operations<br/>[taskController.js]"]
  node_order_routes["Order routes<br/>[orders.js]"]
  node_order_controller["Order operations<br/>[orderController.js]"]
  node_neg_routes["Negotiation routes<br/>[negotiations.js]"]
  node_neg_controller["Negotiation operations"]
  node_auth_routes["Authentication routes<br/>[auth.js]"]
  node_auth_controller["Authentication logic<br/>[authController.js]"]
  node_guard["JWT access guard<br/>[authMiddleware.js]"]
  node_postgres[("PostgreSQL<br/>[db.js]")]
  node_db_schema["Database schema setup<br/>[create_tables.js]"]
end

node_student(("Student user"))

node_student -->|"uses"| node_webapp
node_webapp -->|"checks session"| node_auth
node_webapp -->|"checks settings"| node_settings
node_webapp -->|"routes to"| node_task_discovery
node_webapp -->|"routes to"| node_task_search
node_webapp -->|"routes to"| node_task_post
node_webapp -->|"routes to"| node_task_manage
node_webapp -->|"routes to"| node_task_detail
node_webapp -->|"routes to"| node_negotiation
node_webapp -->|"routes to"| node_order_views
node_webapp -->|"routes to"| node_wallet
node_webapp -->|"routes to"| node_messages
node_webapp -->|"routes to"| node_notifications
node_webapp -->|"routes to"| node_profiles
node_webapp -->|"routes to"| node_admin
node_auth -->|"verifies session"| node_auth_routes
node_api_server -->|"mounts"| node_task_routes
node_api_server -->|"mounts"| node_order_routes
node_api_server -->|"mounts"| node_neg_routes
node_api_server -->|"mounts"| node_auth_routes
node_task_routes -->|"dispatches"| node_task_controller
node_task_routes -->|"protects endpoints"| node_guard
node_order_routes -->|"dispatches"| node_order_controller
node_order_routes -->|"protects endpoints"| node_guard
node_neg_routes -->|"dispatches"| node_neg_controller
node_neg_routes -->|"protects endpoints"| node_guard
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_routes -->|"protects endpoints"| node_guard
node_task_controller -->|"queries"| node_postgres
node_order_controller -->|"queries and updates"| node_postgres
node_neg_controller -->|"queries"| node_postgres
node_auth_controller -->|"queries"| node_postgres
node_db_schema -.->|"sets up tables"| node_postgres
node_task_manage -.->|"requests task changes"| node_task_routes
node_negotiation -.->|"uses negotiation API"| node_neg_routes
node_negotiation -.->|"creates orders"| node_order_routes
node_order_views -.->|"uses order API"| node_order_routes
node_task_discovery -.->|"browses tasks"| node_task_routes
node_task_post -.->|"submits tasks"| node_task_routes

click node_webapp "https://github.com/atmikanayak/sidequest/blob/dev/client/src/App.jsx"
click node_auth "https://github.com/atmikanayak/sidequest/blob/dev/client/src/context/AuthContext.jsx"
click node_settings "https://github.com/atmikanayak/sidequest/blob/dev/client/src/context/SettingsContext.jsx"
click node_task_discovery "https://github.com/atmikanayak/sidequest/blob/dev/client/src/pages/Home.jsx"
click node_task_search "https://github.com/atmikanayak/sidequest/blob/dev/client/src/pages/Search.jsx"
click node_task_post "https://github.com/atmikanayak/sidequest/blob/dev/client/src/pages/tasks/PostTask.jsx"
click node_task_manage "https://github.com/atmikanayak/sidequest/blob/dev/client/src/pages/tasks/MyTasks.jsx"
click node_task_detail "https://github.com/atmikanayak/sidequest/blob/dev/client/src/pages/tasks/TaskDetail.jsx"
click node_negotiation "https://github.com/atmikanayak/sidequest/blob/dev/client/src/pages/orders/TaskPosterNegotiation.jsx"
click node_order_views "https://github.com/atmikanayak/sidequest/blob/dev/client/src/pages/orders/OrderDetail.jsx"
click node_wallet "https://github.com/atmikanayak/sidequest/blob/dev/client/src/pages/wallet/Wallet.jsx"
click node_messages "https://github.com/atmikanayak/sidequest/blob/dev/client/src/pages/MessageDetail.jsx"
click node_notifications "https://github.com/atmikanayak/sidequest/blob/dev/client/src/pages/Notifications.jsx"
click node_profiles "https://github.com/atmikanayak/sidequest/blob/dev/client/src/pages/profile/UserProfile.jsx"
click node_admin "https://github.com/atmikanayak/sidequest/blob/dev/client/src/pages/admin/AdminTasks.jsx"
click node_api_server "https://github.com/atmikanayak/sidequest/blob/dev/server/server.js"
click node_task_routes "https://github.com/atmikanayak/sidequest/blob/dev/server/routes/tasks.js"
click node_task_controller "https://github.com/atmikanayak/sidequest/blob/dev/server/controllers/taskController.js"
click node_order_routes "https://github.com/atmikanayak/sidequest/blob/dev/server/routes/orders.js"
click node_order_controller "https://github.com/atmikanayak/sidequest/blob/dev/server/controllers/orderController.js"
click node_neg_routes "https://github.com/atmikanayak/sidequest/blob/dev/server/routes/negotiations.js"
click node_neg_controller "https://github.com/atmikanayak/sidequest/blob/dev/server/controllers/negotiationController.js"
click node_auth_routes "https://github.com/atmikanayak/sidequest/blob/dev/server/routes/auth.js"
click node_auth_controller "https://github.com/atmikanayak/sidequest/blob/dev/server/controllers/authController.js"
click node_guard "https://github.com/atmikanayak/sidequest/blob/dev/server/middleware/authMiddleware.js"
click node_postgres "https://github.com/atmikanayak/sidequest/blob/dev/server/config/db.js"
click node_db_schema "https://github.com/atmikanayak/sidequest/blob/dev/server/sql/create_tables.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_webapp,node_auth,node_settings,node_student toneBlue
class node_task_discovery,node_task_search,node_task_post,node_task_manage,node_task_detail toneAmber
class node_negotiation,node_order_views,node_wallet toneMint
class node_messages,node_notifications,node_profiles,node_admin toneRose
class node_api_server,node_task_routes,node_task_controller,node_order_routes,node_order_controller,node_neg_routes,node_neg_controller,node_auth_routes,node_auth_controller,node_guard,node_postgres,node_db_schema toneIndigo
```

## Components

### Marketplace client

- [React application](https://github.com/atmikanayak/sidequest/blob/dev/client/src/App.jsx): `client/src/App.jsx`
- [Session and identity](https://github.com/atmikanayak/sidequest/blob/dev/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`
- [User settings](https://github.com/atmikanayak/sidequest/blob/dev/client/src/context/SettingsContext.jsx): `client/src/context/SettingsContext.jsx`

### Task lifecycle

- [Task discovery](https://github.com/atmikanayak/sidequest/blob/dev/client/src/pages/Home.jsx): `client/src/pages/Home.jsx`
- [Task search](https://github.com/atmikanayak/sidequest/blob/dev/client/src/pages/Search.jsx): `client/src/pages/Search.jsx`
- [Task posting](https://github.com/atmikanayak/sidequest/blob/dev/client/src/pages/tasks/PostTask.jsx): `client/src/pages/tasks/PostTask.jsx`
- [Task management](https://github.com/atmikanayak/sidequest/blob/dev/client/src/pages/tasks/MyTasks.jsx): `client/src/pages/tasks/MyTasks.jsx`
- [Task details](https://github.com/atmikanayak/sidequest/blob/dev/client/src/pages/tasks/TaskDetail.jsx): `client/src/pages/tasks/TaskDetail.jsx`

### Orders and exchange

- [Offer negotiation](https://github.com/atmikanayak/sidequest/blob/dev/client/src/pages/orders/TaskPosterNegotiation.jsx): `client/src/pages/orders/TaskPosterNegotiation.jsx`
- [Order workflow](https://github.com/atmikanayak/sidequest/blob/dev/client/src/pages/orders/OrderDetail.jsx): `client/src/pages/orders/OrderDetail.jsx`
- [Wallet](https://github.com/atmikanayak/sidequest/blob/dev/client/src/pages/wallet/Wallet.jsx): `client/src/pages/wallet/Wallet.jsx`

### Community features

- [Messaging](https://github.com/atmikanayak/sidequest/blob/dev/client/src/pages/MessageDetail.jsx): `client/src/pages/MessageDetail.jsx`
- [Notifications](https://github.com/atmikanayak/sidequest/blob/dev/client/src/pages/Notifications.jsx): `client/src/pages/Notifications.jsx`
- [Profiles](https://github.com/atmikanayak/sidequest/blob/dev/client/src/pages/profile/UserProfile.jsx): `client/src/pages/profile/UserProfile.jsx`
- [Administration](https://github.com/atmikanayak/sidequest/blob/dev/client/src/pages/admin/AdminTasks.jsx): `client/src/pages/admin/AdminTasks.jsx`

### API and persistence

- [Express API](https://github.com/atmikanayak/sidequest/blob/dev/server/server.js): `server/server.js`
- [Task routes](https://github.com/atmikanayak/sidequest/blob/dev/server/routes/tasks.js): `server/routes/tasks.js`
- [Task operations](https://github.com/atmikanayak/sidequest/blob/dev/server/controllers/taskController.js): `server/controllers/taskController.js`
- [Order routes](https://github.com/atmikanayak/sidequest/blob/dev/server/routes/orders.js): `server/routes/orders.js`
- [Order operations](https://github.com/atmikanayak/sidequest/blob/dev/server/controllers/orderController.js): `server/controllers/orderController.js`
- [Negotiation routes](https://github.com/atmikanayak/sidequest/blob/dev/server/routes/negotiations.js): `server/routes/negotiations.js`
- [Negotiation operations](https://github.com/atmikanayak/sidequest/blob/dev/server/controllers/negotiationController.js): `server/controllers/negotiationController.js`
- [Authentication routes](https://github.com/atmikanayak/sidequest/blob/dev/server/routes/auth.js): `server/routes/auth.js`
- [Authentication logic](https://github.com/atmikanayak/sidequest/blob/dev/server/controllers/authController.js): `server/controllers/authController.js`
- [JWT access guard](https://github.com/atmikanayak/sidequest/blob/dev/server/middleware/authMiddleware.js): `server/middleware/authMiddleware.js`
- [PostgreSQL](https://github.com/atmikanayak/sidequest/blob/dev/server/config/db.js): `server/config/db.js`
- [Database schema setup](https://github.com/atmikanayak/sidequest/blob/dev/server/sql/create_tables.js): `server/sql/create_tables.js`

### Other components

- **Student user**

## Connections

- Student user → React application: uses
- React application → Session and identity: checks session (evidence: `client/src/App.jsx`)
- React application → User settings: checks settings (evidence: `client/src/App.jsx`)
- React application → Task discovery: routes to (evidence: `client/src/App.jsx`)
- React application → Task search: routes to (evidence: `client/src/App.jsx`)
- React application → Task posting: routes to (evidence: `client/src/App.jsx`)
- React application → Task management: routes to (evidence: `client/src/App.jsx`)
- React application → Task details: routes to (evidence: `client/src/App.jsx`)
- React application → Offer negotiation: routes to (evidence: `client/src/App.jsx`)
- React application → Order workflow: routes to (evidence: `client/src/App.jsx`)
- React application → Wallet: routes to (evidence: `client/src/App.jsx`)
- React application → Messaging: routes to (evidence: `client/src/App.jsx`)
- React application → Notifications: routes to (evidence: `client/src/App.jsx`)
- React application → Profiles: routes to (evidence: `client/src/App.jsx`)
- React application → Administration: routes to (evidence: `client/src/App.jsx`)
- Session and identity → Authentication routes: verifies session (evidence: `client/src/context/AuthContext.jsx`)
- Express API → Task routes: mounts (evidence: `server/server.js`)
- Express API → Order routes: mounts (evidence: `server/server.js`)
- Express API → Negotiation routes: mounts (evidence: `server/server.js`)
- Express API → Authentication routes: mounts (evidence: `server/server.js`)
- Task routes → Task operations: dispatches (evidence: `server/routes/tasks.js`)
- Task routes → JWT access guard: protects endpoints (evidence: `server/routes/tasks.js`)
- Order routes → Order operations: dispatches (evidence: `server/routes/orders.js`)
- Order routes → JWT access guard: protects endpoints (evidence: `server/routes/orders.js`)
- Negotiation routes → Negotiation operations: dispatches (evidence: `server/routes/negotiations.js`)
- Negotiation routes → JWT access guard: protects endpoints (evidence: `server/routes/negotiations.js`)
- Authentication routes → Authentication logic: dispatches (evidence: `server/routes/auth.js`)
- Authentication routes → JWT access guard: protects endpoints (evidence: `server/routes/auth.js`)
- Task operations → PostgreSQL: queries (evidence: `server/controllers/taskController.js`)
- Order operations → PostgreSQL: queries and updates (evidence: `server/controllers/orderController.js`)
- Negotiation operations → PostgreSQL: queries (evidence: `server/controllers/negotiationController.js`)
- Authentication logic → PostgreSQL: queries (evidence: `server/controllers/authController.js`)
- Database schema setup → PostgreSQL: sets up tables (evidence: `server/sql/create_tables.js`)
- Task management → Task routes: requests task changes
- Offer negotiation → Negotiation routes: uses negotiation API
- Offer negotiation → Order routes: creates orders
- Order workflow → Order routes: uses order API
- Task discovery → Task routes: browses tasks
- Task posting → Task routes: submits tasks
