PharmApp

PharmApp is a pharmacy management application that facilitates managing medicine stocks, sales, and orders for pharmacies.

Installation

Follow these steps to install and run PharmApp locally.

Prerequisites

Make sure you have the following installed on your system:

• Composer
• PHP (^8.1)
• Laravel (^10)

Installation Steps

1. Clone this repository to your local machine using the following command:

   git clone https://github.com/emeryntumba/pharmapp.git

2. Navigate to the PharmApp directory:

   cd pharmapp

3. Install PHP dependencies via Composer:

   composer install

4. Copy the default environment file and configure your own values:

   cp .env.example .env

5. Generate a new application key:

   php artisan key:generate

6. Run migrations to create the database tables:

   php artisan migrate

7. Run seeder to create Admin role and Unknow customer

   php artisan db:seed

8. Start the development server:

   php artisan serve

9. Visit http://localhost:8000 in your browser to access PharmApp.

Features

• Management of medicine stocks.
• Tracking sales and orders.
• Management of seller users
• Low stock quantity notifications
• Generation of reports on sales and stocks.

Production Version

The production version of PharmApp is available at PharmApp.

Contribution

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

• Fork the Project
• Create your Feature Branch
• Commit your Changes
• Push to the Branch
• Open a Pull Request

License

PharmApp is licensed under the MIT License.