Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Penzi Farm ERP Logo

Penzi Farm ERP

Enterprise Livestock, Farm Operations, Finance and Business Management System

Laravel 12 PHP 8.4 Filament Admin MySQL and MariaDB Production Ready Private Repository


Overview

Penzi Farm ERP is a comprehensive farm and livestock management platform built with Laravel 12, PHP 8.4 and Filament.

The system centralizes livestock records, breeding, health, laboratory requests, feeding, animal movement, inventory, procurement, sales, accounting, human resources, payroll, reporting and management analytics in one secure platform.

Penzi Farm ERP is designed to improve:

  • Livestock traceability
  • Farm operational control
  • Animal health monitoring
  • Financial accountability
  • Stock and procurement management
  • Management reporting
  • Data-driven decision-making
  • Role-based accountability

Core Modules

1. Livestock Management

  • Central animal registry
  • Automatic and controlled animal tag generation
  • Breed and breed-category classification
  • Animal photographs and supporting records
  • Sire and dam lineage tracking
  • Birth and acquisition records
  • Current weight and historical weight tracking
  • Current animal location assignment
  • Animal lifecycle management
  • Animal status tracking:
  • Active
  • Sold
  • Dead
  • Culled
  • Transferred
  • Archived
  • Animal profile reports
  • Bulk animal PDF reports
  • Archive and restore functionality
  • Sale-readiness and breeder classification

2. Breed Management

  • Breed categories and parent classifications
  • Breed prefixes
  • Breed descriptions
  • Breed-specific animal filtering
  • Breed avatars and supporting information
  • Breed population reporting
  • Dynamic breed PDF reports

3. Animal Location Management

  • Farm stations
  • Paddocks
  • Sheds and barns
  • Animal pens and housing units
  • Quarantine and isolation areas
  • Grazing areas
  • Feed and storage locations
  • Default animal location
  • Active and inactive locations
  • GPS coordinates
  • OpenStreetMap integration
  • Animal population by location
  • Bulk location reporting
  • Safe deletion controls for occupied locations

4. Animal Transfers and Movement

  • Transfer animals between farm locations
  • Transfer number generation
  • Origin and destination locations
  • Breed-based animal tag selection
  • Pending, completed, draft and cancelled transfers
  • Animal receipt workflow
  • Automatic animal location updates after receipt
  • Transfer preparation and receipt accountability
  • Transfer notes and reasons
  • Individual and bulk transfer PDF reports
  • Animal movement dashboard
  • Recent transfers
  • Transfers received today
  • Monthly transfer statistics
  • Location population distribution

5. Dynamic Animal Groups

  • Manual animal groups
  • Dynamic smart groups
  • Automatic member synchronization
  • Group animals by:
  • Location
  • Breed
  • Sex
  • Active-animal-only filtering
  • Archived-animal exclusion
  • Group member history
  • Breeding groups
  • Feeding groups
  • Health-monitoring groups
  • Sales preparation groups
  • Location-based groups
  • Group PDF reports
  • Group synchronization controls

6. Weight Intelligence

  • Individual animal weight records
  • Historical weight tracking
  • Current weight calculations
  • Weight gain and weight loss detection
  • Stable-weight detection
  • Growth performance monitoring
  • Breed-based weight analysis
  • Animal weight trends
  • Bulk weight reports
  • Weight analytics dashboards
  • Printable management reports

7. Breeding Management

  • Controlled breeding records
  • Sire and dam selection
  • Parent validation
  • Lineage protection
  • Mating records
  • Pregnancy monitoring
  • Expected delivery dates
  • Birth and offspring records
  • Breeding performance analysis
  • Breeder-animal identification
  • Genetic traceability support

8. Animal Health Management

  • Vaccination records
  • Deworming records
  • Dipping records
  • Preventive health schedules
  • Treatment administration
  • Disease and diagnosis records
  • Medication history
  • Veterinary notes
  • Health attachments
  • Next-due-date calculation
  • Monthly, quarterly, semi-annual and annual schedules
  • Multiple-animal health administration
  • Breed-based and tag-based animal selection
  • Health history per animal

9. Treatment Management

  • Animal treatment requests
  • Diagnosis records
  • Prescribed medication
  • Dosage and administration details
  • Treatment dates
  • Veterinary officers
  • Follow-up dates
  • Treatment outcomes
  • Treatment attachments
  • Medication usage history
  • Animal treatment PDF reports

