# smtanjim/efms architecture

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

- Interactive diagram: https://gitdiagram.com/smtanjim/efms
- Repository: https://github.com/smtanjim/efms

## Overview

EFMS is a Flask/MySQL farm-equipment management system with five role-based terminals. Its principal workflow runs from a customer equipment request through sales quotation, customer acceptance, supplier invoicing, accounts approval and payment, then financial reporting; administrators also manage the catalog and request project-wide reports. The README maps these stages to application modules and says database access is centralized in `app/db.py`. Most application sources are not present in the supplied excerpts, so workflow links below are based on README documentation rather than inspected route implementations.

Main entry points: [`run.py`](https://github.com/smtanjim/efms/blob/main/run.py) (Flask app), [`schema.sql`](https://github.com/smtanjim/efms/blob/main/schema.sql) (MySQL database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_web_app["Flask app<br/>[run.py]"]
  node_main["Landing and redirect"]
end

subgraph group_identity["Identity and access"]
  node_auth["Authentication"]
end

subgraph group_operations["Equipment and sales"]
  node_customer_equipment["Equipment requests"]
  node_catalog["Catalog management"]
  node_quotation["Quotation management"]
end

subgraph group_finance["Invoicing and reports"]
  node_supplier_invoice["Supplier invoices"]
  node_accounts["Invoice and payment review"]
  node_financial_reports["Financial reports"]
  node_project_reports["Project reports"]
end

subgraph group_storage["Persistence"]
  node_db_layer["Database access"]
  node_mysql[("MySQL database<br/>[schema.sql]")]
end

node_customer(("Customer"))
node_sales_exec(("Sales executive"))
node_supplier_actor(("Supplier"))
node_accounts_actor(("Accounts officer"))
node_admin_actor(("Admin"))

node_web_app -.->|"registers auth"| node_auth
node_web_app -.->|"serves pages"| node_main
node_customer -->|"requests equipment"| node_customer_equipment
node_customer_equipment -->|"presents requests"| node_quotation
node_sales_exec -->|"builds quotation"| node_quotation
node_quotation -->|"sends quotation"| node_customer
node_customer -->|"accepts or declines"| node_quotation
node_supplier_actor -->|"submits invoice"| node_supplier_invoice
node_accounts_actor -->|"reviews invoice"| node_accounts
node_accounts -->|"creates payment"| node_accounts
node_accounts_actor -->|"completes payment"| node_accounts
node_accounts_actor -->|"generates report"| node_financial_reports
node_admin_actor -->|"requests report"| node_project_reports
node_admin_actor -->|"manages catalog"| node_catalog
node_customer_equipment -.->|"accesses data"| node_db_layer
node_quotation -.->|"accesses data"| node_db_layer
node_supplier_invoice -.->|"accesses data"| node_db_layer
node_accounts -.->|"accesses data"| node_db_layer
node_catalog -.->|"accesses data"| node_db_layer
node_project_reports -.->|"accesses data"| node_db_layer
node_db_layer -->|"accesses database"| node_mysql

click node_web_app "https://github.com/smtanjim/efms/blob/main/run.py"
click node_mysql "https://github.com/smtanjim/efms/blob/main/schema.sql"

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_app,node_main toneBlue
class node_auth toneAmber
class node_customer_equipment,node_catalog,node_quotation toneMint
class node_supplier_invoice,node_accounts,node_financial_reports,node_project_reports toneRose
class node_db_layer,node_mysql,node_customer,node_sales_exec,node_supplier_actor,node_accounts_actor,node_admin_actor toneIndigo
```

## Components

### Application entry

- [Flask app](https://github.com/smtanjim/efms/blob/main/run.py): `run.py`
- **Landing and redirect**

### Identity and access

- **Authentication**

### Equipment and sales

- **Equipment requests**
- **Catalog management**
- **Quotation management**

### Invoicing and reports

- **Supplier invoices**
- **Invoice and payment review**
- **Financial reports**
- **Project reports**

### Persistence

- **Database access**
- [MySQL database](https://github.com/smtanjim/efms/blob/main/schema.sql): `schema.sql`

### Other components

- **Customer**
- **Sales executive**
- **Supplier**
- **Accounts officer**
- **Admin**

## Connections

- Flask app → Authentication: registers auth
- Flask app → Landing and redirect: serves pages
- Customer → Equipment requests: requests equipment (evidence: `README.md`)
- Equipment requests → Quotation management: presents requests (evidence: `README.md`)
- Sales executive → Quotation management: builds quotation (evidence: `README.md`)
- Quotation management → Customer: sends quotation (evidence: `README.md`)
- Customer → Quotation management: accepts or declines (evidence: `README.md`)
- Supplier → Supplier invoices: submits invoice (evidence: `README.md`)
- Accounts officer → Invoice and payment review: reviews invoice (evidence: `README.md`)
- Invoice and payment review → Invoice and payment review: creates payment (evidence: `README.md`)
- Accounts officer → Invoice and payment review: completes payment (evidence: `README.md`)
- Accounts officer → Financial reports: generates report (evidence: `README.md`)
- Admin → Project reports: requests report (evidence: `README.md`)
- Admin → Catalog management: manages catalog (evidence: `README.md`)
- Equipment requests → Database access: accesses data
- Quotation management → Database access: accesses data
- Supplier invoices → Database access: accesses data
- Invoice and payment review → Database access: accesses data
- Catalog management → Database access: accesses data
- Project reports → Database access: accesses data
- Database access → MySQL database: accesses database (evidence: `README.md`)
