🏥 MedNet - Online Pharmacy Management System

A comprehensive e-commerce platform for managing and selling pharmaceutical products online.

Features • Installation • Usage • Admin Panel • Tech Stack

📖 About

MedNet is a modern, full-featured online pharmacy platform built with Laravel 12. It provides a complete e-commerce solution for selling medicines, supplements, and first-aid products with advanced features like prescription management, inventory tracking, promotional campaigns, and comprehensive admin analytics. Live Deployed Server Link: https://mednet-gyfn.onrender.com

✨ Features

🛒 Customer Features

Product Management

📦 Product Catalog: Browse 200+ medical products across three categories:
- 💊 Medicines (prescription & non-prescription)
- 🌿 Supplements & Vitamins
- 🏥 First Aid Supplies
🔍 Advanced Search: Real-time search with product name, generic name, and description matching
🏷️ Smart Filtering: Filter by category, manufacturer, price range, and stock status
💰 Discounts: Automatic discount calculations with updated pricing display

Shopping Experience

🛍️ Shopping Cart:
- Add/remove products with quantity control
- Real-time cart count updates
- Prescription upload for restricted medicines
- Cart persistence across sessions
⚡ Quick Buy: One-click purchase for frequently ordered items
📋 Wishlist Management: Save favorite products for later

Checkout & Orders

🏠 Address Management:
- Multiple saved addresses with alias names
- Inside/Outside Dhaka distinction for shipping
- Default address selection
- Easy address CRUD operations
💳 Secure Checkout:
- Order summary with itemized pricing
- Cash on Delivery payment method
- Prescription verification for restricted products
- Order confirmation with detailed receipt
📦 Order Tracking:
- View order history
- Track order status (pending, processing, shipped, delivered, cancelled)
- Order details with product list
- Delivery time estimates

User Profile

👤 Profile Management: Update personal information
🔐 Account Security: Email verification and password management
📍 Address Book: Manage multiple delivery addresses
📜 Order History: Complete purchase history with reorder capability

Support & Communication

💬 Support Feedback System: Submit queries and issues
📧 Email Notifications: Order confirmations and updates
❓ Help Center: FAQ and product information

🎛️ Admin Panel Features

Dashboard & Analytics

📊 Real-time Statistics:
- Total revenue and sales metrics
- Product inventory status
- Order volume tracking
- User registration trends
📈 Visual Analytics:
- Sales charts and graphs
- Revenue by product category
- Top-selling products
- Order status distribution
- Monthly/weekly/daily trends

Product Management

➕ Add Products: Complete product creation with:
- Name, generic name, and description
- Dosage and manufacturer details
- Pricing with discount support
- Stock quantity and low stock threshold
- Expiry date tracking
- Category and tag assignment
- Image upload
- Side effects documentation
- Prescription requirement flag
✏️ Edit Products: Update all product details
🗑️ Delete Products: Remove discontinued items
📦 Stock Management:
- Automatic stock status (normal/low_stock/out_of_stock)
- Bulk stock updates
- Expiry date alerts
🔍 Product Search: Quick product lookup in admin panel

Order Management

📋 Order Overview:
- List all orders with filtering
- Order status tracking
- Customer information
- Order value and items
✅ Order Processing:
- Update order status
- Mark as shipped/delivered
- Cancel orders with reason
- View order details
💊 Prescription Approval:
- Review uploaded prescriptions
- Approve/reject prescription-required orders
- Prescription image viewer
- Order notes and communication

User Management

👥 User Administration:
- View all registered users
- User search and filtering
- Account status management
- Ban/unban users
- View user order history
🚫 Email Banning: Block email addresses from registration
📊 User Analytics: Registration trends and user activity

Promotional Management

🎨 Promotion Slider:
- Upload promotional banners
- Set display order
- Enable/disable promotions
- Add title and description
- Alt text for accessibility
- Manage up to 6 active promotions
🎯 Discount Campaigns: Create product-specific discounts

Support Management

📨 Feedback System:
- View customer support requests
- Categorize feedback (bug, feature request, general)
- Assign status (pending, in progress, resolved, closed)
- Respond to customer queries
- Priority management

Reports & Insights

📑 Sales Reports: Generate revenue reports by date range
📊 Inventory Reports: Stock levels and low stock alerts
📈 Performance Metrics: Key business indicators

🛠️ Tech Stack

Backend

Framework: Laravel 12.0
PHP Version: 8.2+
Database: SQLite (portable and included)
Authentication: Laravel Breeze
ORM: Eloquent

Frontend

