Skip to content

Home

Jump to bottom
Nyasha Chizampeni edited this page Jan 3, 2025 · 3 revisions

Stock Dispensary Management System

Overview

The Stock Dispensary Management System is a web application developed using Django that offers a robust and efficient way to manage stock inventory, track customer transactions, forecast sales, and facilitate communication within a dispensary. It is designed to streamline the operations of stock management, ensuring accuracy, transparency, and efficiency.

Features

  • Stock Management:

    • Add, update, and delete stock items with detailed information such as name, quantity, price, and supplier details.
    • Monitor stock levels with real-time updates.

  • Customer Transactions:

    • Record and track customer purchases, including items bought, quantities, payment methods, and total amounts.
    • Generate transaction reports for analysis and auditing.

  • Sales Forecasting:

    • Use historical sales data to project future sales and revenue.
    • Make informed decisions on stock replenishment and sales strategies.

  • Stock Alerts:

    • Receive notifications when stock levels fall below a predefined threshold.
    • Ensure timely restocking to avoid shortages.

  • Internal Communication:

    • Facilitate communication between staff and management through an integrated messaging system.
    • Enhance collaboration and information sharing within the dispensary.

Installation

To set up the Stock Dispensary Management System locally, follow these steps:

  1. Clone the Repository:

    git clone https://github.com/your-username/Stock-dispensary-management-system.git

  2. Install Dependencies: Navigate to the project directory and install the required Python packages:

    pip install -r requirements.txt

  3. Run Database Migrations: Apply migrations to set up the database schema:

    python manage.py migrate

  4. Start the Development Server: Launch the application by starting the Django development server:

    python manage.py runserver

Usage

  1. Access the Application: Open your web browser and visit http://localhost:8000 to access the system.

  2. Login: Use the provided credentials to log in to the system.

  3. Navigation:

    • Stock Management: Manage inventory, update stock details, and track stock levels.
    • Customer Transactions: Record sales, view transaction history, and generate reports.
    • Sales Forecasting: View projected sales and revenue based on historical data.
    • Communication: Send and receive messages within the system.

Contributing

Contributions to the Stock Dispensary Management System are welcome! Whether you have ideas for new features, find a bug, or want to enhance the existing code, your contributions are appreciated. Here's how you can contribute:

  1. Fork the Repository: Create a fork of the project repository to make your changes.

  2. Create a New Branch: Create a new branch for your feature or bug fix:

    git checkout -b feature-name

  3. Make Your Changes: Implement your changes in the new branch.

  4. Submit a Pull Request: Push your changes to your fork and submit a pull request to the main repository. Be sure to describe your changes and link any related issues.

License

This project is licensed under the MIT License.

Clone this wiki locally