# shiiivam-01/pharmacy-management-system architecture

> Architecture diagram of the GitHub repository shiiivam-01/pharmacy-management-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shiiivam-01/pharmacy-management-system
- Repository: https://github.com/shiiivam-01/pharmacy-management-system

## Overview

PMS is a menu-driven pharmacy operations application. Staff use the CLI to log in, manage medicines and deliveries, bill customers, and review alerts and reports; billing allocates non-expired stock by FEFO and records sales. The repository also contains a small FastAPI surface for authentication and medicine operations. The graph preserves the README’s major operational capabilities; arrows follow explicit README statements or relationships visible in indexed/read source. Several service implementations were not excerpted, so their internal calls are not expanded.

Main entry points: [`frontend/cli/app.py`](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/frontend/cli/app.py) (CLI application), [`backend/services/billing_service.py`](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/services/billing_service.py) (Billing and sales), [`backend/services/medicine_service.py`](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/services/medicine_service.py) (Medicine management), [`backend/services/auth_service.py`](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/services/auth_service.py) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User interfaces"]
  node_cli_app["CLI application<br/>[app.py]"]
  node_cli_console["Console helpers<br/>[console.py]"]
  node_medicine_menu["Medicine menu<br/>[medicine_menu.py]"]
  node_inventory_menu["Inventory menu<br/>[inventory_menu.py]"]
  node_billing_menu["Billing menu<br/>[billing_menu.py]"]
  node_supplier_menu["Supplier menu<br/>[supplier_menu.py]"]
  node_employee_menu["Employee menu<br/>[employee_menu.py]"]
  node_report_menu["Report menu<br/>[report_menu.py]"]
  node_audit_menu["Audit menu<br/>[audit_menu.py]"]
  node_api["HTTP API<br/>[main.py]"]
  node_api_auth["Auth route<br/>[auth.py]"]
  node_api_medicines["Medicine route<br/>[medicines.py]"]
end

subgraph group_identity["Identity and access"]
  node_auth_service["Authentication<br/>[auth_service.py]"]
  node_security["Roles and passwords<br/>[security.py]"]
end

subgraph group_operations["Pharmacy operations"]
  node_medicine_service["Medicine management"]
  node_inventory_service["Stock control"]
  node_billing_service["Billing and sales<br/>[billing_service.py]"]
  node_fefo["FEFO allocation<br/>[fefo.py]"]
  node_supplier_service["Supplier management"]
  node_employee_service["Employee management"]
  node_alert_service["Stock alerts<br/>[alert_service.py]"]
  node_report_service["Reports<br/>[report_service.py]"]
end

subgraph group_data["Persistence and domain"]
  node_medicine_repo["Medicine records"]
  node_batch_repo["Batch records"]
  node_employee_repo["Employee records"]
  node_supplier_repo["Supplier records"]
  node_sale_repo["Sale records<br/>[sale_repository.py]"]
  node_models["Domain models<br/>[models.py]"]
  node_database[("SQLite access<br/>[database.py]")]
end

node_staff(("Pharmacy staff"))

node_staff -->|"uses"| node_cli_app
node_cli_app -->|"authenticates"| node_auth_service
node_cli_app -->|"loads alerts"| node_alert_service
node_cli_app -->|"opens"| node_medicine_menu
node_cli_app -->|"opens"| node_inventory_menu
node_cli_app -->|"opens"| node_billing_menu
node_cli_app -->|"opens"| node_supplier_menu
node_cli_app -->|"opens"| node_employee_menu
node_cli_app -->|"opens"| node_report_menu
node_cli_app -->|"opens"| node_audit_menu
node_medicine_menu -->|"calls"| node_medicine_service
node_inventory_menu -->|"calls"| node_inventory_service
node_inventory_menu -->|"calls"| node_medicine_service
node_billing_menu -->|"calls"| node_billing_service
node_billing_menu -->|"calls"| node_medicine_service
node_supplier_menu -->|"calls"| node_supplier_service
node_employee_menu -->|"calls"| node_employee_service
node_report_menu -->|"calls"| node_report_service
node_audit_menu -->|"checks access"| node_security
node_api -->|"registers"| node_api_auth
node_api -->|"registers"| node_api_medicines
node_api_auth -->|"calls"| node_auth_service
node_api_medicines -->|"calls"| node_medicine_service
node_auth_service -->|"reads and writes"| node_employee_repo
node_auth_service -->|"hashes passwords"| node_security
node_medicine_service -->|"reads and writes"| node_medicine_repo
node_inventory_service -->|"manages batches"| node_batch_repo
node_inventory_service -->|"reads medicines"| node_medicine_repo
node_billing_service -->|"reads medicines"| node_medicine_repo
node_billing_service -->|"allocates stock"| node_batch_repo
node_billing_service -->|"records sales"| node_sale_repo
node_billing_service -->|"allocates FEFO"| node_fefo
node_employee_service -->|"manages employees"| node_employee_repo
node_supplier_service -->|"manages suppliers"| node_supplier_repo
node_api -->|"initializes"| node_database
node_cli_app -->|"connects"| node_database
node_database -.->|"stores records"| node_models