CSS Framework: Tailwind CSS 3.0
JavaScript: Vanilla JS with Alpine.js components
Build Tool: Vite
Icons: Font Awesome / Heroicons

Development Tools

Code Quality: Laravel Pint (PHP CS Fixer)
Debugging: Laravel Telescope (optional)
API Testing: Laravel Pail
Development Server: Laravel Sail (Docker) or Artisan serve

📋 Requirements

PHP >= 8.2
Composer
Node.js >= 18.x & NPM
SQLite extension enabled
Git

🚀 Installation

1. Clone the Repository

git clone https://github.com/samixshady/MedNet.git
cd MedNet

2. Install PHP Dependencies

composer install

3. Install JavaScript Dependencies

npm install

4. Environment Configuration

# Copy the example environment file
cp .env.example .env

# Generate application key
php artisan key:generate

5. Database Setup

The project includes a pre-populated SQLite database with 205+ products. If you want to start fresh:

# Run migrations
php artisan migrate

# Seed the database with sample data
php artisan db:seed

# Create admin user
php artisan db:seed --class=CreateAdminSeeder

6. Create Storage Symlink

php artisan storage:link

7. Build Frontend Assets

# For development
npm run dev

# For production
npm run build

8. Start the Development Server

php artisan serve

Visit http://127.0.0.1:8000 in your browser.

👤 Default Credentials

Admin Account

Email: admin@admin.com
Password: adminadmin

Test User Account

Email: duck@duck.com
Password: password

⚠️ Important: Change these credentials in production!

📖 Usage

For Customers

Register/Login: Create an account or log in at the homepage
Browse Products: Navigate through Medicine, Supplements, or First Aid categories
Search: Use the search bar to find specific products
Add to Cart: Select products and specify quantity
Upload Prescription: For prescription medicines, upload your prescription in cart
Checkout: Add delivery address and complete your order
Track Orders: View order status in your profile

For Administrators

Admin Login: Access admin panel at /admin/login
Dashboard: View analytics and quick stats
Manage Products: Add, edit, or remove products
Process Orders: Review and update order status
Review Prescriptions: Approve prescription-based orders
User Management: Monitor and manage user accounts
Promotions: Update promotional banners
Support: Respond to customer feedback

📁 Project Structure

MedNet/
├── app/
│   ├── Http/
│   │   ├── Controllers/        # Application controllers
│   │   │   ├── Admin/          # Admin panel controllers
│   │   │   ├── Auth/           # Authentication controllers
│   │   │   └── ...
│   │   ├── Middleware/         # Custom middleware
│   │   └── Requests/           # Form request validation
│   ├── Models/                 # Eloquent models
│   │   ├── User.php
│   │   ├── Product.php
│   │   ├── Order.php
│   │   └── ...
│   ├── Policies/               # Authorization policies
│   └── Providers/              # Service providers
├── database/
│   ├── migrations/             # Database migrations
│   ├── seeders/                # Database seeders
│   ├── factories/              # Model factories
│   └── database.sqlite         # SQLite database
├── public/
│   ├── css/                    # Compiled CSS
│   ├── js/                     # Compiled JavaScript
│   └── storage/                # Public storage symlink
├── resources/
│   ├── css/                    # Source CSS files
│   ├── js/                     # Source JavaScript files
│   └── views/                  # Blade templates
├── routes/
│   ├── web.php                 # Web routes
│   ├── auth.php                # Authentication routes
│   └── console.php             # Console commands
├── storage/
│   └── app/
│       └── public/             # User uploaded files
│           ├── products/       # Product images
│           └── promotions/     # Promotion banners
└── tests/                      # Application tests

🔒 Security Features

✅ CSRF Protection: All forms protected with CSRF tokens
✅ SQL Injection Prevention: Using Eloquent ORM with prepared statements
✅ XSS Protection: Automatic output escaping with Blade templates
✅ Password Hashing: Bcrypt hashing for user passwords
✅ Email Verification: Optional email verification for new accounts
✅ Admin Middleware: Role-based access control for admin routes
✅ File Upload Validation: Strict validation for prescription uploads
✅ Session Security: Secure session management
✅ Rate Limiting: API rate limiting to prevent abuse

🗃️ Database Schema

Key Tables

users: User accounts with admin flags
products: Product catalog with pricing, stock, and metadata
categories: Product categorization
orders: Customer orders with status tracking
order_items: Individual items within orders
carts: Shopping cart items
quick_buys: Saved items for quick purchasing
addresses: Customer delivery addresses
promotions: Promotional banner management
support_feedback: Customer support tickets
banned_emails: Email blacklist

