https://github.com/omarrsakr/pharmacy-management
Pharmacy Management ๐ A static desktop application built using C# And Database designed for managing pharmacy operations. It features multiple modules to handle various aspects of pharmacy management, including agent management, billing, medicine tracking, and manufacturer records.
https://github.com/omarrsakr/pharmacy-management
database gui guna-ui
Last synced: 9 months ago
JSON representation
Pharmacy Management ๐ A static desktop application built using C# And Database designed for managing pharmacy operations. It features multiple modules to handle various aspects of pharmacy management, including agent management, billing, medicine tracking, and manufacturer records.
- Host: GitHub
- URL: https://github.com/omarrsakr/pharmacy-management
- Owner: OmarrSakr
- Created: 2024-10-29T15:58:29.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-01-07T16:44:53.000Z (over 1 year ago)
- Last Synced: 2025-01-07T17:50:55.560Z (over 1 year ago)
- Topics: database, gui, guna-ui
- Language: C#
- Homepage:
- Size: 21.5 MB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# ๐๐ฅ Pharmacy Management System
Pharmacy Management: ูุธุงู
ุฅุฏุงุฑุฉ ุตูุฏููุฉ ุดุงู
ู ู
ุจูู ุจู C# ูุฅุฏุงุฑุฉ ุงูุนู
ููุงุช ุงูููู
ูุฉุ ุงูู
ุฎุฒููุ ูุงูููุงุชูุฑ ุจููุงุกุฉ ุนุงููุฉ. ๐๐
[ Pharmacy Management Demo](https://omarrsakr.github.io/Pharmacy-Management/) โข
[Documentation](https://github.com/OmarrSakr/Pharmacy-Management/wiki) โข
[Report Issues](https://github.com/OmarrSakr/Pharmacy-Management/issues)
**`Pharmacy Management System`** is a comprehensive desktop application built with **`C# Windows Forms`** designed to streamline pharmacy operations. It features multiple integrated modules for **employee management**, **billing systems**, **medicine inventory tracking**, and **manufacturer records** with secure data handling through file storage and database connectivity.
## ๐ Project Stats
- ๐ **Modules**: 4 Core Management Systems
- ๐ฅ **Target**: Pharmacy & Healthcare Facilities
- ๐ป **Platform**: Windows Desktop Application
- โญ **Rating**: 4.6/5 (based on healthcare professionals feedback)
- ๐ **Visitors**:
---
## ๐งโ๐ป Tech Stack
---
## ๐ท Screenshots
---
## ๐ Table of Contents
- [๐ Features](#-features)
- [๐งโ๐ป Technologies Used](#-technologies-used)
- [๐ Project Structure](#-project-structure)
- [๐ง Installation](#-installation)
- [โ๏ธ Usage](#๏ธ-usage)
- [๐ Login Information](#-login-information)
- [๐พ Database Configuration](#-database-configuration)
- [๐ System Modules](#-system-modules)
- [๐ Security Features](#-security-features)
- [๐ Future Enhancements](#-future-enhancements)
- [โ ๏ธ Important Notes](#๏ธ-important-notes)
- [๐ค Contributing](#-contributing)
- [๐ช Feedback](#-feedback)
- [๐ License](#-license)
---
## ๐ Live Demo
Check out the live demo of **Pharmacy Management** at ๐ [Pharmacy-Management Demo](https://omarrsakr.github.io/Pharmacy-Management/)
---
## ๐ Features
- ๐ฅ **Agent Management**: Complete employee records with add, search, edit, and delete functionality
- ๐ฐ **Billing System**: Comprehensive transaction recording with detailed bill generation
- ๐ **Medicine Inventory**: Advanced stock tracking with batch, expiry, and pricing management
- ๐ญ **Manufacturer Management**: Detailed supplier records and communication tracking
- ๐ **Secure Authentication**: Login system with credential protection
- ๐ **Data Persistence**: File-based storage with database integration
- ๐ฅ๏ธ **Desktop Optimized**: Responsive Windows Forms interface
- ๐ **Advanced Search**: Quick data retrieval across all modules
- ๐ **Financial Tracking**: Enhanced billing and transaction monitoring
- โก **Real-time Updates**: Instant data synchronization across modules
---
## ๐งโ๐ป Technologies Used
- **C# Windows Forms**: Core application framework for user interface development
- **.NET Framework**: Runtime environment and base class library
- **SQL Server LocalDB**: Local database engine for data storage
- **File Handling**: Text file operations for data persistence and backup
- **ADO.NET**: Data access technology for database connectivity
- **Visual Studio**: Integrated development environment
- **Object-Oriented Programming**: Modular design with class-based architecture
๐ฆ **Dependencies**
- [.NET Framework 4.7.2+](https://dotnet.microsoft.com/download/dotnet-framework)
- [SQL Server LocalDB](https://docs.microsoft.com/en-us/sql/database-engine/configure-windows/sql-server-express-localdb)
- [Visual Studio 2019+](https://visualstudio.microsoft.com/) (for development)
---
## ๐ Project Structure
```
Pharmacy-Management/
โโโ ๐ Forms/
โ โโโ ๐ Home.cs # Main dashboard interface
โ โโโ ๐ฅ AgentManagement.cs # Employee management form
โ โโโ ๐ฐ Billing.cs # Transaction and billing form
โ โโโ ๐ MedicineInventory.cs # Medicine stock management
โ โโโ ๐ญ ManufacturerRecords.cs # Supplier management form
โ โโโ ๐ Login.cs # Authentication form
โโโ ๐ Data/
โ โโโ ๐๏ธ PHARMACYOB.MDF # SQL Server database file
โ โโโ ๐ savedLogin.txt # Login credentials backup
โ โโโ ๐ InventoryData.txt # Medicine stock data
โโโ ๐ Models/
โ โโโ ๐ค Agent.cs # Employee data model
โ โโโ ๐ Medicine.cs # Medicine data model
โ โโโ ๐ญ Manufacturer.cs # Supplier data model
โ โโโ ๐ฐ Transaction.cs # Billing data model
โโโ ๐ Resources/
โ โโโ ๐ผ๏ธ Icons/ # Application icons
โ โโโ ๐จ Images/ # UI graphics
โโโ ๐ง App.config # Application configuration
โโโ ๐ Program.cs # Application entry point
โโโ ๐ README.md # Project documentation
```
---
## ๐ง Installation
### **Prerequisites**
- Windows 10/11 (64-bit recommended)
- .NET Framework 4.7.2 or higher
- Visual Studio 2019 or later (for development)
- SQL Server LocalDB
### **Installation Steps**
1. **Clone the repository**
```bash
git clone https://github.com/OmarrSakr/Pharmacy-Management.git
```
2. **Navigate to project directory**
```bash
cd Pharmacy-Management
```
3. **Open in Visual Studio**
- Launch Visual Studio
- Open `PharmacyManagement.sln`
4. **Configure Database Connection**
- Update the connection string in the code:
```csharp
public SqlConnection con = new SqlConnection(@"Data Source=(LocalDB)\MSSQLLocalDB;AttachDbFilename=E:\PROJECT_OOP\FO_ORGANIZATION\PHARMACY-MANAGEMENT\PROJECT_FO_3\PHARMACYOB.MDF;Integrated Security=True;");
```
5. **Build and Run**
- Press `F5` or click `Start Debugging`
- Ensure all dependencies are restored
---
## ๐ System Requirements
- **OS**: Windows 10/11
- **RAM**: 4GB minimum (8GB recommended)
- **Storage**: 500MB free space
- **Framework**: .NET Framework 4.7.2+
- **Database**: SQL Server LocalDB
- **Resolution**: 1024x768 minimum
---
## โ๏ธ Usage
### **Getting Started**
1. **Launch Application**: Run the executable or start from Visual Studio
2. **Login**: Use the provided credentials (see Login Information section)
3. **Navigate Modules**: Access different management sections from the main menu
4. **Manage Data**: Add, edit, search, and delete records as needed
5. **Generate Reports**: Use billing module for transaction reports
### **Daily Operations**
- **Morning Setup**: Check inventory levels and expiring medicines
- **Customer Service**: Process sales and generate bills
- **Inventory Updates**: Add new stock and update medicine information
- **End-of-Day**: Review transactions and generate daily reports
---
## ๐ Login Information
### **Default Credentials**
- **Username**: `admin`
- **Password**: `123`
### **Security Implementation**
```csharp
// Login validation with file backup
string filename = @"E:\Project_OOP\FO_organization\Pharmacy-Management\savedLogin.txt";
using (FileStream myfile = new FileStream(filename, FileMode.OpenOrCreate, FileAccess.Write))
{
using (StreamWriter sw = new StreamWriter(myfile))
{
sw.WriteLine($"username: {username.Text}\t password:{password.Text}");
}
}
if (name == "admin" && pass == "123")
{
Hide();
Home basic = new Home();
basic.ShowDialog();
}
else
{
MessageBox.Show("Error, your Username or Password is incorrect");
username.Text = password.Text = null;
}
```
### **Changing Login Credentials**
To modify the default login credentials:
```csharp
// Update these values in the Login.cs file
string defaultUsername = "admin"; // Change to your preferred username
string defaultPassword = "123"; // Change to your secure password
```
**โ ๏ธ Important**: Always use strong passwords in production environments!
---
## ๐พ Database Configuration
### **Connection String Setup**
The application uses SQL Server LocalDB. Update the connection string to match your file path:
```csharp
public SqlConnection con = new SqlConnection(@"Data Source=(LocalDB)\MSSQLLocalDB;AttachDbFilename=[YOUR_PROJECT_PATH]\PHARMACYOB.MDF;Integrated Security=True;");
```
### **Database Tables**
- **Agents**: Employee information and management data
- **Medicines**: Inventory details with batch and expiry tracking
- **Manufacturers**: Supplier contact and product information
- **Transactions**: Billing and sales transaction records
---
## ๐ System Modules
### **1. Agent Management Module**
- โ **Add New Agents**: Complete employee registration
- ๐ **Search & Filter**: Quick employee lookup
- โ๏ธ **Edit Records**: Update employee information
- ๐๏ธ **Delete Agents**: Remove inactive employees
- ๐ **View Details**: Comprehensive employee profiles
### **2. Billing System Module**
- ๐ฐ **Process Sales**: Record customer transactions
- ๐งพ **Generate Bills**: Create detailed invoices
- ๐ **Transaction History**: View past sales records
- ๐ณ **Payment Tracking**: Monitor payment methods
- ๐ **Financial Reports**: Daily/monthly sales summaries
### **3. Medicine Inventory Module**
- ๐ **Stock Management**: Track available quantities
- ๐
**Expiry Monitoring**: Alert for expiring medicines
- ๐ท๏ธ **Batch Tracking**: Manage batch numbers and dates
- ๐ฒ **Price Management**: Update and maintain pricing
- โ ๏ธ **Low Stock Alerts**: Inventory threshold warnings
### **4. Manufacturer Management Module**
- ๐ญ **Supplier Records**: Maintain manufacturer databases
- ๐ **Contact Information**: Store communication details
- ๐ฆ **Product Catalog**: Track supplied medicines
- ๐ค **Relationship Management**: Supplier interaction history
- ๐ **Contract Details**: Agreement and terms tracking
---
## ๐ Security Features
- **๐ Authentication System**: Secure login with credential validation
- **๐ Data Backup**: Automatic file-based backup system
- **๐ก๏ธ Input Validation**: Prevent malicious data entry
- **๐ Session Management**: Secure user session handling
- **๐ Audit Trail**: Track user activities and changes
- **โ ๏ธ Warning System**: Alert for unauthorized access attempts
---
## ๐ Future Enhancements
- ๐ **Enhanced Authentication**: Multi-user system with role-based access
- ๐ **Dark Mode Theme**: Modern UI with theme switching
- ๐ฑ **Mobile Compatibility**: Responsive design for tablets
- โ๏ธ **Cloud Integration**: Online backup and synchronization
- ๐ง **Email Notifications**: Automated alerts and reports
- ๐ **Advanced Analytics**: Business intelligence and insights
- ๐ **Auto-Updates**: Automatic software update system
- ๐ **Multi-Language**: Support for Arabic and other languages
- ๐ค **Data Export**: Excel and PDF report generation
- ๐ **Smart Alerts**: AI-powered inventory predictions
---
## โ ๏ธ Important Notes
- **๐ฅ Desktop Application**: Designed specifically for Windows desktop environments
- **๐๏ธ Database Dependency**: Requires SQL Server LocalDB for full functionality
- **๐ File Path Critical**: Ensure correct database file path configuration
- **๐ Credential Security**: Default login credentials should be changed in production
- **๐พ Regular Backups**: Implement regular data backup procedures
- **๐ฅ๏ธ System Requirements**: Verify .NET Framework compatibility
- **๐ง Development Environment**: Visual Studio required for code modifications
- **๐ Data Integrity**: Always validate data before making changes
---
## ๐ค Contributing
We welcome contributions to improve the Pharmacy Management System! Here's how to contribute:
### **Getting Started**
1. **Fork the repository** - Click the "Fork" button at the top right
2. **Clone your fork**
```bash
git clone https://github.com/YourUsername/Pharmacy-Management.git
```
3. **Create a feature branch**
```bash
git checkout -b feature/your-feature-name
```
4. **Make your changes**
- Follow C# coding standards
- Test thoroughly on Windows environment
- Update documentation as needed
5. **Commit your changes**
```bash
git add .
git commit -m "Add: detailed description of your changes"
```
6. **Push to your branch**
```bash
git push origin feature/your-feature-name
```
7. **Submit a Pull Request**
- Provide clear description of changes
- Include screenshots for UI modifications
- Reference any related issues
### **Contribution Guidelines**
- Follow Microsoft C# coding conventions
- Include unit tests for new functionality
- Update README for new features
- Ensure backward compatibility
- Test on multiple Windows versions
---
## ๐ช Feedback
๐ก **Found bugs or have suggestions?**
We value your feedback to make this system better!
**GitHub Issues**: [Report bugs or request features](https://github.com/OmarrSakr/Pharmacy-Management/issues)
**Email Contact**:
**What to Include:**
- Detailed bug descriptions
- Steps to reproduce issues
- System environment information
- Feature enhancement suggestions
- Screenshots if applicable
Your feedback helps improve healthcare management efficiency! ๐ฅ
---
## ๐ License
Licensed under the **MIT License**.
See the [LICENSE](./LICENSE.md) file for complete details.
---
**โญ If you found this project helpful, please give it a star! โญ**
*Built with โค๏ธ by Omar Sakr*
[](https://github.com/OmarrSakr)