# sydneyaustria4-afk/uniprocur2 architecture

> Architecture diagram of the GitHub repository sydneyaustria4-afk/uniprocur2, 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/sydneyaustria4-afk/uniprocur2
- Repository: https://github.com/sydneyaustria4-afk/uniprocur2

## Overview

UniProcur is a web-based procurement application serving buyers, managers, and suppliers. Its central workflow covers purchase requests, RFQs and quotations, purchase orders, and downstream invoice and goods-receipt activity. Manager capabilities include request and order review, reporting, audit history, settings, and support. The tree indicates broader buyer, supplier, finance, and inventory functionality, but the README is empty and most of those implementations were not sampled; those branches are shown without speculative connections.

Main entry points: [`buyerdashboard`](https://github.com/sydneyaustria4-afk/uniprocur2/tree/main/buyerdashboard) (Buyer workspace), [`database`](https://github.com/sydneyaustria4-afk/uniprocur2/tree/main/database) (Manager data APIs), [`managerdashboard`](https://github.com/sydneyaustria4-afk/uniprocur2/tree/main/managerdashboard) (Manager workspace), [`login/index.php`](https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/login/index.php) (Sign-in)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Access and sessions"]
  node_login["Sign-in<br/>[index.php]"]
  node_auth["Authentication client<br/>[auth.js]"]
  node_session["Session bootstrap"]
  node_rootbridge["Root session bridge"]
end

subgraph group_buyer["Buyer procurement"]
  node_buyerui["Buyer workspace"]
  node_request["Purchase requests"]
  node_rfq["RFQ and quotations"]
  node_orders["Purchase orders"]
  node_buyerfinance["Invoices and finance"]
  node_receipts["Goods receipts"]
end

subgraph group_manager["Manager operations"]
  node_managerui["Manager workspace"]
  node_managerrequests["Request review"]
  node_managerorders["Order review"]
  node_reports["Reports"]
  node_audit["Audit trail"]
  node_support["Support tickets"]
  node_settings["Manager settings"]
  node_managerapi["Manager API helpers"]
  node_managerapis["Manager data APIs"]
  node_dbconn["Database connection"]
end

subgraph group_extensions["Supplier and extensions"]
  node_supplier["Supplier portal"]
  node_inventory["Inventory integration"]
  node_finance["Finance integration"]
end

node_user(("Procurement user"))
node_database[("Procurement database")]

node_user -->|"signs in"| node_login
node_login -->|"loads"| node_auth
node_login -->|"starts session"| node_session
node_session -->|"syncs identity"| node_rootbridge
node_managerorders -->|"fetches orders"| node_managerapis
node_managerrequests -->|"fetches request"| node_managerapis
node_managerapis -->|"uses helpers"| node_managerapi
node_managerapis -->|"opens connection"| node_dbconn
node_managerapi -->|"starts session"| node_session
node_managerapi -.->|"authorizes requests"| node_managerapis
node_dbconn -->|"connects"| node_database
node_reports -->|"queries data"| node_database
node_audit -->|"queries events"| node_database
node_support -->|"stores tickets"| node_database
node_settings -->|"stores preferences"| node_database
node_buyerui -.->|"starts request"| node_request
node_buyerui -.->|"manages RFQs"| node_rfq
node_buyerui -.->|"manages orders"| node_orders
node_buyerui -.->|"handles invoices"| node_buyerfinance
node_buyerui -.->|"tracks receipts"| node_receipts
node_managerui -.->|"views reports"| node_reports
node_managerui -.->|"views audit"| node_audit
node_managerui -.->|"uses support"| node_support
node_managerui -.->|"updates settings"| node_settings
node_supplier -.->|"uses procurement data"| node_database
node_inventory -.->|"synchronizes receipts"| node_database
node_finance -.->|"handles invoice data"| node_database

click node_login "https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/login/index.php"
click node_auth "https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/login/auth.js"
click node_session "https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/database/uniprocur-session.php"
click node_rootbridge "https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/database/uniprocur-root-session-bridge.php"
click node_buyerui "https://github.com/sydneyaustria4-afk/uniprocur2/tree/main/buyerdashboard"
click node_request "https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/buyerdashboard/new-purchase-request.js"
click node_rfq "https://github.com/sydneyaustria4-afk/uniprocur2/tree/main/buyerdashboard"
click node_orders "https://github.com/sydneyaustria4-afk/uniprocur2/tree/main/buyerdashboard"
click node_buyerfinance "https://github.com/sydneyaustria4-afk/uniprocur2/tree/main/buyerdashboard"
click node_receipts "https://github.com/sydneyaustria4-afk/uniprocur2/tree/main/buyerdashboard"
click node_managerui "https://github.com/sydneyaustria4-afk/uniprocur2/tree/main/managerdashboard"
click node_managerrequests "https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/managerdashboard/manager-view-purchase-request.js"
click node_managerorders "https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/managerdashboard/manager-purchase-orders.js"
click node_reports "https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/database/get-manager-reports.php"
click node_audit "https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/database/get-manager-audit-trail.php"
click node_support "https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/database/manager-support-api.php"
click node_settings "https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/database/manager-settings.php"
click node_managerapi "https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/database/manager-api-common.php"
click node_managerapis "https://github.com/sydneyaustria4-afk/uniprocur2/tree/main/database"
click node_dbconn "https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/database/procurement_db_connection.php"
click node_supplier "https://github.com/sydneyaustria4-afk/uniprocur2/tree/main/supplier"
click node_inventory "https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/database/uniprocur-inventory-sync.php"
click node_finance "https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/database/finance-invoice-api.php"

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_login,node_auth,node_session,node_rootbridge,node_user toneBlue
class node_buyerui,node_request,node_rfq,node_orders,node_buyerfinance,node_receipts,node_database toneAmber
class node_managerui,node_managerrequests,node_managerorders,node_reports,node_audit,node_support,node_settings,node_managerapi,node_managerapis,node_dbconn toneMint
class node_supplier,node_inventory,node_finance toneRose
```

## Components

### Access and sessions

- [Sign-in](https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/login/index.php): `login/index.php`
- [Authentication client](https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/login/auth.js): `login/auth.js`
- [Session bootstrap](https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/database/uniprocur-session.php): `database/uniprocur-session.php`
- [Root session bridge](https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/database/uniprocur-root-session-bridge.php): `database/uniprocur-root-session-bridge.php`

### Buyer procurement

- [Buyer workspace](https://github.com/sydneyaustria4-afk/uniprocur2/tree/main/buyerdashboard): `buyerdashboard`
- [Purchase requests](https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/buyerdashboard/new-purchase-request.js): `buyerdashboard/new-purchase-request.js`
- [RFQ and quotations](https://github.com/sydneyaustria4-afk/uniprocur2/tree/main/buyerdashboard): `buyerdashboard`
- [Purchase orders](https://github.com/sydneyaustria4-afk/uniprocur2/tree/main/buyerdashboard): `buyerdashboard`
- [Invoices and finance](https://github.com/sydneyaustria4-afk/uniprocur2/tree/main/buyerdashboard): `buyerdashboard`
- [Goods receipts](https://github.com/sydneyaustria4-afk/uniprocur2/tree/main/buyerdashboard): `buyerdashboard`

### Manager operations

- [Manager workspace](https://github.com/sydneyaustria4-afk/uniprocur2/tree/main/managerdashboard): `managerdashboard`
- [Request review](https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/managerdashboard/manager-view-purchase-request.js): `managerdashboard/manager-view-purchase-request.js`
- [Order review](https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/managerdashboard/manager-purchase-orders.js): `managerdashboard/manager-purchase-orders.js`
- [Reports](https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/database/get-manager-reports.php): `database/get-manager-reports.php`
- [Audit trail](https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/database/get-manager-audit-trail.php): `database/get-manager-audit-trail.php`
- [Support tickets](https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/database/manager-support-api.php): `database/manager-support-api.php`
- [Manager settings](https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/database/manager-settings.php): `database/manager-settings.php`
- [Manager API helpers](https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/database/manager-api-common.php): `database/manager-api-common.php`
- [Manager data APIs](https://github.com/sydneyaustria4-afk/uniprocur2/tree/main/database): `database`
- [Database connection](https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/database/procurement_db_connection.php): `database/procurement_db_connection.php`

### Supplier and extensions

- [Supplier portal](https://github.com/sydneyaustria4-afk/uniprocur2/tree/main/supplier): `supplier`
- [Inventory integration](https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/database/uniprocur-inventory-sync.php): `database/uniprocur-inventory-sync.php`
- [Finance integration](https://github.com/sydneyaustria4-afk/uniprocur2/blob/main/database/finance-invoice-api.php): `database/finance-invoice-api.php`

### Other components

- **Procurement user**
- **Procurement database**

## Connections

- Procurement user → Sign-in: signs in (evidence: `login/index.php`)
- Sign-in → Authentication client: loads (evidence: `login/index.php`)
- Sign-in → Session bootstrap: starts session (evidence: `login/index.php`)
- Session bootstrap → Root session bridge: syncs identity (evidence: `database/uniprocur-session.php`)
- Order review → Manager data APIs: fetches orders (evidence: `managerdashboard/manager-purchase-orders.js`)
- Request review → Manager data APIs: fetches request (evidence: `managerdashboard/manager-view-purchase-request.js`)
- Manager data APIs → Manager API helpers: uses helpers (evidence: `database/get-manager-reports.php`)
- Manager data APIs → Database connection: opens connection (evidence: `database/get-manager-reports.php`)
- Manager API helpers → Session bootstrap: starts session (evidence: `database/manager-api-common.php`)
- Manager API helpers → Manager data APIs: authorizes requests (evidence: `database/manager-api-common.php`)
- Database connection → Procurement database: connects (evidence: `database/procurement_db_connection.php`)
- Reports → Procurement database: queries data (evidence: `database/get-manager-reports.php`)
- Audit trail → Procurement database: queries events (evidence: `database/get-manager-audit-trail.php`)
- Support tickets → Procurement database: stores tickets (evidence: `database/manager-support-api.php`)
- Manager settings → Procurement database: stores preferences (evidence: `database/manager-settings.php`)
- Buyer workspace → Purchase requests: starts request
- Buyer workspace → RFQ and quotations: manages RFQs
- Buyer workspace → Purchase orders: manages orders
- Buyer workspace → Invoices and finance: handles invoices
- Buyer workspace → Goods receipts: tracks receipts
- Manager workspace → Reports: views reports
- Manager workspace → Audit trail: views audit
- Manager workspace → Support tickets: uses support
- Manager workspace → Manager settings: updates settings
- Supplier portal → Procurement database: uses procurement data
- Inventory integration → Procurement database: synchronizes receipts
- Finance integration → Procurement database: handles invoice data
