# tayyabtahir143/assetmanager architecture

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

- Interactive diagram: https://gitdiagram.com/tayyabtahir143/assetmanager
- Repository: https://github.com/tayyabtahir143/assetmanager

## Overview

AssetManager is a Flask-based IT asset inventory with a companion Flutter client and an MCP gateway. The main workflow is users managing built-in or custom assets, tracking assignments and history, and querying or exporting inventory; administration, identity integrations, notifications, reporting, and backups are additional capabilities. Most server behavior is concentrated in app.py. The mobile source was not sampled, so its API relationship is shown as unverified; other links follow the README or shown source references.

Main entry points: [`app.py`](https://github.com/tayyabtahir143/assetmanager/blob/main/app.py) (Flask web app), [`mcp_server.py`](https://github.com/tayyabtahir143/assetmanager/blob/main/mcp_server.py) (MCP gateway), [`mobile/opensource_asset_manager_flutter/lib`](https://github.com/tayyabtahir143/assetmanager/tree/main/mobile/opensource_asset_manager_flutter/lib) (Flutter mobile client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inventory["Inventory workflow"]
  node_web["Flask web app<br/>[app.py]"]
  node_asset_types["Asset catalog<br/>[app.py]"]
  node_asset_records["Asset records<br/>[app.py]"]
  node_assignment_audit["Assignment history<br/>[app.py]"]
  node_search_exports["Search and exports<br/>[app.py]"]
  node_store[("Inventory database<br/>[app.py]")]
  node_rest_api["REST API<br/>[app.py]"]
end

subgraph group_admin["Administration and identity"]
  node_identity["Accounts and access<br/>[app.py]"]
  node_roles_groups["Roles and groups<br/>[app.py]"]
end

subgraph group_integrations["Integrations and operations"]
  node_ldap["LDAP / Active Directory"]
  node_notifications["Email notifications<br/>[app.py]"]
  node_reports_backups["Reports and backups<br/>[app.py]"]
end

subgraph group_clients["Access clients"]
  node_mcp_gateway["MCP gateway<br/>[mcp_server.py]"]
  node_mobile["Flutter mobile client"]
end

node_staff(("Staff and admins"))
node_mcp_client(("MCP clients"))

node_staff -->|"uses"| node_web
node_web -->|"manages"| node_asset_types
node_web -->|"tracks"| node_asset_records
node_asset_records -->|"persists"| node_store
node_asset_records -->|"records history"| node_assignment_audit
node_web -->|"offers"| node_search_exports
node_web -->|"authenticates"| node_identity
node_identity -->|"checks permissions"| node_roles_groups
node_identity -->|"syncs users"| node_ldap
node_web -->|"sends alerts"| node_notifications
node_web -->|"provides"| node_reports_backups
node_mcp_client -->|"invokes tools"| node_mcp_gateway
node_mcp_gateway -->|"requests data"| node_rest_api
node_mobile -.->|"uses API"| node_rest_api

click node_web "https://github.com/tayyabtahir143/assetmanager/blob/main/app.py"
click node_asset_types "https://github.com/tayyabtahir143/assetmanager/blob/main/app.py"
click node_asset_records "https://github.com/tayyabtahir143/assetmanager/blob/main/app.py"
click node_assignment_audit "https://github.com/tayyabtahir143/assetmanager/blob/main/app.py"
click node_search_exports "https://github.com/tayyabtahir143/assetmanager/blob/main/app.py"
click node_store "https://github.com/tayyabtahir143/assetmanager/blob/main/app.py"
click node_identity "https://github.com/tayyabtahir143/assetmanager/blob/main/app.py"
click node_roles_groups "https://github.com/tayyabtahir143/assetmanager/blob/main/app.py"
click node_notifications "https://github.com/tayyabtahir143/assetmanager/blob/main/app.py"
click node_reports_backups "https://github.com/tayyabtahir143/assetmanager/blob/main/app.py"
click node_mcp_gateway "https://github.com/tayyabtahir143/assetmanager/blob/main/mcp_server.py"
click node_mobile "https://github.com/tayyabtahir143/assetmanager/tree/main/mobile/opensource_asset_manager_flutter/lib"
click node_rest_api "https://github.com/tayyabtahir143/assetmanager/blob/main/app.py"

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_web,node_asset_types,node_asset_records,node_assignment_audit,node_search_exports,node_store,node_rest_api,node_mcp_client toneBlue
class node_identity,node_roles_groups toneAmber
class node_ldap,node_notifications,node_reports_backups toneMint
class node_mcp_gateway,node_mobile toneRose
class node_staff toneIndigo
```

## Components

### Inventory workflow

- [Flask web app](https://github.com/tayyabtahir143/assetmanager/blob/main/app.py): `app.py`
- [Asset catalog](https://github.com/tayyabtahir143/assetmanager/blob/main/app.py): `app.py`
- [Asset records](https://github.com/tayyabtahir143/assetmanager/blob/main/app.py): `app.py`
- [Assignment history](https://github.com/tayyabtahir143/assetmanager/blob/main/app.py): `app.py`
- [Search and exports](https://github.com/tayyabtahir143/assetmanager/blob/main/app.py): `app.py`
- [Inventory database](https://github.com/tayyabtahir143/assetmanager/blob/main/app.py): `app.py`
- [REST API](https://github.com/tayyabtahir143/assetmanager/blob/main/app.py): `app.py`

### Administration and identity

- [Accounts and access](https://github.com/tayyabtahir143/assetmanager/blob/main/app.py): `app.py`
- [Roles and groups](https://github.com/tayyabtahir143/assetmanager/blob/main/app.py): `app.py`

### Integrations and operations

- **LDAP / Active Directory**
- [Email notifications](https://github.com/tayyabtahir143/assetmanager/blob/main/app.py): `app.py`
- [Reports and backups](https://github.com/tayyabtahir143/assetmanager/blob/main/app.py): `app.py`

### Access clients

- [MCP gateway](https://github.com/tayyabtahir143/assetmanager/blob/main/mcp_server.py): `mcp_server.py`
- [Flutter mobile client](https://github.com/tayyabtahir143/assetmanager/tree/main/mobile/opensource_asset_manager_flutter/lib): `mobile/opensource_asset_manager_flutter/lib`

### Other components

- **Staff and admins**
- **MCP clients**

## Connections

- Staff and admins → Flask web app: uses (evidence: `README.md`)
- Flask web app → Asset catalog: manages (evidence: `README.md`)
- Flask web app → Asset records: tracks (evidence: `README.md`)
- Asset records → Inventory database: persists (evidence: `app.py`)
- Asset records → Assignment history: records history (evidence: `README.md`)
- Flask web app → Search and exports: offers (evidence: `README.md`)
- Flask web app → Accounts and access: authenticates (evidence: `app.py`)
- Accounts and access → Roles and groups: checks permissions (evidence: `README.md`)
- Accounts and access → LDAP / Active Directory: syncs users (evidence: `README.md`)
- Flask web app → Email notifications: sends alerts (evidence: `README.md`)
- Flask web app → Reports and backups: provides (evidence: `README.md`)
- MCP clients → MCP gateway: invokes tools (evidence: `README.md`)
- MCP gateway → REST API: requests data (evidence: `mcp_server.py`)
- Flutter mobile client → REST API: uses API
