Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
98 changes: 98 additions & 0 deletions submissions/Muse-Ali/final project
Original file line number Diff line number Diff line change
@@ -0,0 +1,98 @@
# Project Name: E-Pharmacy Management System

A command-line(CL) E-Pharmacy Management System application : built with Python using Object-Oriented Programming (OOP), file handling, functions, loops, and modular programming principles.

## Project Purpose

The purpose of this project is to help pharmacists and administrators manage medicine inventories, track sales, and handle prescriptions directly from the terminal. Users can

* Add
* view
* edit
* delete
* filter
* sell medicines.

During building this project , I manage to practice these concepts:

* Classes and Objects (OOP)
* Functions
* Lists and Dictionaries
* Loops and Conditions
* File Handling
* Modular Programming
* CRUD Operations

---

## Features:

this project has the following features

### 1. Add Medicine

Users can add new medicines with:
* ID
* Name
* Category
* Price
* Quantity
* Expiry Date

### 2. View Inventory

Displays all saved medicines in a clean formatted table.

### 3. Calculate Total Sales

Calculates and displays the total amount of money generated from sales.

### 4. Filter Medicines by Category

Users can filter medicines by categories such as:
* Antibiotics
* Painkillers
* Syrups
* Vitamins

### 5. Edit Medicine Details

Users can update existing medicine info (like stock quantity or price) by ID.

### 6. Delete Medicine

Users can remove expired or discontinued medicines from the system.

### 7. Save Data to File

Medicines and sales data are saved to text files so data is not lost after closing the application.

### 8. Load Data from File

Previously saved data is automatically loaded when the application starts.

---

## Project Structure

```text
e_pharmacy/
├── medicine.py
├── main.py
├── inventory.py
├── sales.py
├── file_handler.py
├── utils.py
├── data/
│ ├── inventory.txt
│ └── sales_history.txt
└── README.md
##Example: How our pharmacy data will look like .
Id Name Category Price Quantity Expiry Date
----------------------------------------------------------------------
1 Paracetamol Painkiller $2.50 150 2028-12-01
2 Amoxicillin Antibiotic $12.00 80 2027-06-15
3 CoughSyrup Syrup $4.50 45 2026-11-20
4 Ibuprofen Painkiller $3.20 200 2028-02-10
----------------------------------------------------------------------
Loading