# ivankhramoy/receiving-serivce-ui architecture

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

- Interactive diagram: https://gitdiagram.com/ivankhramoy/receiving-serivce-ui
- Repository: https://github.com/ivankhramoy/receiving-serivce-ui

## Overview

This is a React warehouse receiving application, with authenticated employee access to a home dashboard, receipt work, and manager/admin ASN listing and creation. Its runtime path initializes authentication, mounts routing, and dispatches users through role-protected pages; login obtains tokens through an API and stores them for later use. The graph also preserves the ASN and receipt screens and shared list controls visible in the tree. Some page and API implementations were not excerpted, so their internal behavior and connections are not inferred.

Main entry points: [`src/app/routing/Router.jsx`](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/app/routing/Router.jsx) (Route dispatch), [`src/entities/user/model/authStore.js`](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/entities/user/model/authStore.js) (Auth state), [`src/app/App.jsx`](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/app/App.jsx) (App bootstrap), [`src/app/model/useInitAuth.js`](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/app/model/useInitAuth.js) (Auth initialization)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_entry["App entry<br/>[main.jsx]"]
  node_app["App bootstrap<br/>[App.jsx]"]
  node_router["Route dispatch<br/>[Router.jsx]"]
  node_guards["Access guards<br/>[ProtectedRoute.jsx]"]
  node_role_guard["Role guard"]
  node_layouts["Page layouts"]
  node_query_client["Query client<br/>[queryClient.js]"]
end

subgraph group_auth["Authentication"]
  node_auth_init["Auth initialization<br/>[useInitAuth.js]"]
  node_login_page["Login page<br/>[LoginPage.jsx]"]
  node_login_form["Login form<br/>[LoginForm.jsx]"]
  node_login_api["Login API<br/>[authApi.js]"]
  node_auth_api["Token refresh API<br/>[auth.js]"]
  node_auth_store["Auth state<br/>[authStore.js]"]
  node_token_storage[("Token storage<br/>[tokenStorage.js]")]
  node_jwt["JWT decoding<br/>[decodeJwt.js]"]
  node_http["HTTP client<br/>[httpClient.js]"]
  node_interceptors["Auth interceptors"]
end

subgraph group_warehouse["Warehouse workflows"]
  node_home["Home dashboard<br/>[HomePage.jsx]"]
  node_asn_list["ASN listing<br/>[AsnListPage.jsx]"]
  node_asn_create["ASN creation<br/>[CreateAsnPage.jsx]"]
  node_receipt["Receipt workflow<br/>[ReceiptPage.jsx]"]
  node_asn_api["ASN API<br/>[asnApi.js]"]
  node_asn_status["ASN statuses<br/>[asnStatus.js]"]
end

subgraph group_shared["Shared interface"]
  node_toolbar["List toolbar<br/>[Toolbar.jsx]"]
  node_search["Search input<br/>[SearchInput.jsx]"]
  node_sort["Sort dropdown<br/>[SortDropdown.jsx]"]
  node_outside_click["Outside-click hook<br/>[useOutsideClick.js]"]
  node_headers["Page headers"]
end

node_employee(("Employee"))

node_employee -->|"opens app"| node_entry
node_entry -->|"mounts"| node_app
node_entry -->|"sets up"| node_interceptors
node_app -->|"initializes auth"| node_auth_init
node_app -->|"renders"| node_router
node_app -->|"provides queries"| node_query_client
node_router -->|"routes through"| node_guards
node_router -->|"checks roles"| node_role_guard
node_router -->|"wraps pages"| node_layouts
node_router -->|"routes to"| node_login_page
node_router -->|"routes to"| node_home
node_router -->|"routes to"| node_asn_list
node_router -->|"routes to"| node_asn_create
node_router -->|"routes to"| node_receipt
node_auth_init -->|"refreshes tokens"| node_auth_api
node_auth_init -->|"updates session"| node_auth_store
node_auth_init -->|"checks expiry"| node_jwt
node_login_page -->|"renders"| node_login_form
node_login_form -->|"submits credentials"| node_login_api
node_login_form -->|"stores tokens"| node_auth_store
node_auth_store -->|"persists tokens"| node_token_storage
node_auth_store -->|"decodes claims"| node_jwt
node_http -->|"reads token"| node_token_storage
node_interceptors -->|"configures"| node_http
node_interceptors -->|"connects handlers"| node_auth_store
node_login_api -->|"sends requests"| node_http
node_auth_api -->|"sends requests"| node_http
node_router -->|"reads session"| node_auth_store
node_asn_list -->|"renders"| node_toolbar
node_toolbar -->|"renders"| node_search
node_toolbar -->|"renders"| node_sort
node_sort -->|"uses"| node_outside_click
node_layouts -->|"renders"| node_headers

