# asankanaba/siaprojcet_v1.4_backend architecture

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

- Interactive diagram: https://gitdiagram.com/asankanaba/siaprojcet_v1.4_backend
- Repository: https://github.com/asankanaba/siaprojcet_v1.4_backend

## Overview

This is a PHP Smart POS and business-operations API covering sales, purchasing, inventory, finance, workforce, and administration. A principal workflow records a supplier payment: the payments endpoint stores payment state, optionally initiates PayMongo checkout, and PayMongo’s webhook later records payment events and updates related records. Other API endpoints expose distinct operational stages. The excerpts support the payment integration and several database interactions; other subsystem relationships are limited to the SOURCE INDEX, so their internal flows are not inferred.

Main entry points: [`config/database.php`](https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/config/database.php) (Database Access), [`api/payments.php`](https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/payments.php) (Payments), [`api/paymongo_webhook.php`](https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/paymongo_webhook.php) (Payment Webhook), [`api/customers.php`](https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/customers.php) (Customers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_commerce["Sales &amp; Catalog"]
  node_customers["Customers<br/>[customers.php]"]
  node_catalog["Products &amp; Categories<br/>[products.php]"]
  node_approvals["Product Approvals"]
  node_sales["Sales<br/>[sales.php]"]
end

subgraph group_procurement["Procurement &amp; Supply"]
  node_purchase["Purchasing"]
  node_supply["Supply Chain<br/>[supply_chain.php]"]
  node_requisitions["Requisitions &amp; RFQs<br/>[requisitions.php]"]
  node_supplier["Supplier Invoices"]
end

subgraph group_finance["Finance &amp; Payments"]
  node_payments["Payments<br/>[payments.php]"]
  node_webhook["Payment Webhook"]
  node_paymongo["PayMongo Client"]
  node_budgets["Budgets &amp; Approvals<br/>[budgets.php]"]
end

subgraph group_workforce["People Operations"]
  node_payroll["Payroll<br/>[payroll.php]"]
  node_payroll_process["Payroll Processing"]
  node_attendance["Attendance<br/>[attendance.php]"]
  node_jobs["Jobs<br/>[jobs.php]"]
end

subgraph group_platform["API &amp; Infrastructure"]
  node_auth["Authentication<br/>[auth.php]"]
  node_users["User Administration<br/>[users.php]"]
  node_database_config["Database Access<br/>[database.php]"]
end

node_client(("POS Client"))
node_gateway["PayMongo"]
node_db[("MySQL Database")]

node_client -->|"requests payment"| node_payments
node_payments -->|"calls"| node_paymongo
node_paymongo -->|"sends API requests"| node_gateway
node_gateway -->|"posts events"| node_webhook
node_payments -->|"reads and writes"| node_db
node_webhook -->|"updates payment records"| node_db
node_auth -->|"queries users"| node_db
node_attendance -.->|"accesses data"| node_db
node_budgets -.->|"accesses data"| node_db
node_jobs -.->|"accesses data"| node_db
node_payroll -.->|"accesses data"| node_db
node_payroll_process -.->|"accesses data"| node_db
node_approvals -.->|"accesses data"| node_db
node_catalog -.->|"accesses data"| node_db
node_purchase -.->|"accesses data"| node_db
node_sales -.->|"accesses data"| node_db
node_supply -.->|"accesses data"| node_db
node_users -.->|"accesses data"| node_db
node_customers -.->|"accesses data"| node_db
node_requisitions -.->|"accesses data"| node_db
node_supplier -.->|"accesses data"| node_db
node_payments -->|"uses connection"| node_database_config
node_webhook -->|"uses connection"| node_database_config
node_auth -->|"loads"| node_database_config
node_attendance -->|"loads"| node_database_config
node_budgets -->|"loads"| node_database_config
node_jobs -->|"loads"| node_database_config
node_payroll -->|"loads"| node_database_config
node_payroll_process -->|"loads"| node_database_config
node_approvals -->|"loads"| node_database_config
node_catalog -->|"loads"| node_database_config
node_purchase -->|"loads"| node_database_config
node_sales -->|"loads"| node_database_config
node_supply -->|"loads"| node_database_config
node_users -->|"loads"| node_database_config
node_customers -->|"loads"| node_database_config
node_requisitions -->|"loads"| node_database_config
node_supplier -->|"loads"| node_database_config
node_database_config -->|"connects"| node_db

click node_customers "https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/customers.php"
click node_catalog "https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/products.php"
click node_approvals "https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/product_approvals.php"
click node_sales "https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/sales.php"
click node_purchase "https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/purchase_orders.php"
click node_supply "https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/supply_chain.php"
click node_requisitions "https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/requisitions.php"
click node_supplier "https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/supplier_invoices.php"
click node_payments "https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/payments.php"
click node_webhook "https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/paymongo_webhook.php"
click node_paymongo "https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/_paymongo_client.php"
click node_budgets "https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/budgets.php"
click node_payroll "https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/payroll.php"
click node_payroll_process "https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/payroll_process.php"
click node_attendance "https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/attendance.php"
click node_jobs "https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/jobs.php"
click node_auth "https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/auth.php"
click node_users "https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/users.php"
click node_database_config "https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/config/database.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_customers,node_catalog,node_approvals,node_sales,node_client toneBlue
class node_purchase,node_supply,node_requisitions,node_supplier,node_db toneAmber
class node_payments,node_webhook,node_paymongo,node_budgets toneMint
class node_payroll,node_payroll_process,node_attendance,node_jobs toneRose
class node_auth,node_users,node_database_config,node_gateway toneIndigo
```

## Components

### Sales & Catalog

- [Customers](https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/customers.php): `api/customers.php`
- [Products & Categories](https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/products.php): `api/products.php`
- [Product Approvals](https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/product_approvals.php): `api/product_approvals.php`
- [Sales](https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/sales.php): `api/sales.php`

### Procurement & Supply

- [Purchasing](https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/purchase_orders.php): `api/purchase_orders.php`
- [Supply Chain](https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/supply_chain.php): `api/supply_chain.php`
- [Requisitions & RFQs](https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/requisitions.php): `api/requisitions.php`
- [Supplier Invoices](https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/supplier_invoices.php): `api/supplier_invoices.php`

### Finance & Payments

- [Payments](https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/payments.php): `api/payments.php`
- [Payment Webhook](https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/paymongo_webhook.php): `api/paymongo_webhook.php`
- [PayMongo Client](https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/_paymongo_client.php): `api/_paymongo_client.php`
- [Budgets & Approvals](https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/budgets.php): `api/budgets.php`

### People Operations

- [Payroll](https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/payroll.php): `api/payroll.php`
- [Payroll Processing](https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/payroll_process.php): `api/payroll_process.php`
- [Attendance](https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/attendance.php): `api/attendance.php`
- [Jobs](https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/jobs.php): `api/jobs.php`

### API & Infrastructure

- [Authentication](https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/auth.php): `api/auth.php`
- [User Administration](https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/api/users.php): `api/users.php`
- [Database Access](https://github.com/asankanaba/siaprojcet_v1.4_backend/blob/main/config/database.php): `config/database.php`

### Other components

- **POS Client**
- **PayMongo**
- **MySQL Database**

## Connections

- POS Client → Payments: requests payment (evidence: `api/payments.php`)
- Payments → PayMongo Client: calls (evidence: `api/payments.php`)
- PayMongo Client → PayMongo: sends API requests (evidence: `api/_paymongo_client.php`)
- PayMongo → Payment Webhook: posts events (evidence: `api/paymongo_webhook.php`)
- Payments → MySQL Database: reads and writes (evidence: `api/payments.php`)
- Payment Webhook → MySQL Database: updates payment records (evidence: `api/paymongo_webhook.php`)
- Authentication → MySQL Database: queries users (evidence: `api/auth.php`)
- Attendance → MySQL Database: accesses data
- Budgets & Approvals → MySQL Database: accesses data
- Jobs → MySQL Database: accesses data
- Payroll → MySQL Database: accesses data
- Payroll Processing → MySQL Database: accesses data
- Product Approvals → MySQL Database: accesses data
- Products & Categories → MySQL Database: accesses data
- Purchasing → MySQL Database: accesses data
- Sales → MySQL Database: accesses data
- Supply Chain → MySQL Database: accesses data
- User Administration → MySQL Database: accesses data
- Customers → MySQL Database: accesses data
- Requisitions & RFQs → MySQL Database: accesses data
- Supplier Invoices → MySQL Database: accesses data
- Payments → Database Access: uses connection (evidence: `api/payments.php`)
- Payment Webhook → Database Access: uses connection (evidence: `api/paymongo_webhook.php`)
- Authentication → Database Access: loads (evidence: `api/auth.php`)
- Attendance → Database Access: loads (evidence: `api/attendance.php`)
- Budgets & Approvals → Database Access: loads (evidence: `api/budgets.php`)
- Jobs → Database Access: loads (evidence: `api/jobs.php`)
- Payroll → Database Access: loads (evidence: `api/payroll.php`)
- Payroll Processing → Database Access: loads (evidence: `api/payroll_process.php`)
- Product Approvals → Database Access: loads (evidence: `api/product_approvals.php`)
- Products & Categories → Database Access: loads (evidence: `api/products.php`)
- Purchasing → Database Access: loads (evidence: `api/purchase_orders.php`)
- Sales → Database Access: loads (evidence: `api/sales.php`)
- Supply Chain → Database Access: loads (evidence: `api/supply_chain.php`)
- User Administration → Database Access: loads (evidence: `api/users.php`)
- Customers → Database Access: loads (evidence: `api/customers.php`)
- Requisitions & RFQs → Database Access: loads (evidence: `api/requisitions.php`)
- Supplier Invoices → Database Access: loads (evidence: `api/supplier_invoices.php`)
- Database Access → MySQL Database: connects (evidence: `config/database.php`)
