🚀 Pharmacy-Storage System

🌟 Overview

This project is a Pharmacy-Storage Management System that connects pharmacies with storage facilities (drug stores). The system allows pharmacies to place orders from drug stores, manage their stock, and communicate efficiently.

---

🌍 Deployment

The project is deployed using Koyeb at the following link: 🔗 https://pflow.koyeb.app

🌐 Access the Live Application

🔗 https://pflow.koyeb.app

📩 Postman API Collection

You can test the API using Postman Workspace:

🔗 Postman Workspace

---

🔥 Features

✅ Authentication: Login and registration for pharmacies and drug stores. ✅ User Management: Management of pharmacies, drug stores, and admin roles. ✅ Medicine Management: Add, update, and view medicines. ✅ Orders System: Create, track, and manage orders between pharmacies and drug stores. ✅ Location-based Search: Find the nearest drug store based on pharmacy location. ✅ Messaging System: Communication between pharmacies and drug stores. ✅ Reports & Analytics: Track orders, stock levels, and sales performance.

---

🛠 Technologies Used

⚙ Backend

• 🟢 Node.js
• ⚡ Express.js

💾 Database

• 🍃 MongoDB
• 🔴 Mongoose

🔧 Version Control

• 🔴 Git
• 🟡 GitHub

📦 Other Tools

• 🔴 Postman (API Testing)

🚀 Deployment

• 🔴 Koyeb (Hosting Service)
• 📊 Monitoring & Logging

---

⚡ Installation

1️⃣ Clone the Repository

git clone https://github.com/youssefrramdan/Graduation-Project.git
cd pharmacy-storage-system

2️⃣ Install Dependencies

npm install

3️⃣ Set Up Environment Variables

Create a .env file in the root directory and configure the following variables:

# Server Configuration
PORT=8000
NODE_ENV=development

# Database Configuration
DB_USER=your_database_username
DB_PASSWORD=your_database_password
DB_NAME=your_database_name
DB_URI=your_mongodb_connection_string

# JWT Configuration
JWT_SECRET_KEY=your_jwt_secret
JWT_EXPIRE_TIME=3d

# Email Configuration
EMAIL_USER=your_email@example.com
EMAIL_PASS=your_email_password

⚠ Make sure not to share these credentials publicly and add .env to .gitignore.

4️⃣ Run the Application

npm run start:dev

The server will run at http://localhost:8000.

---

📌 API Endpoints

User Routes (/api/v1/users)

Method	Endpoint	Description
GET	/	Get all users
POST	/	Create a new user (protected)
GET	/:id	Get specific user
PUT	/:id	Update user profile (protected)
DELETE	/:id	Delete a user (protected)
PATCH	/changePassword/:id	Change user password (protected)
PATCH	/activate/:id	Activate a specific user (protected)

Authentication Routes (/api/v1/auth)

Method	Endpoint	Description
POST	/signup	Register a new user (with file upload)
GET	/verify/:token	Confirm email verification
POST	/login	Login user
POST	/forgetpassword	Request password reset
POST	/verifyResetCode	Verify reset code
PUT	/resetPassword	Reset password

Prescription Analysis Endpoint (/api/v1/drugs/prescription/analyze)

POST /api/v1/drugs/prescription/analyze

Description: تحليل صور الروشتات الطبية واستخراج معلومات الأدوية

Authentication: Required (Bearer Token)

Request:

• Method: POST
• Content-Type: multipart/form-data
• Body:
  • image: صورة الروشتة (jpeg, jpg, png)

Response Example:

{
  "status": "success",
  "message": "Prescription analyzed successfully",
  "data": {
    "imageUrl": "https://res.cloudinary.com/dqicm2ir2/raw/upload/v1750502532/prescriptions/image-1750502531848-photo.jpg",
    "prescription": {
      "patient": {
        "name": "Patient Name",
        "age": 30,
        "gender": "Male"
      },
      "doctor": {
        "name": "Dr. Doctor Name",
        "license": "68237"
      },
      "prescriptionDate": "2022-10-17",
      "medications": [
        {
          "name": "Diab Hamlo",
          "dosage": "1mg",
          "frequency": "Once a day",
          "duration": "20 days"
        },
        {
          "name": "Tab. Arvont",
          "dosage": "1mg",
          "frequency": "Once a day",
          "duration": "30 days"
        }
      ],
      "additionalNotes": "k/c/o - Hypertension & Hypothyroid\nc/o - Fever since 3 days...",
      "medicationsCount": 4
    },
    "apiResponse": {
      "success": true,
      "message": "Prescription processed successfully"
    }
  }
}

Error Responses:

• 400: No prescription image provided
• 408: Request timeout
• 500: Analysis failed or invalid API response

---

⚠ Error Handling

The application supports global error handling for:

• ❌ Unhandled Promise Rejections
• ❌ Uncaught Exceptions
• ❌ Invalid Routes

---

🤝 Contributing

Contributions are welcome! Feel free to fork the repository and submit pull requests.

---

📜 License

This project is licensed under the MIT License.

---