diff --git a/submissions/Muse-Ali/final project b/submissions/Muse-Ali/final project new file mode 100644 index 00000000..420cbe6e --- /dev/null +++ b/submissions/Muse-Ali/final project @@ -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 +----------------------------------------------------------------------