10. Laboratory Management

  • Animal laboratory requests
  • Test categories
  • Specimen details
  • Requested laboratory tests
  • Request and collection dates
  • Results received dates
  • Laboratory report uploads
  • Result summaries
  • Recommended action
  • Veterinary review workflow
  • Laboratory status tracking
  • Animal laboratory history

11. Feeding Management

  • Feed categories
  • Feed products and materials
  • Feeding schedules
  • Feed allocation by animal group
  • Feed allocation by location
  • Feeding records
  • Feed consumption monitoring
  • Feed-cost tracking
  • Feeding notes
  • Inventory-linked feed usage
  • Feed stock deductions
  • Feeding performance reports

12. Inventory Management

  • Inventory item register
  • Item categories and units
  • Batch tracking
  • Stock quantities
  • Stock movement history
  • Reorder levels
  • Low-stock alerts
  • Expiry-date monitoring
  • Store and location assignment
  • Medication inventory
  • Feed inventory
  • Farm consumables
  • Equipment and supplies
  • Stock valuation
  • Inventory audit history

13. Procurement Management

  • Supplier management
  • Purchase requisitions
  • Purchase orders
  • Purchase-order items
  • Goods received notes
  • Procurement approvals
  • Item-level tax handling
  • Supplier invoices
  • Procurement payments
  • Inventory updates from received purchases
  • Procurement status workflow
  • Procurement PDF documents
  • Supplier performance tracking

14. Sales and Customer Management

  • Customer records
  • Customer contact details
  • KRA PIN records
  • Customer geographic intelligence
  • Animal sales invoices
  • Multiple animals per invoice
  • Sale-price and premium calculations
  • Discounts, tax and other charges
  • Paid, partially paid and unpaid invoices
  • Payment records
  • Outstanding balances
  • Animal-sale status synchronization
  • Customer statements
  • Invoice payment instructions
  • M-Pesa and bank-payment information
  • Sales invoice PDFs
  • Receipt and payment reports
  • QR-verifiable invoices
  • Safe invoice and payment deletion controls

15. Customer Geo Intelligence

  • Customer geographic distribution
  • Customer coordinates
  • County and regional analysis
  • Customer map visualization
  • Buyer concentration analysis
  • Location-based sales insights
  • Customer purchase patterns
  • Sales-region intelligence

16. Accounting and Finance

Penzi Farm ERP includes a structured double-entry accounting framework where:

Total Debits = Total Credits

Accounting capabilities include:

  • Chart of accounts
  • Fiscal years
  • Accounting periods
  • Cost centres
  • Journal entries
  • Journal-entry lines
  • Opening balances
  • Account mappings
  • Tax settings
  • Funding sources
  • Director funding
  • Project funds
  • Project-fund transactions
  • Bank and account reconciliations
  • Reconciliation lines
  • Financial audit trail

Financial Reports

  • Trial Balance
  • General Ledger
  • Profit and Loss Statement
  • Balance Sheet
  • Account activity reports
  • Funding reports
  • Reconciliation reports
  • Printable financial statements
  • Dynamic PDF headers and footers

17. Human Resources and Payroll

  • Employee records
  • Staff departments and positions
  • Employment information
  • Attendance tracking
  • Leave applications
  • Leave approvals
  • Payroll processing
  • Salary records
  • Allowances and deductions
  • PAYE calculations
  • NSSF calculations
  • SHA deductions
  • Payroll reports
  • Employee documentation
  • Role-based HR access

18. Farm Assets

  • Farm asset register
  • Asset numbers
  • Asset categories
  • Asset acquisition details
  • Asset valuation records
  • Maintenance records
  • Asset condition tracking
  • Asset assignments
  • Depreciation support
  • Asset reports

19. Crop and Farm Activities

  • Crop activity tracking
  • Farm activity records
  • Activity date ranges
  • Farm Activity Explorer
  • Animal population snapshots
  • Livestock status analysis
  • Management activity reports
  • Operational performance insights
  • Printable farm activity reports

20. Reports and Management Intelligence

  • Executive management dashboards
  • Farm Activity Explorer
  • Animal movement dashboard
  • Sales analytics
  • Financial reporting
  • Livestock population analytics
  • Weight performance reports
  • Health and treatment reports
  • Inventory reports
  • Procurement reports
  • HR and payroll reports
  • Location reports
  • Animal-group reports
  • Transfer reports
  • Bulk record printing
  • Date-range filtering
  • Director-level management summaries

PDF Reporting Engine

