# aryan-2206/asset-management-fullstack architecture

> Architecture diagram of the GitHub repository aryan-2206/asset-management-fullstack, 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/aryan-2206/asset-management-fullstack
- Repository: https://github.com/aryan-2206/asset-management-fullstack

## Overview

Asset Management System is a React frontend backed by a Python API, SQLite persistence, and file uploads. Users sign in, enter a shared application shell, and manage assets and related operational records; the app loads and updates collections through shared state and API calls. Dashboard, activity, notifications, settings, user administration, and reports provide supporting capabilities. Frontend call relationships are based on excerpts and the SOURCE INDEX; backend responsibilities and persistence links are documented in the README, since backend.py was not excerpted.

Main entry points: [`frontend/src/App.jsx`](https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/App.jsx) (App coordinator), [`frontend/src/context/AppContext.jsx`](https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/context/AppContext.jsx) (Shared state), [`frontend/src/components/Modal.jsx`](https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/components/Modal.jsx) (Dialog component), [`frontend/src/api/client.js`](https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/api/client.js) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_app["App coordinator<br/>[App.jsx]"]
  node_auth["Sign-in<br/>[AuthScreen.jsx]"]
  node_layout["Navigation shell<br/>[AppLayout.jsx]"]
  node_modal["Dialog component<br/>[Modal.jsx]"]
end

subgraph group_domains["Asset operations"]
  node_assets["Asset records<br/>[Assets.jsx]"]
  node_loans["Asset loans<br/>[Loans.jsx]"]
  node_maintenance["Maintenance requests<br/>[Maintenance.jsx]"]
  node_procurement["Procurement requests<br/>[Procurement.jsx]"]
  node_properties["Properties<br/>[Properties.jsx]"]
  node_vendors["Vendors<br/>[Vendors.jsx]"]
end