🛠️ Available Artisan Commands

# Run migrations
php artisan migrate

# Seed database with products
php artisan db:seed

# Create admin user
php artisan db:seed --class=CreateAdminSeeder

# Import MySQL data to SQLite
php artisan db:seed --class=MySQLDataImportSeeder

# Assign random product images
php artisan db:seed --class=AssignRandomImagesSeeder

# Clear application cache
php artisan cache:clear
php artisan config:clear
php artisan route:clear
php artisan view:clear

# Run code formatter
./vendor/bin/pint

🔧 Configuration

Environment Variables

Key configurations in .env:

APP_NAME=MedNet
APP_ENV=local
APP_DEBUG=true
APP_URL=http://localhost

DB_CONNECTION=sqlite
DB_DATABASE=/absolute/path/to/database.sqlite

MAIL_MAILER=smtp
MAIL_HOST=smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=null
MAIL_PASSWORD=null

File Storage

Product images and promotional banners are stored in:

storage/app/public/products/
storage/app/public/promotions/

Accessed via the public symlink: public/storage/

📱 Responsive Design

MedNet is fully responsive and works seamlessly across:

💻 Desktop computers
📱 Mobile phones
📲 Tablets
🖥️ Large displays

🐛 Common Issues & Solutions

Issue: Images not displaying

Solution: Run php artisan storage:link

Issue: Permission errors

Solution:

chmod -R 775 storage bootstrap/cache

Issue: Database not found

Solution: Ensure .env has correct DB_DATABASE path

Issue: CSS not loading after installation

Solution: Run npm run build

🤝 Contributing

Contributions are welcome! Please follow these steps:

Fork the repository
Create a feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Samix Shady

GitHub: @samixshady
Project Link: https://github.com/samixshady/MedNet

🙏 Acknowledgments

Laravel Framework
Tailwind CSS
Laravel Breeze for authentication scaffolding
All open-source contributors

📞 Support

For support, email support@mednet.com or create an issue in the GitHub repository.

⭐ Star this repository if you find it helpful!

Made with ❤️ using Laravel

Name		Name	Last commit message	Last commit date
Latest commit History 137 Commits
.github/workflows		.github/workflows
api		api
app		app
bootstrap		bootstrap
config		config
database		database
docker		docker
public		public
resources		resources
routes		routes
storage		storage
tests		tests
vendor		vendor
.dockerignore		.dockerignore
.editorconfig		.editorconfig
.env.example		.env.example
.gitattributes		.gitattributes
.gitignore		.gitignore
.render-build.sh		.render-build.sh
.styleci.yml		.styleci.yml
Dockerfile		Dockerfile
Procfile		Procfile
README.md		README.md
artisan		artisan
composer.json		composer.json
composer.lock		composer.lock
nixpacks.toml		nixpacks.toml
package-lock.json		package-lock.json
package.json		package.json
phpunit.xml		phpunit.xml
postcss.config.js		postcss.config.js
railway.json		railway.json
render.yaml		render.yaml
tailwind.config.js		tailwind.config.js
vercel.json		vercel.json
vite.config.js		vite.config.js

samixshady/MedNet

Folders and files

Latest commit

History

Repository files navigation

🏥 MedNet - Online Pharmacy Management System

📖 About

✨ Features

🛒 Customer Features

Product Management

Shopping Experience

Checkout & Orders

User Profile

Support & Communication

🎛️ Admin Panel Features

Dashboard & Analytics

Product Management

Order Management

User Management

Promotional Management

Support Management

Reports & Insights

🛠️ Tech Stack

Backend

Frontend

Development Tools

📋 Requirements

🚀 Installation

1. Clone the Repository

2. Install PHP Dependencies

3. Install JavaScript Dependencies

4. Environment Configuration

5. Database Setup

6. Create Storage Symlink

7. Build Frontend Assets

8. Start the Development Server

👤 Default Credentials

Admin Account

Test User Account

📖 Usage

For Customers

For Administrators

📁 Project Structure

🔒 Security Features

🗃️ Database Schema

Key Tables

🛠️ Available Artisan Commands

🔧 Configuration

Environment Variables

File Storage

📱 Responsive Design

🐛 Common Issues & Solutions

Issue: Images not displaying

Issue: Permission errors

Issue: Database not found

Issue: CSS not loading after installation

🤝 Contributing

📝 License

👨‍💻 Author

🙏 Acknowledgments

📞 Support

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Languages

Packages