|
๐ฎ
Livestock Farm ManagementRun commercial poultry, dairy, beef, swine and aquaculture operations โ cycles, houses, feed, weighings, eggs, milk, multi-channel sales and PDF production reports in one unified Odoo application.
|
|
|
|
โถ WATCH IT IN ACTION
See Livestock Farm Management liveA guided tour through Broiler, Beef and Aquaculture cycles โ daily feed records, scaleโdriven weighings, mortality tracking, output batches and PDF reports โ endโtoโend in Odoo 19.
|
|
|
|
|
|
Need Help?Contact us at odoo@grevlin.com Follow us on X: @GrevlinGlobal โจ 30 days free support included |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
CRM (crm)
• Discuss (mail) • Inventory (stock) • Invoicing (account) • Manufacturing (mrp) • Project (project) • Purchase (purchase) • Calendar (calendar) • Contacts (contacts) • Employees (hr) |
| Community Apps Dependencies | Show |
| Lines of code | 17593 |
| Technical Name |
grev_od_livestock_farm |
| License | OPL-1 |
| Website | https://www.grevlin.com |
Livestock Farm Management - Documentation
Livestock Farm Management is a multi-species commercial livestock application for Odoo 19.0. One data model covers poultry, dairy, beef, swine and aquaculture - from placement to sale, with full cost accounting and an operational KPI dashboard.
Overview
The module bundles all daily barn and field activity (feed, weighing, mortality, eggs, milk) into a structured cycle record, rolls every feed/medicine/labor/ overhead cost into an analytic cost center, and routes the finished output to the right sales channel through dedicated CRM teams.
Key Features
- Multi-species support - poultry (broilers, layers, breeders), dairy, beef, swine and aquaculture share the same data model.
- Locations & houses - hierarchical farm, location, house and pen model with an occupancy state machine for All-in-All-out flow.
- Cycles & groups - production cycles and animal groups with intake count, species and live KPIs (FCR, ADG, survival, projected harvest).
- Activity protocols & calendars - reusable feeding, vaccination and cleaning templates, instantiated as calendars that generate scheduled daily actions automatically.
- Daily operations - feed, weighing (scale-integrated), mortality, egg and milk records with automatic KPI aggregation.
- Cost accounting - feed, labor, overhead and medicine/vet costs post journal entries with analytic distribution; cost rolls up from group to cycle in a dedicated Financial Summary tab.
- IoT & scale integration - house sensor readings and hardware scale capture via the Grevlin Scale Reader.
- Output batches - finalize a cycle into an output batch that creates stock.lot records and an outgoing picking, ready for sale.
- Multi-channel sales - dedicated CRM teams for direct, cooperative and contract-farming channels.
- OWL dashboard - filter bar, KPI banner and time-series charts for FCR, ADG, mortality, egg/milk output and production volume.
- QWeb PDF reports - five production and financial reports at cycle, group and output-batch level.
Installation
- Copy the grev_od_livestock_farm directory into your Odoo addons path.
- The module depends on grev_od_scale_reader and grev_od_contract_base. Install these first.
- Update the app list and install :guilabel:`Livestock Farm Management`.
Note
grev_od_livestock_farm is fully standalone. It can be installed alongside grev_od_crops_farm on mixed-farm operations -- both modules independently extend crm.team with the farm channel kind selector.
Configuration
Setting Up Your Farm
- Go to :menuselection:`Livestock Farm --> Configuration --> Farm Types` and review the pre-seeded species (poultry, dairy, beef, swine, aquaculture).
- Go to :menuselection:`Livestock Farm --> Operations --> Locations` and create your farm locations.
- Go to :menuselection:`Livestock Farm --> Operations --> Houses` and create houses or pens under each location.
- Go to :menuselection:`Livestock Farm --> Configuration --> Activity Protocols` and define your feeding and health templates.
- Go to :menuselection:`Livestock Farm --> Configuration --> Settings` to set the farm analytic plan, operations journal and expense accounts per cost category (feed, medicine, labor, overhead).
Tip
:menuselection:`Configuration --> Worker Types` lets you define categories for temporary and casual labor (day laborer, contractor, seasonal) with a default rate and rate type, used by Labor Records.
Security Groups
Three security tiers are provided via res.groups.privilege:
- User - read-only access.
- Officer - create and update, no delete.
- Manager - full access including configuration.
Usage
Starting a Cycle
- Navigate to :menuselection:`Livestock Farm --> Operations --> Cycles`.
- Click :guilabel:`Create` and select the species, house, intake count and start date.
- Save and click :guilabel:`Activate` to instantiate the cycle project and analytic account, and to generate any fixed-cost overhead from templates.
Logging Daily Activity
| Record | Menu | Species |
|---|---|---|
| Feed | :menuselection:`Daily Records --> Feed Records` | All |
| Weighing | :menuselection:`Daily Records --> Weighings` | All |
| Mortality | :menuselection:`Daily Records --> Mortality` | All |
| Eggs | :menuselection:`Daily Records --> Egg Records` | Poultry (layers/breeders) |
| Milk | :menuselection:`Daily Records --> Milk Records` | Dairy |
| Labor | :menuselection:`Daily Records --> Labor Records` | All |
| Overhead | :menuselection:`Daily Records --> Overhead Costs` | All |
Tip
Weighings pull the live reading from the scale device linked to the house - no manual keying required.
Cost Accounting & Analytics
Every cost-bearing record - feed, labor, overhead and medicine/vet actions - carries an analytic_distribution field (Odoo 19 JSON-based analytic mixin), so costs can be split across analytic cost centers with fine-grained precision. Confirming a feed record or completing a costed activity action posts a real stock.move from the house location and journals the expense to the configured account.
Analytic cost centers are auto-created at farm-type, cycle and group level. Each group rolls its feed, medicine, labor and overhead costs into a total cost shown in its Financial Summary tab; cycle totals roll up from all groups. Fixed-cost templates can also auto-generate recurring overhead records (litter, cleaning, water, etc.) scaled per cycle, per day, per group, per head or per mยฒ of house when a cycle activates or a group is created.
IoT & Scale Integration
House environment readings are captured through :menuselection:`Livestock Farm --> Operations --> Sensor Readings`. Weight-bearing records (weighing, milk sessions, output batches) carry a scale_device_id and last_scale_reading_id linking to the Grevlin Scale Reader (grev_od_scale_reader); a scale capture button next to the weight field opens the reader and applies the last reading with zero manual entry.
Finalizing a Cycle
- Open the cycle and click :guilabel:`Finalize`.
- The Output Finalize Wizard creates one or more output batches with product, weight and count.
- Each batch creates a stock.lot in the linked product and an outgoing stock picking on :guilabel:`Make Available`, ready to be sold through the preferred channel.
Sales Channels
Three CRM teams are pre-seeded, one per farm sales channel kind:
- Direct Sales
- Cooperative
- Contract Farming
Dashboard
:menuselection:`Livestock Farm --> Dashboard` opens an OWL client action (ir.actions.client) with:
- A cascading filter bar (farm type, location, cycle, group, date range).
- A KPI banner with clickable pipeline and activity counts that navigate to the underlying list/form views.
- Time-series SVG charts for FCR, ADG, mortality rate, egg/milk output and production volume, refreshed on demand.
Reports
Five QWeb PDF reports ship with the module:
- Output Batch Certificate - a per-batch traceability sheet with group cost summary and linked sale order amount.
- Cycle Summary - aggregated feed, mortality, weight and yield for a cycle, with a full cost breakdown.
- Cycle Production & Activity Report - full feed, weighing, egg/milk and activity detail across all groups in a cycle.
- Group Summary - one-page KPI sheet per group (FCR, ADG, mortality %, projections, feed costs, output counts).
- Group Activity & Production Report - complete per-group drill-down: mortality events, feed log, weighings, egg/milk records, output batches and the full activity calendar with action-level detail.
Every report includes a cost breakdown (feed, medicine, labor, overhead, total) with percentage split and cost-per-head where applicable.
Technical Details
Model Prefix
All models use the grev.livestock.farm.* naming convention.
Dependencies
base, mail, product, stock, sale, crm, uom, project, account, hr_timesheet, grev_od_scale_reader, grev_od_contract_base.
Testing
The module ships a tests/ package with an automated regression suite covering cycle and group workflows, feed/mortality/weighing records, the output-batch sales pipeline, activity protocols, and the OWL dashboard. Run it with:
python odoo-bin -c odoo.conf -d test_db -i grev_od_livestock_farm \
--test-enable --stop-after-init
See also
- Grevlin Global Corp
- Companion module: grev_od_crops_farm
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module