# dizonds/ashcolinventoryreactfinal architecture

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

- Interactive diagram: https://gitdiagram.com/dizonds/ashcolinventoryreactfinal
- Repository: https://github.com/dizonds/ashcolinventoryreactfinal

## Overview

Ashcol Inventory is a warehouse inventory and stock-movement application. A user signs in to the client, navigates its dashboard, catalog, adjustment form, or ledger, and the client loads or updates data through the Express API backed by MongoDB. The server records stock adjustments as movements; the dashboard presents inventory and restock indicators, while the ledger supports movement search and filtering. The sampled code supports the client/API and persistence links shown; other unsampled UI interactions are not inferred.

Main entry points: [`ashcoinventory/src/App.js`](https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/ashcoinventory/src/App.js) (App Shell), [`server/src/index.js`](https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/server/src/index.js) (Express API), [`ashcoinventory/src/utils/formatters.js`](https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/ashcoinventory/src/utils/formatters.js) (Money Formatting), [`ashcoinventory/src/components/LoginPage.js`](https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/ashcoinventory/src/components/LoginPage.js) (Sign In)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Inventory Client"]
  node_app["App Shell<br/>[App.js]"]
  node_login["Sign In<br/>[LoginPage.js]"]
  node_navigation["Sidebar Navigation<br/>[Sidebar.js]"]
  node_header["User Header<br/>[TopBar.js]"]
end

subgraph group_views["Inventory Workspaces"]
  node_dashboard["Dashboard<br/>[DashboardPage.js]"]
  node_catalog["Inventory Catalog"]
  node_adjustment["Post Movement"]
  node_ledger["Movement Ledger<br/>[MovementsPage.js]"]
  node_formatters["Money Formatting<br/>[formatters.js]"]
end

subgraph group_api["Inventory API"]
  node_api["Express API<br/>[index.js]"]
end

subgraph group_data["Persistent Data"]
  node_products[("Product Records<br/>[index.js]")]
  node_movements[("Movement Records<br/>[index.js]")]
  node_brands[("Brand Records<br/>[index.js]")]
end

node_user(("Warehouse User"))
node_mongodb[("MongoDB")]

node_user -->|"uses"| node_app
node_app -->|"shows signed-out"| node_login
node_login -->|"sets user"| node_app
node_app -->|"renders"| node_navigation
node_app -->|"renders"| node_header
node_app -->|"selects page"| node_dashboard
node_app -->|"selects page"| node_catalog
node_app -->|"selects page"| node_adjustment
node_app -->|"selects page"| node_ledger
node_dashboard -->|"formats values"| node_formatters
node_catalog -->|"formats values"| node_formatters
node_adjustment -->|"formats values"| node_formatters
node_app -->|"requests data"| node_api
node_api -->|"reads and writes"| node_products
node_api -->|"reads and writes"| node_movements
node_api -->|"reads and writes"| node_brands
node_products -->|"persists in"| node_mongodb
node_movements -->|"persists in"| node_mongodb
node_brands -->|"persists in"| node_mongodb

click node_app "https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/ashcoinventory/src/App.js"
click node_login "https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/ashcoinventory/src/components/LoginPage.js"
click node_navigation "https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/ashcoinventory/src/components/Sidebar.js"
click node_header "https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/ashcoinventory/src/components/TopBar.js"
click node_dashboard "https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/ashcoinventory/src/components/DashboardPage.js"
click node_catalog "https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/ashcoinventory/src/components/InventorySection.js"
click node_adjustment "https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/ashcoinventory/src/components/PostMovementPage.js"
click node_ledger "https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/ashcoinventory/src/components/MovementsPage.js"
click node_formatters "https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/ashcoinventory/src/utils/formatters.js"
click node_api "https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/server/src/index.js"
click node_products "https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/server/src/index.js"
click node_movements "https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/server/src/index.js"
click node_brands "https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/server/src/index.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_app,node_login,node_navigation,node_header,node_user toneBlue
class node_dashboard,node_catalog,node_adjustment,node_ledger,node_formatters,node_mongodb toneAmber
class node_api toneMint
class node_products,node_movements,node_brands toneRose
```

## Components

### Inventory Client

- [App Shell](https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/ashcoinventory/src/App.js): `ashcoinventory/src/App.js`
- [Sign In](https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/ashcoinventory/src/components/LoginPage.js): `ashcoinventory/src/components/LoginPage.js`
- [Sidebar Navigation](https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/ashcoinventory/src/components/Sidebar.js): `ashcoinventory/src/components/Sidebar.js`
- [User Header](https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/ashcoinventory/src/components/TopBar.js): `ashcoinventory/src/components/TopBar.js`

### Inventory Workspaces

- [Dashboard](https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/ashcoinventory/src/components/DashboardPage.js): `ashcoinventory/src/components/DashboardPage.js`
- [Inventory Catalog](https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/ashcoinventory/src/components/InventorySection.js): `ashcoinventory/src/components/InventorySection.js`
- [Post Movement](https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/ashcoinventory/src/components/PostMovementPage.js): `ashcoinventory/src/components/PostMovementPage.js`
- [Movement Ledger](https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/ashcoinventory/src/components/MovementsPage.js): `ashcoinventory/src/components/MovementsPage.js`
- [Money Formatting](https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/ashcoinventory/src/utils/formatters.js): `ashcoinventory/src/utils/formatters.js`

### Inventory API

- [Express API](https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/server/src/index.js): `server/src/index.js`

### Persistent Data

- [Product Records](https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/server/src/index.js): `server/src/index.js`
- [Movement Records](https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/server/src/index.js): `server/src/index.js`
- [Brand Records](https://github.com/dizonds/ashcolinventoryreactfinal/blob/main/server/src/index.js): `server/src/index.js`

### Other components

- **Warehouse User**
- **MongoDB**

## Connections

- Warehouse User → App Shell: uses
- App Shell → Sign In: shows signed-out (evidence: `ashcoinventory/src/App.js`)
- Sign In → App Shell: sets user (evidence: `ashcoinventory/src/App.js`)
- App Shell → Sidebar Navigation: renders (evidence: `ashcoinventory/src/App.js`)
- App Shell → User Header: renders (evidence: `ashcoinventory/src/App.js`)
- App Shell → Dashboard: selects page (evidence: `ashcoinventory/src/App.js`)
- App Shell → Inventory Catalog: selects page (evidence: `ashcoinventory/src/App.js`)
- App Shell → Post Movement: selects page (evidence: `ashcoinventory/src/App.js`)
- App Shell → Movement Ledger: selects page (evidence: `ashcoinventory/src/App.js`)
- Dashboard → Money Formatting: formats values (evidence: `ashcoinventory/src/components/DashboardPage.js`)
- Inventory Catalog → Money Formatting: formats values (evidence: `ashcoinventory/src/components/InventorySection.js`)
- Post Movement → Money Formatting: formats values (evidence: `ashcoinventory/src/components/PostMovementPage.js`)
- App Shell → Express API: requests data (evidence: `ashcoinventory/src/App.js`)
- Express API → Product Records: reads and writes (evidence: `server/src/index.js`)
- Express API → Movement Records: reads and writes (evidence: `server/src/index.js`)
- Express API → Brand Records: reads and writes (evidence: `server/src/index.js`)
- Product Records → MongoDB: persists in (evidence: `server/src/index.js`)
- Movement Records → MongoDB: persists in (evidence: `server/src/index.js`)
- Brand Records → MongoDB: persists in (evidence: `server/src/index.js`)
