# batoul-haidar/procurement_portal_back_end architecture

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

- Interactive diagram: https://gitdiagram.com/batoul-haidar/procurement_portal_back_end
- Repository: https://github.com/batoul-haidar/procurement_portal_back_end

## Overview

This is a Java backend for a procurement portal. Purchasers submit equipment requests; technicians review requests and create proposals, while account, catalog, request-history, approval, and notification capabilities support that workflow. The sampled code shows request creation invoking persistence, user lookup, security helpers, and notifications; DAO implementations use the connection manager. Other controllers and the notification endpoint are present in the tree, but their wiring was not sampled, so their relationships are not asserted here.

Main entry points: [`src/main/java/com/univaq/procurement_portal_back_end/controller/MakeRequestServlet.java`](https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/controller/MakeRequestServlet.java) (Submit request), [`src/main/java/com/univaq/procurement_portal_back_end/resources/NotificationService.java`](https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/resources/NotificationService.java) (Notification service), [`src/main/java/com/univaq/procurement_portal_back_end/resources/DBConnectionManager.java`](https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/resources/DBConnectionManager.java) (Connection manager), [`src/main/java/com/univaq/procurement_portal_back_end/data/model/UserDAOImp.java`](https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/data/model/UserDAOImp.java) (User storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_request_workflow["Request workflow"]
  node_make_request["Submit request"]
  node_make_proposal["Make proposal"]
  node_request_controllers["Request operations"]
  node_request_model["Purchaser requests"]
  node_proposal_model["Proposal<br/>[Proposal.java]"]
end

subgraph group_accounts["Accounts and security"]
  node_user_model["User<br/>[User.java]"]
  node_security["Session security"]
  node_login["Login<br/>[LoginServlet.java]"]
  node_user_controller["User administration"]
end

subgraph group_persistence["Persistence"]
  node_user_dao["User DAO<br/>[UserDAO.java]"]
  node_user_dao_impl["User storage<br/>[UserDAOImp.java]"]
  node_request_dao["Request DAO"]
  node_request_dao_impl["Request storage"]
  node_proposal_dao_impl["Proposal storage"]
  node_db_manager["Connection manager"]
  node_database[("Database")]
end

subgraph group_notifications["Notifications"]
  node_notification_service["Notification service"]
  node_notification_dao["Notification DAO"]
  node_notification_impl["Notification storage"]
  node_notification_model["Notification<br/>[Notification.java]"]
end

node_purchaser(("Purchaser"))

node_purchaser -->|"submits request"| node_make_request
node_make_request -->|"creates request"| node_request_dao_impl
node_make_request -->|"looks up user"| node_user_dao_impl
node_make_request -->|"checks session"| node_security
node_make_request -->|"sends notification"| node_notification_service
node_make_proposal -->|"reads request"| node_request_dao_impl
node_make_proposal -->|"stores proposal"| node_proposal_dao_impl
node_make_proposal -->|"sends notification"| node_notification_service
node_login -->|"loads account"| node_user_dao_impl
node_login -->|"starts session"| node_security
node_user_controller -.->|"manages accounts"| node_user_dao_impl
node_request_controllers -.->|"handles requests"| node_request_dao_impl
node_user_dao_impl -->|"gets connections"| node_db_manager
node_request_dao_impl -->|"gets connections"| node_db_manager
node_proposal_dao_impl -->|"gets connections"| node_db_manager
node_db_manager -->|"opens connection"| node_database
node_notification_service -->|"delegates"| node_notification_dao
node_notification_service -->|"uses implementation"| node_notification_impl
node_notification_service -->|"creates"| node_notification_model
node_notification_impl -.->|"uses connection"| node_db_manager

click node_make_request "https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/controller/MakeRequestServlet.java"
click node_make_proposal "https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/controller/MakeProposaServlet.java"
click node_request_controllers "https://github.com/batoul-haidar/procurement_portal_back_end/tree/master/src/main/java/com/univaq/procurement_portal_back_end/controller"
click node_request_model "https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/resources/PurchaserRequest.java"
click node_proposal_model "https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/resources/Proposal.java"
click node_user_model "https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/resources/User.java"
click node_security "https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/security/SecurityHelpers.java"
click node_login "https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/controller/LoginServlet.java"
click node_user_controller "https://github.com/batoul-haidar/procurement_portal_back_end/tree/master/src/main/java/com/univaq/procurement_portal_back_end/controller"
click node_user_dao "https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/data/dao/UserDAO.java"
click node_user_dao_impl "https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/data/model/UserDAOImp.java"
click node_request_dao "https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/data/dao/PurchaserReqDAO.java"
click node_request_dao_impl "https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/data/model/PurchaserReqDAOImp.java"
click node_proposal_dao_impl "https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/data/model/ProposalDAOImp.java"
click node_db_manager "https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/resources/DBConnectionManager.java"
click node_notification_service "https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/resources/NotificationService.java"
click node_notification_dao "https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/data/dao/NotificationDAO.java"
click node_notification_impl "https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/data/model/NotificationDAOImpl.java"
click node_notification_model "https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/resources/Notification.java"

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_make_request,node_make_proposal,node_request_controllers,node_request_model,node_proposal_model toneBlue
class node_user_model,node_security,node_login,node_user_controller toneAmber
class node_user_dao,node_user_dao_impl,node_request_dao,node_request_dao_impl,node_proposal_dao_impl,node_db_manager,node_database toneMint
class node_notification_service,node_notification_dao,node_notification_impl,node_notification_model toneRose
class node_purchaser toneIndigo
```

## Components

### Request workflow

- [Submit request](https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/controller/MakeRequestServlet.java): `src/main/java/com/univaq/procurement_portal_back_end/controller/MakeRequestServlet.java`
- [Make proposal](https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/controller/MakeProposaServlet.java): `src/main/java/com/univaq/procurement_portal_back_end/controller/MakeProposaServlet.java`
- [Request operations](https://github.com/batoul-haidar/procurement_portal_back_end/tree/master/src/main/java/com/univaq/procurement_portal_back_end/controller): `src/main/java/com/univaq/procurement_portal_back_end/controller`
- [Purchaser requests](https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/resources/PurchaserRequest.java): `src/main/java/com/univaq/procurement_portal_back_end/resources/PurchaserRequest.java`
- [Proposal](https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/resources/Proposal.java): `src/main/java/com/univaq/procurement_portal_back_end/resources/Proposal.java`

### Accounts and security

- [User](https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/resources/User.java): `src/main/java/com/univaq/procurement_portal_back_end/resources/User.java`
- [Session security](https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/security/SecurityHelpers.java): `src/main/java/com/univaq/procurement_portal_back_end/security/SecurityHelpers.java`
- [Login](https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/controller/LoginServlet.java): `src/main/java/com/univaq/procurement_portal_back_end/controller/LoginServlet.java`
- [User administration](https://github.com/batoul-haidar/procurement_portal_back_end/tree/master/src/main/java/com/univaq/procurement_portal_back_end/controller): `src/main/java/com/univaq/procurement_portal_back_end/controller`

### Persistence

- [User DAO](https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/data/dao/UserDAO.java): `src/main/java/com/univaq/procurement_portal_back_end/data/dao/UserDAO.java`
- [User storage](https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/data/model/UserDAOImp.java): `src/main/java/com/univaq/procurement_portal_back_end/data/model/UserDAOImp.java`
- [Request DAO](https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/data/dao/PurchaserReqDAO.java): `src/main/java/com/univaq/procurement_portal_back_end/data/dao/PurchaserReqDAO.java`
- [Request storage](https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/data/model/PurchaserReqDAOImp.java): `src/main/java/com/univaq/procurement_portal_back_end/data/model/PurchaserReqDAOImp.java`
- [Proposal storage](https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/data/model/ProposalDAOImp.java): `src/main/java/com/univaq/procurement_portal_back_end/data/model/ProposalDAOImp.java`
- [Connection manager](https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/resources/DBConnectionManager.java): `src/main/java/com/univaq/procurement_portal_back_end/resources/DBConnectionManager.java`
- **Database**

### Notifications

- [Notification service](https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/resources/NotificationService.java): `src/main/java/com/univaq/procurement_portal_back_end/resources/NotificationService.java`
- [Notification DAO](https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/data/dao/NotificationDAO.java): `src/main/java/com/univaq/procurement_portal_back_end/data/dao/NotificationDAO.java`
- [Notification storage](https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/data/model/NotificationDAOImpl.java): `src/main/java/com/univaq/procurement_portal_back_end/data/model/NotificationDAOImpl.java`
- [Notification](https://github.com/batoul-haidar/procurement_portal_back_end/blob/master/src/main/java/com/univaq/procurement_portal_back_end/resources/Notification.java): `src/main/java/com/univaq/procurement_portal_back_end/resources/Notification.java`

### Other components

- **Purchaser**

## Connections

- Purchaser → Submit request: submits request
- Submit request → Request storage: creates request (evidence: `src/main/java/com/univaq/procurement_portal_back_end/controller/MakeRequestServlet.java`)
- Submit request → User storage: looks up user (evidence: `src/main/java/com/univaq/procurement_portal_back_end/controller/MakeRequestServlet.java`)
- Submit request → Session security: checks session (evidence: `src/main/java/com/univaq/procurement_portal_back_end/controller/MakeRequestServlet.java`)
- Submit request → Notification service: sends notification (evidence: `src/main/java/com/univaq/procurement_portal_back_end/controller/MakeRequestServlet.java`)
- Make proposal → Request storage: reads request (evidence: `src/main/java/com/univaq/procurement_portal_back_end/controller/MakeProposaServlet.java`)
- Make proposal → Proposal storage: stores proposal (evidence: `src/main/java/com/univaq/procurement_portal_back_end/controller/MakeProposaServlet.java`)
- Make proposal → Notification service: sends notification (evidence: `src/main/java/com/univaq/procurement_portal_back_end/controller/MakeProposaServlet.java`)
- Login → User storage: loads account (evidence: `src/main/java/com/univaq/procurement_portal_back_end/controller/LoginServlet.java`)
- Login → Session security: starts session (evidence: `src/main/java/com/univaq/procurement_portal_back_end/controller/LoginServlet.java`)
- User administration → User storage: manages accounts (evidence: `src/main/java/com/univaq/procurement_portal_back_end/controller/LoginServlet.java`)
- Request operations → Request storage: handles requests (evidence: `src/main/java/com/univaq/procurement_portal_back_end/controller/MakeProposaServlet.java`)
- User storage → Connection manager: gets connections (evidence: `src/main/java/com/univaq/procurement_portal_back_end/data/model/UserDAOImp.java`)
- Request storage → Connection manager: gets connections (evidence: `src/main/java/com/univaq/procurement_portal_back_end/data/model/PurchaserReqDAOImp.java`)
- Proposal storage → Connection manager: gets connections (evidence: `src/main/java/com/univaq/procurement_portal_back_end/data/model/ProposalDAOImp.java`)
- Connection manager → Database: opens connection (evidence: `src/main/java/com/univaq/procurement_portal_back_end/resources/DBConnectionManager.java`)
- Notification service → Notification DAO: delegates (evidence: `src/main/java/com/univaq/procurement_portal_back_end/resources/NotificationService.java`)
- Notification service → Notification storage: uses implementation (evidence: `src/main/java/com/univaq/procurement_portal_back_end/resources/NotificationService.java`)
- Notification service → Notification: creates (evidence: `src/main/java/com/univaq/procurement_portal_back_end/resources/NotificationService.java`)
- Notification storage → Connection manager: uses connection (evidence: `src/main/java/com/univaq/procurement_portal_back_end/data/model/NotificationDAOImpl.java`)
