# ammaralsalahi/final-year-project-fullstack architecture

> Architecture diagram of the GitHub repository ammaralsalahi/final-year-project-fullstack, 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/ammaralsalahi/final-year-project-fullstack
- Repository: https://github.com/ammaralsalahi/final-year-project-fullstack

## Overview

Taqsit is a customer installment-purchasing platform with a Flutter client and Laravel APIs plus merchant, bank, and admin management portals. The primary flow is product discovery, installment purchase, schedule tracking, and repayment; merchant and bank operations form separate management branches. The Flutter source files are absent from the supplied tree, so client internals are represented by its existing directory. Portal capabilities come from the README; links without source evidence are documented as unverified.

Main entry points: [`myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Models`](https://github.com/ammaralsalahi/final-year-project-fullstack/tree/main/myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Models) (Commerce and account records), [`myproject_taqsit-main/myproject_taqsit-main/taqditapp-frontend-3`](https://github.com/ammaralsalahi/final-year-project-fullstack/tree/main/myproject_taqsit-main/myproject_taqsit-main/taqditapp-frontend-3) (Flutter customer app), [`myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/ProductController.php`](https://github.com/ammaralsalahi/final-year-project-fullstack/blob/main/myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/ProductController.php) (Product catalog API), [`myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/Api/AuthController.php`](https://github.com/ammaralsalahi/final-year-project-fullstack/blob/main/myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/Api/AuthController.php) (Customer authentication API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_customer["Customer experience"]
  node_customer["Flutter customer app"]
end

subgraph group_api["Customer APIs"]
  node_catalog["Product catalog API"]
  node_authapi["Customer authentication API<br/>[AuthController.php]"]
  node_purchase["Purchase processing"]
  node_installmentapi["Installment tracking and payment"]
end

subgraph group_commerce["Commerce records"]
  node_records[("Commerce and account records")]
end

subgraph group_portals["Management portals"]
  node_merchantportal["Merchant portal"]
  node_bankportal["Bank portal<br/>[BankController.php]"]
  node_admin["Admin and user management<br/>[UserController.php]"]
  node_webpurchase["Bank dashboard operations"]
end

node_customeractor(("Customer"))
node_merchantactor(("Merchant staff"))
node_bankactor(("Bank staff"))
node_adminactor(("Administrator"))
node_database[("MySQL database")]

node_customeractor -->|"uses"| node_customer
node_customer -.->|"requests products"| node_catalog
node_customer -.->|"authenticates"| node_authapi
node_customer -.->|"submits purchase"| node_purchase
node_customer -.->|"tracks and pays"| node_installmentapi
node_catalog -->|"reads products"| node_records
node_authapi -->|"checks accounts"| node_records
node_purchase -->|"updates commerce records"| node_records
node_installmentapi -->|"reads and updates"| node_records
node_merchantactor -->|"manages sales"| node_merchantportal
node_merchantportal -->|"manages products and orders"| node_records
node_bankactor -->|"reviews financing"| node_bankportal
node_bankportal -->|"reviews applications"| node_records
node_adminactor -->|"manages users"| node_admin
node_webpurchase -->|"queries operations"| node_records
node_records -.->|"persists records"| node_database

click node_customer "https://github.com/ammaralsalahi/final-year-project-fullstack/tree/main/myproject_taqsit-main/myproject_taqsit-main/taqditapp-frontend-3"
click node_catalog "https://github.com/ammaralsalahi/final-year-project-fullstack/blob/main/myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/ProductController.php"
click node_authapi "https://github.com/ammaralsalahi/final-year-project-fullstack/blob/main/myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/Api/AuthController.php"
click node_purchase "https://github.com/ammaralsalahi/final-year-project-fullstack/blob/main/myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/PurchaseController.php"
click node_installmentapi "https://github.com/ammaralsalahi/final-year-project-fullstack/blob/main/myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/Api/InstallmentController.php"
click node_records "https://github.com/ammaralsalahi/final-year-project-fullstack/tree/main/myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Models"
click node_merchantportal "https://github.com/ammaralsalahi/final-year-project-fullstack/blob/main/myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/MerchantController.php"
click node_bankportal "https://github.com/ammaralsalahi/final-year-project-fullstack/blob/main/myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/BankController.php"
click node_admin "https://github.com/ammaralsalahi/final-year-project-fullstack/blob/main/myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/UserController.php"
click node_webpurchase "https://github.com/ammaralsalahi/final-year-project-fullstack/blob/main/myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/PurchaseController.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_customer toneBlue
class node_catalog,node_authapi,node_purchase,node_installmentapi,node_database toneAmber
class node_records toneMint
class node_merchantportal,node_bankportal,node_admin,node_webpurchase toneRose
class node_customeractor,node_merchantactor,node_bankactor,node_adminactor toneIndigo
```

## Components

### Customer experience

- [Flutter customer app](https://github.com/ammaralsalahi/final-year-project-fullstack/tree/main/myproject_taqsit-main/myproject_taqsit-main/taqditapp-frontend-3): `myproject_taqsit-main/myproject_taqsit-main/taqditapp-frontend-3`

### Customer APIs

- [Product catalog API](https://github.com/ammaralsalahi/final-year-project-fullstack/blob/main/myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/ProductController.php): `myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/ProductController.php`
- [Customer authentication API](https://github.com/ammaralsalahi/final-year-project-fullstack/blob/main/myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/Api/AuthController.php): `myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/Api/AuthController.php`
- [Purchase processing](https://github.com/ammaralsalahi/final-year-project-fullstack/blob/main/myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/PurchaseController.php): `myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/PurchaseController.php`
- [Installment tracking and payment](https://github.com/ammaralsalahi/final-year-project-fullstack/blob/main/myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/Api/InstallmentController.php): `myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/Api/InstallmentController.php`

### Commerce records

- [Commerce and account records](https://github.com/ammaralsalahi/final-year-project-fullstack/tree/main/myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Models): `myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Models`

### Management portals

- [Merchant portal](https://github.com/ammaralsalahi/final-year-project-fullstack/blob/main/myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/MerchantController.php): `myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/MerchantController.php`
- [Bank portal](https://github.com/ammaralsalahi/final-year-project-fullstack/blob/main/myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/BankController.php): `myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/BankController.php`
- [Admin and user management](https://github.com/ammaralsalahi/final-year-project-fullstack/blob/main/myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/UserController.php): `myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/UserController.php`
- [Bank dashboard operations](https://github.com/ammaralsalahi/final-year-project-fullstack/blob/main/myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/PurchaseController.php): `myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/PurchaseController.php`

### Other components

- **Customer**
- **Merchant staff**
- **Bank staff**
- **Administrator**
- **MySQL database**

## Connections

- Customer → Flutter customer app: uses
- Flutter customer app → Product catalog API: requests products
- Flutter customer app → Customer authentication API: authenticates
- Flutter customer app → Purchase processing: submits purchase
- Flutter customer app → Installment tracking and payment: tracks and pays
- Product catalog API → Commerce and account records: reads products (evidence: `myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/ProductController.php`)
- Customer authentication API → Commerce and account records: checks accounts (evidence: `myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/Api/AuthController.php`)
- Purchase processing → Commerce and account records: updates commerce records (evidence: `myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/PurchaseController.php`)
- Installment tracking and payment → Commerce and account records: reads and updates (evidence: `myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/Api/InstallmentController.php`)
- Merchant staff → Merchant portal: manages sales
- Merchant portal → Commerce and account records: manages products and orders (evidence: `myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/MerchantController.php`)
- Bank staff → Bank portal: reviews financing
- Bank portal → Commerce and account records: reviews applications (evidence: `myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/BankController.php`)
- Administrator → Admin and user management: manages users
- Bank dashboard operations → Commerce and account records: queries operations (evidence: `myproject_taqsit-main/myproject_taqsit-main/taqsit-backend-main/app/Http/Controllers/PurchaseController.php`)
- Commerce and account records → MySQL database: persists records
