# majdnaser3/01_customer_management_system architecture

> Architecture diagram of the GitHub repository majdnaser3/01_customer_management_system, 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/majdnaser3/01_customer_management_system
- Repository: https://github.com/majdnaser3/01_customer_management_system

## Overview

This is a desktop customer-management app: users add, view, search, edit, and delete customer records through a Flet interface, with input validation and local SQLite persistence. The main UI module owns the customer workflows and invokes the database module; that module performs the SQL reads and writes. The README documents the overall UI-to-database structure. Source excerpts show the database calls for add, edit, and delete; some UI-to-database paths are in omitted portions, so the graph does not assert their individual call details.

Main entry points: [`src/main.py`](https://github.com/majdnaser3/01_customer_management_system/blob/master/src/main.py) (Customer UI), [`src/Customers_database.py`](https://github.com/majdnaser3/01_customer_management_system/blob/master/src/Customers_database.py) (Customer database operations), [`data`](https://github.com/majdnaser3/01_customer_management_system/tree/master/data) (Customer records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Customer interface"]
  node_interface["Customer UI<br/>[main.py]"]
end

subgraph group_data["Customer operations"]
  node_operations["Customer database operations"]
end

subgraph group_storage["Local persistence"]
  node_sqlite[("Customer records")]
end

node_user(("User"))

node_user -->|"manages customers"| node_interface
node_interface -->|"requests CRUD"| node_operations
node_operations -->|"reads and writes"| node_sqlite

click node_interface "https://github.com/majdnaser3/01_customer_management_system/blob/master/src/main.py"
click node_operations "https://github.com/majdnaser3/01_customer_management_system/blob/master/src/Customers_database.py"
click node_sqlite "https://github.com/majdnaser3/01_customer_management_system/tree/master/data"

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_interface,node_user toneBlue
class node_operations toneAmber
class node_sqlite toneMint
```

## Components

### Customer interface

- [Customer UI](https://github.com/majdnaser3/01_customer_management_system/blob/master/src/main.py): `src/main.py`

### Customer operations

- [Customer database operations](https://github.com/majdnaser3/01_customer_management_system/blob/master/src/Customers_database.py): `src/Customers_database.py`

### Local persistence

- [Customer records](https://github.com/majdnaser3/01_customer_management_system/tree/master/data): `data`

### Other components

- **User**

## Connections

- User → Customer UI: manages customers (evidence: `README.md`)
- Customer UI → Customer database operations: requests CRUD (evidence: `src/main.py`)
- Customer database operations → Customer records: reads and writes (evidence: `src/Customers_database.py`)
