Key Features

• Veterinary Visits — health status (healthy → critical), herd size, mortality count, photos, follow-up dates and dual-step review.
• Treatments — medication, dosage, quantity, cost, outcome and link to individual animals.
• Drug Withdrawal Compliance — registry of medication classes with milk, meat and egg withdrawal periods per regulator (EMA, FDA, WHO, national). Treatments auto-compute clear dates.
• Individual Animal Lifecycle — ear-tag, RFID, breed, gender, weight, computed age in months, sire/dam pedigree, status and photos.
• Vaccination Schedules — templates per animal type with required age range, repeat interval, regulatory flag and target coverage.
• Vaccination Batches — execute scheduled vaccinations as planned → in-progress → done batches with coverage KPIs.
• Farm Health Risk Score — daily-recomputed score weighted across mortality, antibiotic use, vaccination coverage and visit frequency with low / medium / high / critical category and escalation activities.
• Public API — check_partner_withdrawal() exposes blocking treatments to integrations such as commodity delivery.

Animal Types

Define the animal species your farms keep:

1. Navigate to :menuselection:`Veterinary Services --> Configuration --> Animal Types`
2. Click :guilabel:`Create`
3. Enter the code, name and description
4. Click :guilabel:`Save`

Medication Withdrawal Registry

Define drug classes and their withdrawal periods:

1. Navigate to :menuselection:`Veterinary Services --> Configuration --> Medication Withdrawal`
2. Click :guilabel:`Create`
3. Enter the medication name, class, regulator, and the withdrawal periods in days for milk, meat and eggs
4. Click :guilabel:`Save`

Vaccination Schedules

Define vaccination templates per animal type:

1. Navigate to :menuselection:`Veterinary Services --> Configuration --> Vaccination Schedules`
2. Click :guilabel:`Create`
3. Pick the animal type and vaccine
4. Enter the required age range, repeat interval and target coverage %
5. Click :guilabel:`Save`

Recording a Veterinary Visit

1. Navigate to :menuselection:`Veterinary Services --> Veterinary Visits`
2. Click :guilabel:`Create`
3. Pick the farm, animal type and herd size
4. Record the health status and any disease detected
5. Add treatment lines with medication, dosage and outcome
6. Set the follow-up date if needed
7. Click :guilabel:`Submit` then :guilabel:`Review`

Registering an Individual Animal

1. Navigate to :menuselection:`Veterinary Services --> Animals`
2. Click :guilabel:`Create`
3. Enter the ear-tag and (optionally) the RFID code
4. Pick the breed, gender and date of birth — age in months is auto-computed
5. Pick sire and dam if known
6. Click :guilabel:`Save`

Running a Vaccination Batch

1. Navigate to :menuselection:`Veterinary Services --> Vaccination Batches`
2. Click :guilabel:`Create`
3. Pick the schedule and the planned date
4. Add the eligible animals
5. Click :guilabel:`Start` then :guilabel:`Done` as the batch is executed
6. Coverage % is computed against the schedule's target

Reading the Farm Health Risk Score

• Open any farm record to see health_risk_score, health_risk_category and the rolling 90-day metrics.
• The cron recomputes scores daily and creates an activity when a farm transitions into critical.
• Categories: low, medium, high, critical.

Blocking Unsafe Deliveries

External integrations (for example commodity delivery) can call grev.farm.medication.withdrawal.registry.check_partner_withdrawal( partner_id, check_date, product_type) to detect treatments still within their withdrawal window and block deliveries of milk, meat or eggs from the affected farm.

Models

Scheduled Actions

• Vet Follow-up Alerts — daily activities for overdue follow-ups.
• Vaccination Overdue Alerts — daily activities for overdue planned batches.
• Recompute Farm Health Risk Score — daily, with critical escalation.