subgraph group_insights["Insights and administration"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_activity["Activity history<br/>[Activity.jsx]"]
  node_notifications["Notifications<br/>[Notifications.jsx]"]
  node_reports["Reports<br/>[Reports.jsx]"]
  node_settings["Settings<br/>[Settings.jsx]"]
  node_users["User administration<br/>[Users.jsx]"]
end

subgraph group_services["Data services"]
  node_context["Shared state<br/>[AppContext.jsx]"]
  node_api["API client<br/>[client.js]"]
  node_backend["Python backend<br/>[backend.py]"]
  node_database[("SQLite database")]
  node_uploads["Uploaded files"]
end

node_user(("User"))

node_user -->|"signs in"| node_auth
node_user -->|"uses"| node_layout
node_app -->|"renders"| node_auth
node_app -->|"renders"| node_layout
node_app -->|"provides state"| node_context
node_app -->|"auth requests"| node_api
node_app -->|"selects page"| node_dashboard
node_app -->|"selects page"| node_assets
node_app -->|"selects page"| node_loans
node_app -->|"selects page"| node_maintenance
node_app -->|"selects page"| node_procurement
node_app -->|"selects page"| node_properties
node_app -->|"selects page"| node_vendors
node_app -->|"selects page"| node_activity
node_app -->|"selects page"| node_notifications
node_app -->|"selects page"| node_reports
node_app -->|"selects page"| node_settings
node_app -->|"selects page"| node_users
node_layout -->|"shows account"| node_user
node_context -->|"fetches and mutates"| node_api
node_assets -->|"reads and updates"| node_context
node_loans -->|"uses collections"| node_context
node_maintenance -->|"reads and updates"| node_context
node_procurement -->|"reads and updates"| node_context
node_properties -->|"reads and updates"| node_context
node_vendors -->|"uses collections"| node_context
node_dashboard -->|"reads collections"| node_context
node_activity -->|"reads collections"| node_context
node_notifications -->|"uses collections"| node_context
node_reports -->|"uses collections"| node_context
node_settings -->|"uses collections"| node_context
node_users -->|"uses collections"| node_context
node_assets -->|"uses dialog"| node_modal
node_loans -->|"uses dialog"| node_modal
node_maintenance -->|"uses dialog"| node_modal
node_procurement -->|"uses dialog"| node_modal
node_properties -->|"uses dialog"| node_modal
node_vendors -->|"uses dialog"| node_modal
node_users -->|"uses dialog"| node_modal
node_api -->|"sends API requests"| node_backend
node_backend -->|"persists records"| node_database
node_backend -->|"handles file uploads"| node_uploads
node_properties -->|"uploads images"| node_api
node_reports -->|"downloads reports"| node_api

click node_app "https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/App.jsx"
click node_auth "https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/components/AuthScreen.jsx"
click node_layout "https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/components/AppLayout.jsx"
click node_context "https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/context/AppContext.jsx"
click node_api "https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/api/client.js"
click node_backend "https://github.com/aryan-2206/asset-management-fullstack/blob/main/backend.py"
click node_assets "https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/pages/Assets.jsx"
click node_loans "https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/pages/Loans.jsx"
click node_maintenance "https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/pages/Maintenance.jsx"
click node_procurement "https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/pages/Procurement.jsx"
click node_properties "https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/pages/Properties.jsx"
click node_vendors "https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/pages/Vendors.jsx"
click node_dashboard "https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/pages/Dashboard.jsx"
click node_activity "https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/pages/Activity.jsx"
click node_notifications "https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/pages/Notifications.jsx"
click node_reports "https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/pages/Reports.jsx"
click node_settings "https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/pages/Settings.jsx"
click node_users "https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/pages/Users.jsx"
click node_modal "https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/components/Modal.jsx"

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_auth,node_layout,node_modal,node_user toneBlue
class node_assets,node_loans,node_maintenance,node_procurement,node_properties,node_vendors toneAmber
class node_dashboard,node_activity,node_notifications,node_reports,node_settings,node_users toneMint
class node_context,node_api,node_backend,node_database,node_uploads toneRose
```

## Components

### Application shell

- [App coordinator](https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Sign-in](https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/components/AuthScreen.jsx): `frontend/src/components/AuthScreen.jsx`
- [Navigation shell](https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/components/AppLayout.jsx): `frontend/src/components/AppLayout.jsx`
- [Dialog component](https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/components/Modal.jsx): `frontend/src/components/Modal.jsx`

### Asset operations

- [Asset records](https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/pages/Assets.jsx): `frontend/src/pages/Assets.jsx`
- [Asset loans](https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/pages/Loans.jsx): `frontend/src/pages/Loans.jsx`
- [Maintenance requests](https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/pages/Maintenance.jsx): `frontend/src/pages/Maintenance.jsx`
- [Procurement requests](https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/pages/Procurement.jsx): `frontend/src/pages/Procurement.jsx`
- [Properties](https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/pages/Properties.jsx): `frontend/src/pages/Properties.jsx`
- [Vendors](https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/pages/Vendors.jsx): `frontend/src/pages/Vendors.jsx`

### Insights and administration

- [Dashboard](https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [Activity history](https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/pages/Activity.jsx): `frontend/src/pages/Activity.jsx`
- [Notifications](https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/pages/Notifications.jsx): `frontend/src/pages/Notifications.jsx`
- [Reports](https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/pages/Reports.jsx): `frontend/src/pages/Reports.jsx`
- [Settings](https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/pages/Settings.jsx): `frontend/src/pages/Settings.jsx`
- [User administration](https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/pages/Users.jsx): `frontend/src/pages/Users.jsx`

### Data services

- [Shared state](https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/context/AppContext.jsx): `frontend/src/context/AppContext.jsx`
- [API client](https://github.com/aryan-2206/asset-management-fullstack/blob/main/frontend/src/api/client.js): `frontend/src/api/client.js`
- [Python backend](https://github.com/aryan-2206/asset-management-fullstack/blob/main/backend.py): `backend.py`
- **SQLite database**
- **Uploaded files**

### Other components

- **User**

## Connections

- User → Sign-in: signs in (evidence: `frontend/src/components/AuthScreen.jsx`)
- User → Navigation shell: uses (evidence: `frontend/src/components/AppLayout.jsx`)
- App coordinator → Sign-in: renders (evidence: `frontend/src/App.jsx`)
- App coordinator → Navigation shell: renders (evidence: `frontend/src/App.jsx`)
- App coordinator → Shared state: provides state (evidence: `frontend/src/App.jsx`)
- App coordinator → API client: auth requests (evidence: `frontend/src/App.jsx`)
- App coordinator → Dashboard: selects page (evidence: `frontend/src/App.jsx`)
- App coordinator → Asset records: selects page (evidence: `frontend/src/App.jsx`)
- App coordinator → Asset loans: selects page (evidence: `frontend/src/App.jsx`)
- App coordinator → Maintenance requests: selects page (evidence: `frontend/src/App.jsx`)
- App coordinator → Procurement requests: selects page (evidence: `frontend/src/App.jsx`)
- App coordinator → Properties: selects page (evidence: `frontend/src/App.jsx`)
- App coordinator → Vendors: selects page (evidence: `frontend/src/App.jsx`)
- App coordinator → Activity history: selects page (evidence: `frontend/src/App.jsx`)
- App coordinator → Notifications: selects page (evidence: `frontend/src/App.jsx`)
- App coordinator → Reports: selects page (evidence: `frontend/src/App.jsx`)
- App coordinator → Settings: selects page (evidence: `frontend/src/App.jsx`)
- App coordinator → User administration: selects page (evidence: `frontend/src/App.jsx`)
- Navigation shell → User: shows account (evidence: `frontend/src/components/AppLayout.jsx`)
- Shared state → API client: fetches and mutates (evidence: `frontend/src/context/AppContext.jsx`)
- Asset records → Shared state: reads and updates (evidence: `frontend/src/pages/Assets.jsx`)
- Asset loans → Shared state: uses collections (evidence: `frontend/src/pages/Loans.jsx`)
- Maintenance requests → Shared state: reads and updates (evidence: `frontend/src/pages/Maintenance.jsx`)
- Procurement requests → Shared state: reads and updates (evidence: `frontend/src/pages/Procurement.jsx`)
- Properties → Shared state: reads and updates (evidence: `frontend/src/pages/Properties.jsx`)
- Vendors → Shared state: uses collections (evidence: `frontend/src/pages/Vendors.jsx`)
- Dashboard → Shared state: reads collections (evidence: `frontend/src/pages/Dashboard.jsx`)
- Activity history → Shared state: reads collections (evidence: `frontend/src/pages/Activity.jsx`)
- Notifications → Shared state: uses collections (evidence: `frontend/src/pages/Notifications.jsx`)
- Reports → Shared state: uses collections (evidence: `frontend/src/pages/Reports.jsx`)
- Settings → Shared state: uses collections (evidence: `frontend/src/pages/Settings.jsx`)
- User administration → Shared state: uses collections (evidence: `frontend/src/pages/Users.jsx`)
- Asset records → Dialog component: uses dialog (evidence: `frontend/src/pages/Assets.jsx`)
- Asset loans → Dialog component: uses dialog (evidence: `frontend/src/pages/Loans.jsx`)
- Maintenance requests → Dialog component: uses dialog (evidence: `frontend/src/pages/Maintenance.jsx`)
- Procurement requests → Dialog component: uses dialog (evidence: `frontend/src/pages/Procurement.jsx`)
- Properties → Dialog component: uses dialog (evidence: `frontend/src/pages/Properties.jsx`)
- Vendors → Dialog component: uses dialog (evidence: `frontend/src/pages/Vendors.jsx`)
- User administration → Dialog component: uses dialog (evidence: `frontend/src/pages/Users.jsx`)
- API client → Python backend: sends API requests (evidence: `README.md`)
- Python backend → SQLite database: persists records (evidence: `README.md`)
- Python backend → Uploaded files: handles file uploads (evidence: `README.md`)
- Properties → API client: uploads images (evidence: `frontend/src/pages/Properties.jsx`)
- Reports → API client: downloads reports (evidence: `frontend/src/pages/Reports.jsx`)