click node_cli_app "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/frontend/cli/app.py"
click node_cli_console "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/frontend/cli/console.py"
click node_medicine_menu "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/frontend/cli/medicine_menu.py"
click node_inventory_menu "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/frontend/cli/inventory_menu.py"
click node_billing_menu "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/frontend/cli/billing_menu.py"
click node_supplier_menu "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/frontend/cli/supplier_menu.py"
click node_employee_menu "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/frontend/cli/employee_menu.py"
click node_report_menu "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/frontend/cli/report_menu.py"
click node_audit_menu "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/frontend/cli/audit_menu.py"
click node_api "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/api/main.py"
click node_api_auth "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/api/routers/auth.py"
click node_api_medicines "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/api/routers/medicines.py"
click node_auth_service "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/services/auth_service.py"
click node_security "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/security.py"
click node_medicine_service "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/services/medicine_service.py"
click node_inventory_service "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/services/inventory_service.py"
click node_billing_service "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/services/billing_service.py"
click node_fefo "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/services/fefo.py"
click node_supplier_service "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/services/supplier_service.py"
click node_employee_service "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/services/employee_service.py"
click node_alert_service "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/services/alert_service.py"
click node_report_service "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/services/report_service.py"
click node_medicine_repo "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/repositories/medicine_repository.py"
click node_batch_repo "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/repositories/batch_repository.py"
click node_employee_repo "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/repositories/employee_repository.py"
click node_supplier_repo "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/repositories/supplier_repository.py"
click node_sale_repo "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/repositories/sale_repository.py"
click node_models "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/models.py"
click node_database "https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/database.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_cli_app,node_cli_console,node_medicine_menu,node_inventory_menu,node_billing_menu,node_supplier_menu,node_employee_menu,node_report_menu,node_audit_menu,node_api,node_api_auth,node_api_medicines toneBlue
class node_auth_service,node_security toneAmber
class node_medicine_service,node_inventory_service,node_billing_service,node_fefo,node_supplier_service,node_employee_service,node_alert_service,node_report_service toneMint
class node_medicine_repo,node_batch_repo,node_employee_repo,node_supplier_repo,node_sale_repo,node_models,node_database toneRose
class node_staff toneIndigo
```

## Components

### User interfaces

- [CLI application](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/frontend/cli/app.py): `frontend/cli/app.py`
- [Console helpers](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/frontend/cli/console.py): `frontend/cli/console.py`
- [Medicine menu](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/frontend/cli/medicine_menu.py): `frontend/cli/medicine_menu.py`
- [Inventory menu](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/frontend/cli/inventory_menu.py): `frontend/cli/inventory_menu.py`
- [Billing menu](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/frontend/cli/billing_menu.py): `frontend/cli/billing_menu.py`
- [Supplier menu](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/frontend/cli/supplier_menu.py): `frontend/cli/supplier_menu.py`
- [Employee menu](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/frontend/cli/employee_menu.py): `frontend/cli/employee_menu.py`
- [Report menu](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/frontend/cli/report_menu.py): `frontend/cli/report_menu.py`
- [Audit menu](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/frontend/cli/audit_menu.py): `frontend/cli/audit_menu.py`
- [HTTP API](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/api/main.py): `api/main.py`
- [Auth route](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/api/routers/auth.py): `api/routers/auth.py`
- [Medicine route](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/api/routers/medicines.py): `api/routers/medicines.py`

### Identity and access

- [Authentication](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/services/auth_service.py): `backend/services/auth_service.py`
- [Roles and passwords](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/security.py): `backend/security.py`

### Pharmacy operations

- [Medicine management](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/services/medicine_service.py): `backend/services/medicine_service.py`
- [Stock control](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/services/inventory_service.py): `backend/services/inventory_service.py`
- [Billing and sales](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/services/billing_service.py): `backend/services/billing_service.py`
- [FEFO allocation](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/services/fefo.py): `backend/services/fefo.py`
- [Supplier management](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/services/supplier_service.py): `backend/services/supplier_service.py`
- [Employee management](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/services/employee_service.py): `backend/services/employee_service.py`
- [Stock alerts](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/services/alert_service.py): `backend/services/alert_service.py`
- [Reports](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/services/report_service.py): `backend/services/report_service.py`

### Persistence and domain

- [Medicine records](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/repositories/medicine_repository.py): `backend/repositories/medicine_repository.py`
- [Batch records](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/repositories/batch_repository.py): `backend/repositories/batch_repository.py`
- [Employee records](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/repositories/employee_repository.py): `backend/repositories/employee_repository.py`
- [Supplier records](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/repositories/supplier_repository.py): `backend/repositories/supplier_repository.py`
- [Sale records](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/repositories/sale_repository.py): `backend/repositories/sale_repository.py`
- [Domain models](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/models.py): `backend/models.py`
- [SQLite access](https://github.com/shiiivam-01/pharmacy-management-system/blob/main/backend/database.py): `backend/database.py`

### Other components

- **Pharmacy staff**

## Connections

- Pharmacy staff → CLI application: uses (evidence: `README.md`)
- CLI application → Authentication: authenticates (evidence: `frontend/cli/app.py`)
- CLI application → Stock alerts: loads alerts (evidence: `frontend/cli/app.py`)
- CLI application → Medicine menu: opens (evidence: `frontend/cli/app.py`)
- CLI application → Inventory menu: opens (evidence: `frontend/cli/app.py`)
- CLI application → Billing menu: opens (evidence: `frontend/cli/app.py`)
- CLI application → Supplier menu: opens (evidence: `frontend/cli/app.py`)
- CLI application → Employee menu: opens (evidence: `frontend/cli/app.py`)
- CLI application → Report menu: opens (evidence: `frontend/cli/app.py`)
- CLI application → Audit menu: opens (evidence: `frontend/cli/app.py`)
- Medicine menu → Medicine management: calls (evidence: `frontend/cli/medicine_menu.py`)
- Inventory menu → Stock control: calls (evidence: `frontend/cli/inventory_menu.py`)
- Inventory menu → Medicine management: calls (evidence: `frontend/cli/inventory_menu.py`)
- Billing menu → Billing and sales: calls (evidence: `frontend/cli/billing_menu.py`)
- Billing menu → Medicine management: calls (evidence: `frontend/cli/billing_menu.py`)
- Supplier menu → Supplier management: calls (evidence: `frontend/cli/supplier_menu.py`)
- Employee menu → Employee management: calls (evidence: `frontend/cli/employee_menu.py`)
- Report menu → Reports: calls (evidence: `frontend/cli/report_menu.py`)
- Audit menu → Roles and passwords: checks access (evidence: `frontend/cli/audit_menu.py`)
- HTTP API → Auth route: registers (evidence: `api/main.py`)
- HTTP API → Medicine route: registers (evidence: `api/main.py`)
- Auth route → Authentication: calls (evidence: `api/routers/auth.py`)
- Medicine route → Medicine management: calls (evidence: `api/routers/medicines.py`)
- Authentication → Employee records: reads and writes (evidence: `backend/services/auth_service.py`)
- Authentication → Roles and passwords: hashes passwords (evidence: `backend/services/auth_service.py`)
- Medicine management → Medicine records: reads and writes (evidence: `backend/services/medicine_service.py`)
- Stock control → Batch records: manages batches (evidence: `backend/services/inventory_service.py`)
- Stock control → Medicine records: reads medicines (evidence: `backend/services/inventory_service.py`)
- Billing and sales → Medicine records: reads medicines (evidence: `backend/services/billing_service.py`)
- Billing and sales → Batch records: allocates stock (evidence: `backend/services/billing_service.py`)
- Billing and sales → Sale records: records sales (evidence: `backend/services/billing_service.py`)
- Billing and sales → FEFO allocation: allocates FEFO (evidence: `backend/services/billing_service.py`)
- Employee management → Employee records: manages employees (evidence: `backend/services/employee_service.py`)
- Supplier management → Supplier records: manages suppliers (evidence: `backend/services/supplier_service.py`)
- HTTP API → SQLite access: initializes (evidence: `api/main.py`)
- CLI application → SQLite access: connects (evidence: `frontend/cli/app.py`)
- SQLite access → Domain models: stores records
