Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/osamasaddik/pharmageddon-backend
Pharmageddon simplifies pharmacy operations with secure authentication, order tracking, multi-language support, and integrated Firebase notifications.
https://github.com/osamasaddik/pharmageddon-backend
api-rest composer laravel mysql-database notifications php postman
Last synced: 13 days ago
JSON representation
Pharmageddon simplifies pharmacy operations with secure authentication, order tracking, multi-language support, and integrated Firebase notifications.
- Host: GitHub
- URL: https://github.com/osamasaddik/pharmageddon-backend
- Owner: osamasaddik
- License: mit
- Created: 2024-09-02T00:51:21.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2024-10-17T23:05:26.000Z (20 days ago)
- Last Synced: 2024-10-20T10:16:32.737Z (17 days ago)
- Topics: api-rest, composer, laravel, mysql-database, notifications, php, postman
- Homepage:
- Size: 9.55 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Pharmageddon Backend
[](https://www.php.net/)
[](https://laravel.com/)
[](https://www.mysql.com/)
[](https://getcomposer.org/)
[](https://jwt.io/)
[](https://firebase.google.com/)
[](https://www.postman.com/)
[](https://www.docker.com/)
## 💡 Project Overview
Pharmageddon is a comprehensive solution designed to streamline medication management for pharmacies. It offers both mobile and web applications, enabling users to browse, order, and track medications efficiently. The system includes features like secure authentication, real-time order tracking, detailed medicine information, and multi-language support. Built with Laravel for the backend and MySQL for data management, Pharmageddon ensures robust performance and security. The integration with Firebase allows real-time notifications, enhancing user experience. This project aims to simplify pharmacy operations, improve customer service, and ensure quick access to critical medication information across platforms.
## Table of Contents
- [✨ Features](#-features)
- [🛠️ Project Structure & Technologies Used](#️-project-structure--technologies-used)
- [📱📱 App Preview](#-app-preview)
- [👥 Team Members](#-team-members)
## ✨ Features
- **Secure Authentication**: Implements JWT-based authentication to ensure secure user sessions across both mobile and web platforms.
- **Medication Management**: Provides endpoints for creating, reading, updating, and deleting (CRUD) medication records, including detailed descriptions, manufacturer information, and effect categories.
- **Order Processing**: Manages order creation, status updates, and real-time tracking, facilitating efficient order handling for pharmacies.
- **Notification System**: Integrated with Firebase to send real-time push notifications about order status updates and other critical events.
- **Multi-language Support**: API endpoints are designed to handle multiple languages, enhancing accessibility for users in different regions.
- **Role-Based Access Control**: Supports different user roles (Admin, Pharmacist, User), each with specific permissions to ensure data security and operational integrity.
## 🛠️ Project Structure & Technologies Used
### Project Structure
The Pharmageddon backend follows a clean, modular architecture that separates concerns into different layers, making the system maintainable and scalable:
- **Controllers**: Handle incoming requests and return responses. Controllers are responsible for orchestrating the application flow by interacting with services and repositories.
- **Services**: Contain the business logic of the application, providing an abstraction over data processing and other operations.
- **Repositories**: Abstract the data layer, interacting with MySQL to perform CRUD operations.
- **Middleware**: Manages the request pipeline, ensuring secure authentication and authorization.
- **Models**: Represent the database entities, defining the schema and relationships for Laravel’s Eloquent ORM.
### Technologies Used
- **Laravel**: A PHP framework that provides an elegant syntax and powerful tools for building scalable web applications. Laravel’s MVC architecture ensures separation of concerns and facilitates the development of both simple and complex features.
- **MySQL**: A relational database management system used for storing and retrieving data. MySQL is chosen for its robustness, reliability, and compatibility with Laravel’s Eloquent ORM.
- **JWT Authentication**: JSON Web Tokens (JWT) are used to securely manage user sessions. JWT ensures that each request is authenticated without the need to constantly check session data on the server.
- **Firebase**: Used for sending real-time notifications. Firebase integration allows for seamless push notifications, improving user engagement and responsiveness.
## 📱 App Preview
### Authentication
#### Secure login and registration process for users.
### Medication - Manufacturer Browsing
#### Browse through medications and view manufacturer details and effects.
### Medication Details
#### Read all details, mark as favorite, select quantity, and add to cart.
### Cart Management
#### Manage your cart, edit quantities, and place orders.
### Order Tracking
#### Track the status of your orders in real-time.
### Order Details and Analytics
#### View detailed order information and analytics.
### Notifications - Profile
#### Receive real-time notifications from Firebase.
## 👥 Team Members
| S.No. | Team Member Name | GitHub | Technology |
| ----- | ----------------- | ---------------------------------------------------------- | --------------- |
| 1. | Ahmad Nour Haidar | [@Ahmad-Nour-Haidar](https://github.com/Ahmad-Nour-Haidar) | Flutter Mobile |
| 2. | Ayman Albonny | [@Ayman2023bo](https://github.com/Ayman2023bo) | Flutter Mobile |
| 3. | Osama Saddik | [@osamasaddik](https://github.com/osamasaddik) | Laravel Backend |