Skip to content

README.md

Latest commit

 

History

History
66 lines (46 loc) · 1.82 KB

README.md

File metadata and controls

66 lines (46 loc) · 1.82 KB
Raw

Poultry Farm Management System

A complete web-based system for managing poultry farms — from flock health and production to sales, finance, and client orders.

What this is

If you run a poultry farm, this replaces scattered spreadsheets and manual logs with one system. It covers:

  • Flock management — batches, mortality, growth tracking
  • Production — egg production, feed conversion, daily records
  • Health — vaccinations, medications, vet visits
  • Sales — orders, invoices, customers, delivery tracking
  • Finance — expenses, income, profitability
  • Client portal — order placement, tracking, history
  • Users & roles — admin, farm manager, staff
  • Support — in-app support and subscription requests

Tech stack

  • Backend: PHP 8+
  • Database: MySQL / MariaDB
  • Frontend: HTML, CSS, JavaScript
  • Server: Apache with .htaccess

Quick start

git clone https://github.com/dicksonmaina/poultry-farm-system.git
cd poultry-farm-system
cp .env.example .env
# Edit .env with your DB credentials
# Import database schema from database/support_requests.sql and seed.php/setup.php
php -S localhost:8000

Setup

  1. Clone the repo
  2. Copy .env.example to .env and update credentials
  3. Create a MySQL database
  4. Import schema and seed data
  5. Serve with Apache or PHP built-in server
  6. Access via browser and create admin user via setup.php

Support

Use the in-app Support page to request setup help, custom modules, or an ongoing support subscription.

Typical engagements:

  • Installation and setup: from $50
  • Custom module development: from $100
  • Ongoing support: from $20/month

Contact: Richard Dickson Maina

Contributing

See CONTRIBUTING.md

Changelog

See CHANGELOG.md

License

MIT — see LICENSE