# aimanebk/zaibak-client architecture

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

- Interactive diagram: https://gitdiagram.com/aimanebk/zaibak-client
- Repository: https://github.com/aimanebk/zaibak-client

## Overview

This is an Angular inventory-management client. A user signs in, is assigned a role, and is routed to an administrator or storekeeper workflow. Administrators manage products and related records, process purchases and returns, and access reports, invoices, and trade logs; storekeepers browse products and view details. The tree and excerpts establish the route structure and authentication flow, but sampled product components do not expose their service calls, so those links are left out. The backend is shown only where authentication explicitly makes HTTP requests.

Main entry points: [`src/app/admin/admin-routing.module.ts`](https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/admin-routing.module.ts) (Admin routes), [`src/app/app-routing.module.ts`](https://github.com/aimanebk/zaibak-client/blob/master/src/app/app-routing.module.ts) (Application routes), [`src/app/core/services/authentication.service.ts`](https://github.com/aimanebk/zaibak-client/blob/master/src/app/core/services/authentication.service.ts) (Authentication), [`src/app/storekeeper/storekeeper-routing.module.ts`](https://github.com/aimanebk/zaibak-client/blob/master/src/app/storekeeper/storekeeper-routing.module.ts) (Storekeeper routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and navigation"]
  node_auth["Authentication"]
  node_role_home["Role landing<br/>[main.component.ts]"]
  node_app_routes["Application routes"]
end

subgraph group_admin["Administration"]
  node_admin_routes["Admin routes"]
  node_product_list["Product catalog"]
  node_product_search["Product search"]
  node_product_create["Add product"]
  node_product_detail["Product details"]
  node_product_update["Update product"]
  node_product_purchase["Purchase product"]
  node_product_return["Return product"]
  node_category["Category setup"]
  node_supplier["Supplier setup"]
  node_report["Product value report"]
  node_invoice["Invoice"]
  node_trade_logs["Trade logs"]
end

subgraph group_store["Storekeeping"]
  node_store_routes["Storekeeper routes"]
  node_store_catalog["Store catalog"]
  node_store_detail["Store product details"]
end

subgraph group_core["Shared application services"]
  node_shared["Shared UI and services<br/>[shared.module.ts]"]
  node_product_services["Product and domain services"]
end

node_user(("User"))
node_auth_api{{"Authentication API"}}

node_user -->|"signs in"| node_auth
node_auth -->|"requests login and role"| node_auth_api
node_auth -->|"provides user state"| node_role_home
node_role_home -->|"navigates by role"| node_app_routes
node_app_routes -->|"guards access"| node_auth
node_app_routes -->|"loads admin area"| node_admin_routes
node_app_routes -->|"loads storekeeper area"| node_store_routes
node_admin_routes -->|"routes to"| node_product_list
node_admin_routes -->|"routes to"| node_product_create
node_admin_routes -->|"routes to"| node_product_update
node_admin_routes -->|"routes to"| node_product_detail
node_admin_routes -->|"routes to"| node_category
node_admin_routes -->|"routes to"| node_supplier
node_admin_routes -->|"routes to"| node_report
node_admin_routes -->|"routes to"| node_invoice
node_admin_routes -->|"routes to"| node_trade_logs
node_store_routes -->|"routes to"| node_store_catalog
node_store_routes -->|"routes to"| node_store_detail
node_product_list -.->|"includes search"| node_product_search
node_product_detail -.->|"offers purchase"| node_product_purchase
node_product_services -.->|"serves catalog"| node_product_list
node_shared -.->|"supports UI"| node_product_services

click node_auth "https://github.com/aimanebk/zaibak-client/blob/master/src/app/core/services/authentication.service.ts"
click node_role_home "https://github.com/aimanebk/zaibak-client/blob/master/src/app/main/main.component.ts"
click node_app_routes "https://github.com/aimanebk/zaibak-client/blob/master/src/app/app-routing.module.ts"
click node_admin_routes "https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/admin-routing.module.ts"
click node_store_routes "https://github.com/aimanebk/zaibak-client/blob/master/src/app/storekeeper/storekeeper-routing.module.ts"
click node_product_list "https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/products/admin-display-products/admin-display-products.component.ts"
click node_product_search "https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/products/admin-display-products/search-query/search-query.component.ts"
click node_product_create "https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/products/add-product/add-product.component.ts"
click node_product_detail "https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/products/admin-details-product/admin-details-product.component.ts"
click node_product_update "https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/products/admin-update-product/admin-update-product.component.ts"
click node_product_purchase "https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/products/admin-purchase-product/admin-purchase-product.component.ts"
click node_product_return "https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/products/admin-return-product/admin-return-product.component.ts"
click node_category "https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/categories/add-category/add-category.component.ts"
click node_supplier "https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/suppliers/add-supplier/add-supplier.component.ts"
click node_report "https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/reports/product-value/product-value.component.ts"
click node_invoice "https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/invoice/invoice.component.ts"
click node_trade_logs "https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/trades/trades-list/trades-list.component.ts"
click node_store_catalog "https://github.com/aimanebk/zaibak-client/blob/master/src/app/storekeeper/storekeeper-display-products/storekeeper-display-products.component.ts"
click node_store_detail "https://github.com/aimanebk/zaibak-client/blob/master/src/app/storekeeper/storekeeper-details-product/storekeeper-details-product.component.ts"
click node_shared "https://github.com/aimanebk/zaibak-client/blob/master/src/app/shared/shared.module.ts"
click node_product_services "https://github.com/aimanebk/zaibak-client/tree/master/src/app/core/services"

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_auth,node_role_home,node_app_routes,node_user toneBlue
class node_admin_routes,node_product_list,node_product_search,node_product_create,node_product_detail,node_product_update,node_product_purchase,node_product_return,node_category,node_supplier,node_report,node_invoice,node_trade_logs toneAmber
class node_store_routes,node_store_catalog,node_store_detail,node_auth_api toneMint
class node_shared,node_product_services toneRose
```

## Components

### Access and navigation

- [Authentication](https://github.com/aimanebk/zaibak-client/blob/master/src/app/core/services/authentication.service.ts): `src/app/core/services/authentication.service.ts`
- [Role landing](https://github.com/aimanebk/zaibak-client/blob/master/src/app/main/main.component.ts): `src/app/main/main.component.ts`
- [Application routes](https://github.com/aimanebk/zaibak-client/blob/master/src/app/app-routing.module.ts): `src/app/app-routing.module.ts`

### Administration

- [Admin routes](https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/admin-routing.module.ts): `src/app/admin/admin-routing.module.ts`
- [Product catalog](https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/products/admin-display-products/admin-display-products.component.ts): `src/app/admin/products/admin-display-products/admin-display-products.component.ts`
- [Product search](https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/products/admin-display-products/search-query/search-query.component.ts): `src/app/admin/products/admin-display-products/search-query/search-query.component.ts`
- [Add product](https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/products/add-product/add-product.component.ts): `src/app/admin/products/add-product/add-product.component.ts`
- [Product details](https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/products/admin-details-product/admin-details-product.component.ts): `src/app/admin/products/admin-details-product/admin-details-product.component.ts`
- [Update product](https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/products/admin-update-product/admin-update-product.component.ts): `src/app/admin/products/admin-update-product/admin-update-product.component.ts`
- [Purchase product](https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/products/admin-purchase-product/admin-purchase-product.component.ts): `src/app/admin/products/admin-purchase-product/admin-purchase-product.component.ts`
- [Return product](https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/products/admin-return-product/admin-return-product.component.ts): `src/app/admin/products/admin-return-product/admin-return-product.component.ts`
- [Category setup](https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/categories/add-category/add-category.component.ts): `src/app/admin/categories/add-category/add-category.component.ts`
- [Supplier setup](https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/suppliers/add-supplier/add-supplier.component.ts): `src/app/admin/suppliers/add-supplier/add-supplier.component.ts`
- [Product value report](https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/reports/product-value/product-value.component.ts): `src/app/admin/reports/product-value/product-value.component.ts`
- [Invoice](https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/invoice/invoice.component.ts): `src/app/admin/invoice/invoice.component.ts`
- [Trade logs](https://github.com/aimanebk/zaibak-client/blob/master/src/app/admin/trades/trades-list/trades-list.component.ts): `src/app/admin/trades/trades-list/trades-list.component.ts`

### Storekeeping

- [Storekeeper routes](https://github.com/aimanebk/zaibak-client/blob/master/src/app/storekeeper/storekeeper-routing.module.ts): `src/app/storekeeper/storekeeper-routing.module.ts`
- [Store catalog](https://github.com/aimanebk/zaibak-client/blob/master/src/app/storekeeper/storekeeper-display-products/storekeeper-display-products.component.ts): `src/app/storekeeper/storekeeper-display-products/storekeeper-display-products.component.ts`
- [Store product details](https://github.com/aimanebk/zaibak-client/blob/master/src/app/storekeeper/storekeeper-details-product/storekeeper-details-product.component.ts): `src/app/storekeeper/storekeeper-details-product/storekeeper-details-product.component.ts`

### Shared application services

- [Shared UI and services](https://github.com/aimanebk/zaibak-client/blob/master/src/app/shared/shared.module.ts): `src/app/shared/shared.module.ts`
- [Product and domain services](https://github.com/aimanebk/zaibak-client/tree/master/src/app/core/services): `src/app/core/services`

### Other components

- **User**
- **Authentication API**

## Connections

- User → Authentication: signs in (evidence: `src/app/core/services/authentication.service.ts`)
- Authentication → Authentication API: requests login and role (evidence: `src/app/core/services/authentication.service.ts`)
- Authentication → Role landing: provides user state (evidence: `src/app/main/main.component.ts`)
- Role landing → Application routes: navigates by role (evidence: `src/app/main/main.component.ts`)
- Application routes → Authentication: guards access (evidence: `src/app/app-routing.module.ts`)
- Application routes → Admin routes: loads admin area (evidence: `src/app/app-routing.module.ts`)
- Application routes → Storekeeper routes: loads storekeeper area (evidence: `src/app/app-routing.module.ts`)
- Admin routes → Product catalog: routes to (evidence: `src/app/admin/admin-routing.module.ts`)
- Admin routes → Add product: routes to (evidence: `src/app/admin/admin-routing.module.ts`)
- Admin routes → Update product: routes to (evidence: `src/app/admin/admin-routing.module.ts`)
- Admin routes → Product details: routes to (evidence: `src/app/admin/admin-routing.module.ts`)
- Admin routes → Category setup: routes to (evidence: `src/app/admin/admin-routing.module.ts`)
- Admin routes → Supplier setup: routes to (evidence: `src/app/admin/admin-routing.module.ts`)
- Admin routes → Product value report: routes to (evidence: `src/app/admin/admin-routing.module.ts`)
- Admin routes → Invoice: routes to (evidence: `src/app/admin/admin-routing.module.ts`)
- Admin routes → Trade logs: routes to (evidence: `src/app/admin/admin-routing.module.ts`)
- Storekeeper routes → Store catalog: routes to (evidence: `src/app/storekeeper/storekeeper-routing.module.ts`)
- Storekeeper routes → Store product details: routes to (evidence: `src/app/storekeeper/storekeeper-routing.module.ts`)
- Product catalog → Product search: includes search
- Product details → Purchase product: offers purchase
- Product and domain services → Product catalog: serves catalog
- Shared UI and services → Product and domain services: supports UI