Penzi Farm ERP contains a branded PDF reporting engine with:

  • Dynamic farm name
  • Dynamic logo
  • Farm tagline
  • Farm phone number
  • Farm email address
  • Farm location and county
  • Dynamic primary and secondary theme colours
  • Dynamic authorized signature
  • Dynamic official stamp
  • QR-code verification
  • Logo watermark
  • Generated-by user and role
  • EAT print timestamps
  • Repeating page headers and footers
  • Page numbering
  • Courier report typography
  • Portrait and landscape layouts
  • Individual and bulk reports

Security and Access Control

  • Role-based access control
  • Spatie Laravel Permission integration
  • Resource-level permissions
  • Page-level permissions
  • Action-level permissions
  • View, create, edit and delete permissions
  • Print and export permissions
  • Approval permissions
  • Role-restricted dashboards
  • Protected financial information
  • Protected HR information
  • Audit-safe soft deletion
  • Restore controls
  • User activity tracking
  • Request audit tracking
  • Secure password hashing
  • Laravel authentication
  • Session protection
  • CSRF protection

Supported Roles

The system can support roles such as:

  • Administrator
  • Admin
  • Director
  • Manager
  • Accountant
  • Finance Officer
  • Human Resources Officer
  • Veterinary Officer
  • Storekeeper
  • Procurement Officer
  • Farm Supervisor
  • Sales Officer
  • Data Entry Officer

Permissions can be assigned independently to each role.


Audit and Accountability

  • User activity logging
  • Created-by records
  • Updated-by records
  • Transfer prepared-by tracking
  • Transfer received-by tracking
  • Approval tracking
  • Financial audit records
  • Record timestamps
  • Safe deletion rules
  • Soft-delete restoration
  • Request audit middleware
  • Traceable report generation

Global Settings and Branding

The system supports centralized settings for:

  • Farm name
  • Farm contact details
  • Farm address
  • County
  • Tagline
  • Primary theme colour
  • Secondary theme colour
  • Accent colour
  • Light-mode logo
  • Dark-mode logo
  • Authorized signature
  • Official stamp
  • Payment settings
  • Bank information
  • M-Pesa information
  • Email configuration

Global Email Engine

  • Central mail configuration
  • Configurable SMTP settings
  • Test-email support
  • System notifications
  • Invoice email support
  • Payment communication
  • Payroll communication
  • Report distribution
  • Audit-alert support

Key Features

  • Modern Filament administration interface
  • Responsive desktop, tablet and mobile layouts
  • Light and dark mode support
  • Modular ERP architecture
  • Real-time dashboard statistics
  • Searchable and filterable tables
  • Bulk record selection
  • Bulk deletion controls
  • Bulk PDF reporting
  • Soft deletes and restoration
  • Dynamic form filtering
  • Dependent breed and animal selectors
  • Location-aware animal selection
  • Automatic animal-group synchronization
  • Automated movement updates
  • Role-based permissions
  • Dynamic system branding
  • QR-verifiable documents
  • Secure audit trails
  • Production-ready reporting
  • Shared-hosting and VPS support

Technology Stack

Layer Technology
Backend Framework Laravel 12
Programming Language PHP 8.4
Administration Panel Filament
Authentication Laravel Authentication
Authorization Spatie Laravel Permission
Frontend Blade, Livewire and Tailwind CSS
Database MySQL / MariaDB
Charts Chart.js
PDF Engine DomPDF
QR Codes Simple QrCode
Package Management Composer and NPM
Version Control Git and GitHub
Supported Hosting VPS, cPanel and shared hosting

System Requirements

Before installation, ensure the server has:

  • PHP 8.4 or later
  • Composer 2
  • Node.js 20 or later
  • NPM
  • MySQL or MariaDB
  • PHP BCMath extension
  • PHP Ctype extension
  • PHP Fileinfo extension
  • PHP JSON extension
  • PHP Mbstring extension
  • PHP OpenSSL extension
  • PHP PDO extension
  • PHP Tokenizer extension
  • PHP XML extension
  • PHP GD extension
  • PHP ZIP extension

Installation

1. Clone the private repository

git clone git@github.com:maurice2428/PenziFarm.git
cd PenziFarm


Maintainer

Maurice Nzioki
Software Systems Developer

Copyright

Copyright © Penzi Farm.

All rights reserved.

This software is proprietary and confidential. It may not be copied, distributed, modified, sublicensed, published or deployed without written authorization from Penzi Farm and the system developer.

About

Penzi Farm ERP – livestock, health, breeding, feeding, inventory, sales, reporting and farm operations management system.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages