Poultry Management System - README

Overview

The Poultry Management System is a web application designed to streamline and optimize poultry farming operations. This system provides a comprehensive solution for tracking bird inventory, managing feed, monitoring egg production, and recording financial transactions. It enables poultry farmers to make data-driven decisions, improve productivity, and enhance profitability.

Features

1. Bird Inventory Management

• Track and manage bird populations by batch and breed.
• Record details like breed type, age, health status, and mortality.
• Monitor bird movements (in and out) and update the inventory in real-time.

2. Feed Management

• Log feed stock levels and track feed usage.
• Generate alerts for low feed stock to prevent shortages.
• Calculate daily feed requirements based on the number of birds and their growth stage.

3. Egg Production Tracking

• Record daily egg production by batch.
• Track quality and categorize eggs (e.g., large, medium, small).
• Analyze egg production trends over time to optimize outputs.

4. Financial Transactions and Expenses

• Record expenses (e.g., feed, labor, utilities) and income (e.g., egg sales, bird sales).
• View detailed financial reports to assess profitability.
• Generate daily, weekly, monthly, and yearly financial summaries.

5. Health and Medication Tracking

• Track health records for each batch, including vaccination schedules.
• Set reminders for scheduled vaccinations and medical checks.
• Record medications administered to maintain health and prevent disease.

6. Reports and Analytics

• Generate reports on bird population, feed consumption, egg production, and financials.
• Visualize data through charts for quick insights into production and cost trends.
• Export reports for record-keeping or sharing with stakeholders.

7. User Roles and Access Control

• Secure system access with roles like Admin, Manager, and Employee.
• Control access to sensitive data and limit permissions based on user roles.

Technologies Used

• Backend: PHP, Laravel (for secure and efficient backend processing)
• Frontend: HTML, CSS, JavaScript
• Database: MySQL (for data storage and retrieval)

Installation

Prerequisites

• PHP 7.4 or higher
• MySQL database
• Composer (for Laravel dependencies)
• A web server (e.g., Apache or Nginx)

Steps

1. Clone the Repository

   git clone https://github.com/phemcode/poultry-management-system.git
   cd poultry-management-system

2. Install Dependencies

   composer install
   npm install

3. Configure Environment Variables

   • Duplicate .env.example and rename it to .env.
   • Update the .env file with your database credentials and other configuration details.

4. Generate Application Key

   php artisan key:generate

5. Run Migrations

   php artisan migrate

6. Seed Database (Optional)

   • If sample data is required, you can seed the database.

   php artisan db:seed

7. Run the Application

   php artisan serve

   • Access the application at http://localhost:8000.

Usage

1. Login: Access the login page and use the credentials set during user creation.
2. Dashboard: The dashboard gives a quick overview of inventory, production, and financials.
3. Navigation: Use the side menu to access modules like Inventory, Feed Management, Egg Production, and Reports.
4. Reports: View and export reports under the Reports section for data-driven decision-making.

Contributing

To contribute to this project, follow these steps:

1. Fork the repository.
2. Create a new feature branch: git checkout -b feature-branch-name.
3. Make your changes and commit them: git commit -m 'Feature description'.
4. Push to the branch: git push origin feature-branch-name.
5. Submit a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contact

For any questions or support, please contact Phemcode at phemcode@live.com.

---

Thank you for using the Poultry Management System! We hope it helps you optimize and scale your poultry farming operations.