click node_entry "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/main.jsx"
click node_app "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/app/App.jsx"
click node_router "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/app/routing/Router.jsx"
click node_guards "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/app/routing/ProtectedRoute.jsx"
click node_role_guard "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/app/routing/RoleProtectedRoute.jsx"
click node_layouts "https://github.com/ivankhramoy/receiving-serivce-ui/tree/main/src/app/layouts"
click node_auth_init "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/app/model/useInitAuth.js"
click node_login_page "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/pages/login/LoginPage.jsx"
click node_login_form "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/features/auth-by-login/ui/LoginForm.jsx"
click node_login_api "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/features/auth-by-login/api/authApi.js"
click node_auth_api "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/entities/user/api/auth.js"
click node_auth_store "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/entities/user/model/authStore.js"
click node_token_storage "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/shared/api/tokenStorage.js"
click node_jwt "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/shared/lib/decodeJwt.js"
click node_http "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/shared/api/httpClient.js"
click node_interceptors "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/app/providers/setupInterceptors.js"
click node_home "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/pages/home/HomePage.jsx"
click node_asn_list "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/pages/asn-list/AsnListPage.jsx"
click node_asn_create "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/pages/create-asn/CreateAsnPage.jsx"
click node_receipt "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/pages/receipt/ReceiptPage.jsx"
click node_asn_api "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/entities/asn/api/asnApi.js"
click node_asn_status "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/entities/asn/model/asnStatus.js"
click node_toolbar "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/shared/ui/Toolbar/Toolbar.jsx"
click node_search "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/shared/ui/SearchInput/SearchInput.jsx"
click node_sort "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/shared/ui/SortDropdown/SortDropdown.jsx"
click node_outside_click "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/shared/hooks/useOutsideClick.js"
click node_headers "https://github.com/ivankhramoy/receiving-serivce-ui/tree/main/src/widgets/Header"
click node_query_client "https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/app/providers/queryClient.js"

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_entry,node_app,node_router,node_guards,node_role_guard,node_layouts,node_query_client toneBlue
class node_auth_init,node_login_page,node_login_form,node_login_api,node_auth_api,node_auth_store,node_token_storage,node_jwt,node_http,node_interceptors toneAmber
class node_home,node_asn_list,node_asn_create,node_receipt,node_asn_api,node_asn_status toneMint
class node_toolbar,node_search,node_sort,node_outside_click,node_headers toneRose
class node_employee toneIndigo
```

## Components

### Application shell

- [App entry](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/main.jsx): `src/main.jsx`
- [App bootstrap](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/app/App.jsx): `src/app/App.jsx`
- [Route dispatch](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/app/routing/Router.jsx): `src/app/routing/Router.jsx`
- [Access guards](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/app/routing/ProtectedRoute.jsx): `src/app/routing/ProtectedRoute.jsx`
- [Role guard](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/app/routing/RoleProtectedRoute.jsx): `src/app/routing/RoleProtectedRoute.jsx`
- [Page layouts](https://github.com/ivankhramoy/receiving-serivce-ui/tree/main/src/app/layouts): `src/app/layouts`
- [Query client](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/app/providers/queryClient.js): `src/app/providers/queryClient.js`

### Authentication

- [Auth initialization](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/app/model/useInitAuth.js): `src/app/model/useInitAuth.js`
- [Login page](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/pages/login/LoginPage.jsx): `src/pages/login/LoginPage.jsx`
- [Login form](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/features/auth-by-login/ui/LoginForm.jsx): `src/features/auth-by-login/ui/LoginForm.jsx`
- [Login API](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/features/auth-by-login/api/authApi.js): `src/features/auth-by-login/api/authApi.js`
- [Token refresh API](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/entities/user/api/auth.js): `src/entities/user/api/auth.js`
- [Auth state](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/entities/user/model/authStore.js): `src/entities/user/model/authStore.js`
- [Token storage](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/shared/api/tokenStorage.js): `src/shared/api/tokenStorage.js`
- [JWT decoding](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/shared/lib/decodeJwt.js): `src/shared/lib/decodeJwt.js`
- [HTTP client](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/shared/api/httpClient.js): `src/shared/api/httpClient.js`
- [Auth interceptors](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/app/providers/setupInterceptors.js): `src/app/providers/setupInterceptors.js`

### Warehouse workflows

- [Home dashboard](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/pages/home/HomePage.jsx): `src/pages/home/HomePage.jsx`
- [ASN listing](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/pages/asn-list/AsnListPage.jsx): `src/pages/asn-list/AsnListPage.jsx`
- [ASN creation](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/pages/create-asn/CreateAsnPage.jsx): `src/pages/create-asn/CreateAsnPage.jsx`
- [Receipt workflow](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/pages/receipt/ReceiptPage.jsx): `src/pages/receipt/ReceiptPage.jsx`
- [ASN API](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/entities/asn/api/asnApi.js): `src/entities/asn/api/asnApi.js`
- [ASN statuses](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/entities/asn/model/asnStatus.js): `src/entities/asn/model/asnStatus.js`

### Shared interface

- [List toolbar](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/shared/ui/Toolbar/Toolbar.jsx): `src/shared/ui/Toolbar/Toolbar.jsx`
- [Search input](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/shared/ui/SearchInput/SearchInput.jsx): `src/shared/ui/SearchInput/SearchInput.jsx`
- [Sort dropdown](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/shared/ui/SortDropdown/SortDropdown.jsx): `src/shared/ui/SortDropdown/SortDropdown.jsx`
- [Outside-click hook](https://github.com/ivankhramoy/receiving-serivce-ui/blob/main/src/shared/hooks/useOutsideClick.js): `src/shared/hooks/useOutsideClick.js`
- [Page headers](https://github.com/ivankhramoy/receiving-serivce-ui/tree/main/src/widgets/Header): `src/widgets/Header`

### Other components

- **Employee**

## Connections

- Employee → App entry: opens app (evidence: `src/main.jsx`)
- App entry → App bootstrap: mounts (evidence: `src/main.jsx`)
- App entry → Auth interceptors: sets up (evidence: `src/main.jsx`)
- App bootstrap → Auth initialization: initializes auth (evidence: `src/app/App.jsx`)
- App bootstrap → Route dispatch: renders (evidence: `src/app/App.jsx`)
- App bootstrap → Query client: provides queries (evidence: `src/app/App.jsx`)
- Route dispatch → Access guards: routes through (evidence: `src/app/routing/Router.jsx`)
- Route dispatch → Role guard: checks roles (evidence: `src/app/routing/Router.jsx`)
- Route dispatch → Page layouts: wraps pages (evidence: `src/app/routing/Router.jsx`)
- Route dispatch → Login page: routes to (evidence: `src/app/routing/Router.jsx`)
- Route dispatch → Home dashboard: routes to (evidence: `src/app/routing/Router.jsx`)
- Route dispatch → ASN listing: routes to (evidence: `src/app/routing/Router.jsx`)
- Route dispatch → ASN creation: routes to (evidence: `src/app/routing/Router.jsx`)
- Route dispatch → Receipt workflow: routes to (evidence: `src/app/routing/Router.jsx`)
- Auth initialization → Token refresh API: refreshes tokens (evidence: `src/app/model/useInitAuth.js`)
- Auth initialization → Auth state: updates session (evidence: `src/app/model/useInitAuth.js`)
- Auth initialization → JWT decoding: checks expiry (evidence: `src/app/model/useInitAuth.js`)
- Login page → Login form: renders (evidence: `src/pages/login/LoginPage.jsx`)
- Login form → Login API: submits credentials (evidence: `src/features/auth-by-login/ui/LoginForm.jsx`)
- Login form → Auth state: stores tokens (evidence: `src/features/auth-by-login/ui/LoginForm.jsx`)
- Auth state → Token storage: persists tokens (evidence: `src/entities/user/model/authStore.js`)
- Auth state → JWT decoding: decodes claims (evidence: `src/entities/user/model/authStore.js`)
- HTTP client → Token storage: reads token (evidence: `src/shared/api/httpClient.js`)
- Auth interceptors → HTTP client: configures (evidence: `src/app/providers/setupInterceptors.js`)
- Auth interceptors → Auth state: connects handlers (evidence: `src/app/providers/setupInterceptors.js`)
- Login API → HTTP client: sends requests (evidence: `src/features/auth-by-login/api/authApi.js`)
- Token refresh API → HTTP client: sends requests (evidence: `src/entities/user/api/auth.js`)
- Route dispatch → Auth state: reads session (evidence: `src/app/routing/Router.jsx`)
- ASN listing → List toolbar: renders (evidence: `src/pages/asn-list/AsnListPage.jsx`)
- List toolbar → Search input: renders (evidence: `src/shared/ui/Toolbar/Toolbar.jsx`)
- List toolbar → Sort dropdown: renders (evidence: `src/shared/ui/Toolbar/Toolbar.jsx`)
- Sort dropdown → Outside-click hook: uses (evidence: `src/shared/ui/SortDropdown/SortDropdown.jsx`)
- Page layouts → Page headers: renders (evidence: `src/app/layouts/ListLayout/ListLayout.jsx`)
