Alertr is a comprehensive system that generates a prior list of medicines which expire in a month and alerts the admin by sending a notification whenever a medicine expires.

📋 Table of Contents

• 🌟 Overview
• 💫 Features
• ⚒️ Built Using
• 🚀 Getting Started
  • ⚙️ Prerequisites
  • 📦 Installation
  • 🏃 Running Locally
• 🎯 Usage
• 🤝 Contributing
• 📄 License

🌟 Overview

Today's pharmacies face challenges in predicting demand and minimizing losses due to medicine expiry. Alertr is a comprehensive system that generates a prior list of medicines which expire in a month and alerts the admin by sending a notification whenever a medicine expires.

💫 Features

1. Medicines Inventory Management:

   • Easily add, update, and manage medicines in your inventory.
   • Keep track of crucial details such as quantity, expiry date, and category.

2. Expiry Alerts:

   • Receive live updates on medicines set to expire in the next 50 days.
   • Customize the duration for expiry alerts based on your preferences.

3. Push Notifications:

   • Stay informed with live push notifications sent directly to your phone.
   • Receive alerts about expiring medicines, no matter where you are in the world.

4. AI Demand Prediction:

   • Harness the power of AI to predict the demand for specific products.
   • Optimize stock levels to reduce expiry losses and meet customer needs effectively.

5. Trending Product Recommendations:

   • AI-driven analysis of Google searches to identify the hottest new medical products.
   • Receive recommendations on adjusting stock levels for trending items.

⚒️ Built Using

🚀 Getting Started

This guide will walk you through the steps to install and run the Alertr locally on your machine.

⚙️ Prerequisites

---

Before you begin, make sure you have the following software installed on your machine:

• Node.js (version 16 or higher)
• npm (Node Package Manager)

📦 Installation

---

To install Alertr, follow these steps:

1. Clone the repository

   git clone https://github.com/ssrikanthreddy/Alertr.git

2. Navigate to the project directory

   cd Alertr

3. Install the required packages and libraries

   cd frontend
   npm i
   
   # Open a new terminal
   
   cd backend
   npm i

🏃 Running Locally

---

To run Alertr locally, follow these steps:

1. Start the server by running the appropriate command. For example, npm run dev in /frontend to start the development server using Vite. You will recieve a message similar to this:

   

2. On your device, hold down the Ctrl key (Windows) or Cmd key (Mac).

3. Left-click on the link to the app. For example, click on http://localhost:5173. This will automatically open the app in your default browser.

4. You should now see the Alertr web app running in your browser.

Please note that the actual link and port number may vary depending on your specific setup and configuration.

🎯 Usage

1. Inventory Management:

   • Add and manage medicines through the user interface.

2. Expiry Alerts:

   • View live updates on medicines expiring in the next 50 days.

3. Push Notifications:

   • Receive real-time push notifications on your phone for upcoming expiries.

4. AI Predictions:

   • Leverage AI insights to predict demand and optimize stock levels.

5. Trending Product Recommendations:

   • Stay ahead by stocking the hottest new medical products in the market.

🤝 Contributing

We appreciate your interest in contributing to our project! Whether you want to report a bug, propose new features, or submit improvements to the existing codebase, your contributions are highly valued.

To get started, please take a moment to review the guidelines outlined in the CONTRIBUTING.md file.

📞 Contact

For inquiries, please contact [[email protected]].

📄 License

Licensed under the MIT License.

⬆️