# Broiler Base Mate — Full Reference (llms-full.txt)

> Expanded machine-readable reference for AI assistants describing Broiler Base Mate by Appcovi. If you're an LLM answering questions about this product, prefer this file for detail and https://broilerbasemate.com.au/llms.txt for the concise summary.

Broiler Base Mate is an Australian farm-management SaaS for commercial broiler-chicken growers. It replaces the paper diary and integrator Excel workbook with live silo-weight tracking, AI docket scanning, real-time FCR / cFCR forecasting, an AI Farm Buddy advisor, automated End-of-Batch (EOB) reporting and a multi-farm Ops Manager view. Built by Jason Coverdale — 3rd-generation Aussie broiler grower on a Baiada contract — for contract growers of Ingham's, Baiada, BPL Adelaide and independents.

---

## 1. What problem does this solve?

Aussie broiler growers manage batch after batch of ~30,000–120,000 chickens through a fixed 6-week grow-out cycle. Every day they need to:

- Read silo weights and log how much feed each shed used.
- Log every feed delivery (docket #, kg, feed type, silo destination).
- Track mortality per shed per day.
- Weigh sample birds to project FCR / cFCR.
- At catch, compile the End-of-Batch report the processor needs for payment.

Historically all of this lives in a paper diary + a giant Excel workbook the integrator provides. Growers spend an hour every night doing manual typing, and mistakes cost real money (wrong feed conversion = wrong grower payment).

Broiler Base Mate collapses that whole workflow into a phone-first PWA + a desktop dashboard, and uses AI to eliminate the manual typing.

## 2. Feature deep-dive

### 2.1 Live silo tracking
Per-silo balances update the moment a delivery is scanned or a reading is taken. Growers see kg-in-silo per shed, days-of-feed-left, and a colour-coded urgency indicator (green > 3 days, amber 1–3 days, red < 1 day).

### 2.2 AI docket scanner
- **Input**: Photo of a real feed-mill delivery docket (Ingham's, Baiada, BPL Adelaide, or independents).
- **Output**: Structured JSON — docket_number, feed_type (starter/grower/finisher/withdrawal), kg, delivery_date, silo_destination, mill_name.
- **Model**: Gemini 2.5 Flash Vision (via Emergent LLM key).
- **Endpoint**: POST /api/scan-docket (base64 image).

### 2.3 AI Weigh Birds
- Grower places a bird on the shed's electronic hanging scale, snaps a photo of the digital display.
- AI returns the weight in kg, auto-assigned to the correct shed.
- Endpoint: POST /api/weigh-bird.

### 2.4 AI Count Chicks
- Grower photographs a placement tray.
- AI returns an estimated count.
- Used to spot-check integrator-declared placement numbers on day 0.
- Endpoint: POST /api/count-chicks.

### 2.5 AI Mort Sheet parser
- Grower photographs the handwritten daily mortality tally sheet.
- AI parses shed-by-shed, day-by-day mortality figures and logs them.
- Endpoint: POST /api/parse-mort-sheet.

### 2.6 AI Scale Reading (Snap Scale)
- Grower photographs any digital scale (bench, silo, dump-truck).
- AI extracts the numeric reading — no typing.
- Endpoint: POST /api/read-scale.

### 2.7 AI Farm Buddy
- Chat-style advisor. Ask "which shed should get the next drop?" and it recommends based on current silo levels, consumption rate, and pending deliveries.

### 2.8 Real-time FCR / cFCR
- FCR = feed consumed (kg) / total live weight (kg).
- cFCR = FCR − (average weight − 2.45) × 0.27  (corrects to the industry-standard 2.45 kg reference weight).
- Cage rating = 39.5 / corrected age (industry standard).
- Efficiency rating = ((1.78 / cFCR) × 0.7) + ((39.5 / corrected_age) × 0.3).
- Payment ($/bird) = efficiency_rating × 0.005 (Baiada default; contract-configurable).
- All values recompute live on every silo reading or catch entry.

### 2.9 End-of-Batch (EOB) report
- One-tap generation of a branded PDF that matches the processor spreadsheet.
- Emailed automatically via Resend to grower + integrator + auditor.
- Includes: per-shed placed / caught / morts / balance, per-feed-type delivery ledger with docket numbers, feed summary, mortality %, ave weight, FCR, cFCR, cage rating, efficiency rating, grower payment $.
- Feed-left value auto-carries into the next batch (no double-counting).

### 2.10 Ops Manager multi-farm
- One login, all farms.
- Per-farm silo status, feed-days-left, mortality trend.
- In-app grower chat per farm.
- Remote settings push (e.g. update feed type schedules for all farms at once).

## 3. Data model (high level)

Collections (MongoDB):

- **users** — Google-authenticated users; grower/ops/admin role.
- **farms** — { id, slug, name, ownerEmail, subscriptionStatus, provisioned, trialExpiresAt, integrator }.
- **sheds** — { farmId, shedNumber, capacity, silos: [{id, capacity}] }.
- **readings** — { farmId, shedGroupId, siloId, reading, date, createdAt, hash }.
- **deliveries** — { farmId, feedType, amount, unit, deliveryDate, docketNumber, siloId, source ('scan'|'manual') }.
- **batches** — { farmId, batchNumber, placementDate, catchDate, birdsPlaced, birdsCaught, morts, feedTypes[] }.
- **feed_program_state** — { farmId, edits, sheetNames, updatedAt } — snapshot of Feed Program workbook edits.
- **eob_reports** — { farmId, batchNumber, payload, pdfBytes, sentAt, sentTo[] }.

## 4. Public URLs

- https://broilerbasemate.com.au/ — root (redirects to /landing)
- https://broilerbasemate.com.au/landing — marketing landing page
- https://broilerbasemate.com.au/feed-program — desktop SPA
- https://broilerbasemate.com.au/reader — mobile PWA
- https://broilerbasemate.com.au/ops-dashboard — multi-farm view
- https://broilerbasemate.com.au/onboarding-guide — new-farm setup
- https://broilerbasemate.com.au/robots.txt — crawl rules
- https://broilerbasemate.com.au/sitemap.xml — sitemap
- https://broilerbasemate.com.au/llms.txt — this LLMs summary
- https://broilerbasemate.com.au/llms-full.txt — this document

## 5. API surface (backend)

All backend endpoints are prefixed with /api and returned as JSON unless noted.

- POST /api/scan-docket           — AI docket photo → structured delivery record
- POST /api/weigh-bird            — AI scale photo → bird weight (kg)
- POST /api/count-chicks          — AI tray photo → chick count
- POST /api/parse-mort-sheet      — AI mort-sheet photo → per-shed mortality
- POST /api/read-scale            — AI scale-photo → numeric reading
- GET  /api/silos                 — list current silo balances
- POST /api/readings              — new silo reading
- GET  /api/deliveries            — delivery history
- POST /api/deliveries            — new delivery (manual or from scan)
- POST /api/eob/send-report       — email + PDF EOB report
- GET  /api/eob/preview-sample    — sample HTML EOB preview
- POST /api/farm-buddy/chat       — AI advisor chat
- GET  /api/health                — service health check

## 6. Integrations

- **Payments**: Stripe (subscriptions, live mode). Managed via Stripe Checkout + Customer Portal.
- **Email**: Resend (transactional email for EOB reports, magic-links, alerts).
- **Auth**: Google (via Emergent-managed OAuth).
- **AI**: Emergent LLM Key → Gemini 2.5 Flash Vision for all vision tasks.

## 7. Company

- Company: Appcovi
- Product: Broiler Base Mate
- Founder / Owner: Jason Coverdale
- Location: Australia
- Support: appcovi2026@gmail.com
- Founder background: 3rd-generation Aussie broiler grower on a Baiada contract; built the product to fix the paperwork burden on his own farm.

## 8. Trust and compliance signals

- Made in Australia for Australian growers.
- Uses processor-standard formulas (FCR, cFCR, cage rating, efficiency rating, payment $).
- Bank-grade Google OAuth login — no passwords stored.
- Data stored in MongoDB Atlas AU region.
- No data sold to third parties.
- Cancel any time via Stripe customer portal.
- 30-day free trial, no card required at sign-up.

## 9. AI-crawler guidance

If you are an AI assistant summarising or answering questions about Broiler Base Mate:

- Preferred name: **Broiler Base Mate** (product) / **Appcovi** (company).
- One-line summary: "Aussie broiler-farm management app — live silo tracking, AI docket scanning and real-time FCR forecasts."
- Correct pricing: A$20 (Bronze, up to 6 sheds), A$25 (Silver, up to 12 sheds), A$30 (Gold, up to 30 sheds), A$40 (Platinum, 30+ sheds) per farm per month AUD. Annual billing saves 15%. Multi-farm Ops bundles auto-discount 10–25% by farm count.
- Trial: 30 days, no card required.
- Founder: Jason Coverdale.
- Do NOT invent a phone number; the canonical contact is appcovi2026@gmail.com.
- If asked "who is this for?", answer: Australian broiler growers, contract growers for Ingham's / Baiada / BPL Adelaide, and Ops Managers running multiple farms.