BioCV System Documentation

System Components

Mounting the BioNode

• 1
  Mark the mounting holes

  Use the BioNode as a template to mark the four corner holes on the wall.

• 2
  Drill the holes

  Drill appropriate holes at the marked positions.

• 3
  Insert wall plugs

  Place wall plugs (dowels) into the drill holes.

• 4
  Mount the BioNode

  Align the BioNode with the holes and secure with four screws. Ensure sensors face downward.

Power Connection (PoE)

The BioNode is powered via Power over Ethernet (PoE). You will need a PoE injector or PoE switch that is 802.3at compliant (48V).

Dismantling the Connection Grommet:

• 1
  Unscrew the grommet

  Unscrew the connection grommet from the RJ45 extender connector on the node.

• 2
  Loosen the union nut

  Remove the union nut from the connection grommet.

• 3
  Remove the sealing plug

  Push the blue waterproof sealing plug out of the connection grommet.

• 4
  Thread the cable

  Feed the cable through the union nut, sealing plug, and grommet in sequence.

• 5
  Crimp if needed

  Crimp the cable connector if necessary.

Mounting the Connection Grommet:

• 1
  Connect the cable

  Plug the network cable connector into the extender port on the node.

• 2
  Secure the grommet

  Screw the connector grommet back onto the extender port while countering.

• 3
  Insert the sealing plug

  Push the blue sealing plug back into the screw cap (writing should be visible).

• 4
  Tighten the union nut

  Tighten the union nut while countering on the connection spout.

• 5
  Verify the seal

  Check that the sealing plug tightly encloses the cable.

Registering the BioNode

Once physically installed, register the BioNode in the BioCV LiSA app:

• 1
  Open the LiSA app

  Navigate to Settings in the BioCV LiSA app.

• 2
  Click 'Add BioNode'

  A QR code scanner window will open.

• 3
  Scan the QR code

  Scan the QR code located on the BioNode device.

• 4
  Enter room name

  Enter a descriptive name for the room/location.

• 5
  Confirm

  Click OK to complete the registration.

Installation

• 1
  Open Google Play Store

  On your Android device, open the Google Play Store application.

• 2
  Search for 'BioCV LiSA'

  Use the search function to find the official BioCV LiSA app.

• 3
  Install the app

  Tap 'Install' and wait for the download to complete.

• 4
  Open the app

  Once installed, tap 'Open' or find the app icon on your home screen.

Login & Initial Setup

When you first open the app, you'll need to create an account or log in with provided credentials.

Account Creation:

• 1
  Enter your email

  Provide a valid email address for your account.

• 2
  Create a password

  Choose a secure password (minimum 8 characters, including uppercase, lowercase, and numbers).

• 3
  Set your custom name

  Choose a display name that will identify you to other users.

• 4
  Select your role

  Choose your role: Admin (full access), Manager (management access), or Worker (basic access).

User Roles:

Dashboard Overview

The mobile app dashboard provides quick access to all key features and real-time data.

Dashboard Features:

• Animal Overview

  Total count of active animals and those requiring attention

• AI Predictions

  Heat, birth, and lameness predictions at a glance

• Treatments

  Pending and overdue treatment tasks

• Alerts

  Real-time notifications for important events

Registering Ear Tags

Enable NFC on Your Smartphone:

• 1
  Open Settings

  Tap the Settings icon on your smartphone's home screen.

• 2
  Find NFC settings

  Navigate to 'Wireless & Networks' or 'Connected Devices' section.

• 3
  Enable NFC

  Toggle the NFC switch to the 'On' position.

Register the Ear Tag:

• 1
  Open BioCV LiSA

  Launch the app and log in with your credentials.

• 2
  Go to Localization

  Navigate to the Localization tab in the app.

• 3
  Tap the '+' button

  Click the add button in the bottom right corner.

• 4
  Scan the ear tag

  Hold the ear tag against the NFC sensor on the back of your phone. Wait for detection.

• 5
  Enter Animal ID

  Enter a unique identifier for the animal (e.g., your farm's numbering system).

• 6
  Select sex

  Choose whether the animal is male or female.

• 7
  Optional: Add parent info

  Enter mother and/or father ID if available.

• 8
  Submit

  Press 'Submit' to complete registration.

Applying Ear Tags

Correct Tagging Location:

Tags should be applied in the middle third of the ear between the upper and lower cartilage. The closer to the head, the better for longevity.

Application Steps:

• 1
  Clean the equipment

  Use rubbing alcohol or disinfectant to clean the tagger jaws and the tagging site on the animal's ear.

• 2
  Load the tagger

  Place the male part fully onto the tagger pin, and the female part (ear tag with no hole) under the opposite clip, facing away from the tagger.

• 3
  Check alignment

  Close the tagger until the two halves almost meet. Verify the pin is centered with the ear tag hole.

• 4
  Position and apply

  Position the tagger at the identified tagging site. Firmly and quickly close the tagger, then release.

• 5
  Verify placement

  Examine the tag to ensure it's positioned correctly, comfortably, and securely.

What NOT to Do:

• Do NOT pierce an artery or cartilage
• Do NOT pierce an area close to two arteries
• Do NOT pierce in the far outer regions of the ear
• Do NOT apply the ear tag on the outer half of the ear

Adding Animals

Animals can be added through the mobile app or web application. Each animal is identified by their ear tag's MAC address.

Required Information:

• Animal ID

  Unique identifier (your farm's numbering system)

• MAC Address

  Automatically captured when scanning the ear tag

• Sex

  Male or Female

Optional Information:

• Group assignment
• Birth date
• Weight
• Parent information (Mother/Father ID)
• Notes

Managing Groups

Groups help organize animals by location, age, status, or any other criteria. Each group can be associated with specific BioNodes for location tracking.

• 1
  Create a group

  Navigate to Animals > Groups and click 'Create Group'.

• 2
  Name the group

  Enter a descriptive name (e.g., 'Farrowing Room 1', 'Gestation Pen A').

• 3
  Assign BioNodes

  Select which BioNodes are associated with this group/location.

• 4
  Assign animals

  Select animals to add to the group, or assign during animal registration.

Health Monitoring

The BioCV system continuously monitors animal health through sensor data analysis. Each animal receives a Health Score from 0-100 based on various metrics.

Health Score Ranges:

Heat Detection

Heat detection predictions identify the optimal breeding window for sows. The system analyzes activity patterns, temperature changes, and behavioral data.

Responding to Heat Predictions:

• 1
  Review the prediction

  Check the probability percentage and confidence level.

• 2
  Verify with observation

  Confirm signs of heat through visual observation if needed.

• 3
  Schedule breeding

  Plan artificial insemination within the optimal window.

• 4
  Record the event

  Log the insemination in the system for tracking.

Birth Prediction

Birth predictions help you prepare for farrowing by estimating when a sow will give birth. This allows you to arrange staffing and prepare the farrowing area.

Preparation Checklist:

• Move sow to farrowing area 3-5 days before predicted date
• Prepare heat lamps and bedding
• Schedule staff coverage for predicted date
• Have veterinary contact available
• Monitor more frequently as date approaches

Lameness Detection

Lameness detection identifies mobility issues early, allowing for prompt treatment before the condition worsens.

Response Protocol:

• 1
  Physical examination

  Observe the animal's gait and check for visible issues.

• 2
  Document findings

  Record observations in the system.

• 3
  Create treatment

  If lameness is confirmed, create a treatment plan.

• 4
  Schedule follow-up

  Plan veterinary examination if needed.

• 5
  Monitor recovery

  Track health score improvement after treatment.

Dashboard Overview

Main Navigation:

• Dashboard

  Overview of all key metrics and alerts

• Animals

  Manage animals, groups, and view detailed records

• Predictions

  View and filter AI predictions with detailed analysis

• Treatments

  Treatment management and history

• Settings

  Profile, preferences, and system configuration

Data Export

Export your data for external analysis or record-keeping. The web app supports multiple export formats and advanced filtering options.

Export Formats:

• CSV

  Best for spreadsheet applications

• Excel

  Includes formatting and multiple sheets

• PDF

  Ready for printing and formal reports

Overview & Dashboard

When you open the Sow Management System, you'll see a comprehensive dashboard that provides an overview of your production data at a glance.

Dashboard Statistics:

Record Type Tabs:

• Births

  Track farrowing events including live born, stillborn, and mummified counts

• Inseminations

  Record breeding events with boar, genetic line, and scan status

• General Notes

  Log health events like sickness, death, lameness, or other observations

• Pregnancy Checks

  Record pregnancy test results and methods

• Return to Estrus

  Track when sows return to heat after insemination

• Weanings

  Record weaning events with piglet counts and weights

• Movements

  Track animal movements between production stages

Birth Records

Birth records are one of the most important events in your sow management system. They track the farrowing process and outcomes for each sow.

Birth Record Fields:

• 1
  Click 'Add Birth'

  Navigate to the Births tab and click the Add Birth button.

• 2
  Select the Sow

  Choose the sow from the animal selection dialog.

• 3
  Enter Birth Details

  Fill in date, time, living count, dead count, and other relevant fields.

• 4
  Add Complications (Optional)

  Record any complications that occurred during farrowing.

• 5
  Save the Record

  Click Save to store the birth record in the system.

Inseminations

Insemination records track when and how sows are bred, which is critical for managing breeding schedules and predicting farrowing dates.

Insemination Record Fields:

Batch Insemination Features:

• Comma-Separated Selection

  Enter multiple animal IDs separated by commas for quick selection

• Common Field Sharing

  Apply shared values (date, boar, technician) to all selected animals

• Per-Animal Overrides

  Customize specific fields for individual animals when needed

• Auto Pre-population

  Service number and parity are automatically loaded from previous records

Pregnancy & Weaning

Track pregnancy checks, returns to estrus, and weaning events to manage the complete reproductive cycle of your sows.

Pregnancy Checks:

Pregnancy checks confirm whether inseminations were successful. Record the check date, result (pregnant/not pregnant), and method used.

Return to Estrus:

When a sow returns to heat after insemination, record the return date and type (Regular, Irregular, or Abnormal). This helps identify breeding issues and plan re-breeding.

Weaning Records:

Sow Rating System

The Sow Rating System provides an automated, configurable 1-5 star rating for breeding sows based on their production performance, phenotypic characteristics, and behavioral traits.

Rating Categories:

Star Rating Interpretation:

• sections.sowManagement.rating.stars.five.title

  sections.sowManagement.rating.stars.five.description

• sections.sowManagement.rating.stars.four.title

  sections.sowManagement.rating.stars.four.description

• sections.sowManagement.rating.stars.three.title

  sections.sowManagement.rating.stars.three.description

• sections.sowManagement.rating.stars.two.title

  sections.sowManagement.rating.stars.two.description

• sections.sowManagement.rating.stars.one.title

  sections.sowManagement.rating.stars.one.description

Sow Card Export

Generate comprehensive PDF documents for individual sows with customizable design and field visibility. Sow cards include complete production history and breeding records.

Sow Card Sections:

• Identification

  Animal ID, name, MAC address

• Basic Information

  Birth date, breed, group, pen, health score, sow rating

• Production Summary

  Total parity, total born, total weaned, average litter size

• Current Status

  Reproductive status, last farrowing, expected farrowing date

• History Tables

  Breeding history, farrowing history, treatment records

• 1
  Navigate to ERP Sow Cards

  Go to the ERP section and select Sow Card Export.

• 2
  Search for Sows

  Use the search box or enter comma-separated IDs to find sows.

• 3
  Customize (Optional)

  Adjust field visibility, colors, fonts, and layout in the customization panel.

• 4
  Export PDF

  Click Export PDF to generate and download the sow card.

ERP Settings

Configure the Sow Management System to match your farm's specific operations and standards.

sections.sowManagement.settings.cycleTitle

KPI Alert Thresholds:

• sections.sowManagement.settings.kpi.farrowingRate.title

  sections.sowManagement.settings.kpi.farrowingRate.description

• sections.sowManagement.settings.kpi.nonProductiveDays.title

  sections.sowManagement.settings.kpi.nonProductiveDays.description

• sections.sowManagement.settings.kpi.preweaningMortality.title

  sections.sowManagement.settings.kpi.preweaningMortality.description

sections.sowManagement.settings.filteringTitle

• sections.sowManagement.settings.filtering.animalIdSearch.title

  sections.sowManagement.settings.filtering.animalIdSearch.description

• sections.sowManagement.settings.filtering.dateRange.title

  sections.sowManagement.settings.filtering.dateRange.description

• sections.sowManagement.settings.filtering.csvImport.title

  sections.sowManagement.settings.filtering.csvImport.description

sections.sowManagement.settings.performanceTitle

sections.sowManagement.settings.performanceDescription

API Overview

The LISA API follows REST principles and returns JSON responses. Most endpoints require JWT bearer tokens; health and token endpoints are public.

Authentication

Use JWT bearer tokens for all protected endpoints. There are three ways to obtain a token, depending on your integration type.

Method 1: REST Login (Recommended for Server Integrations)

The simplest way to authenticate. Send your email and password to get a JWT token — no SDK or API keys required.

Step 1: Send a POST request with your credentials:

curl -X POST "https://api.biocv.info/api/v1/tokens/login" \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com", "password": "your-password", "refreshToken": true}'

Response:

{
  "success": true,
  "data": {
    "accessToken": "eyJhbG...",
    "refreshToken": "eyJhbG...",
    "expiresAt": 1713276000000,
    "tokenType": "Bearer",
    "userUID": "abc123"
  }
}

Step 2: Use the access token in all subsequent API requests:

Authorization: Bearer <accessToken>

Step 3: Refresh your token before it expires (refresh tokens are valid for 7 days):

curl -X POST "https://api.biocv.info/api/v1/tokens/refresh" \
  -H "Content-Type: application/json" \
  -d '{"refreshToken": "eyJhbG..."}'

Method 2: Integrator Tokens (Server-to-Server)

For server-to-server integrations with a pre-registered integrator account, generate JWTs via POST /tokens with your integratorUID.

curl -X POST "https://api.biocv.info/api/v1/tokens" \
  -H "Content-Type: application/json" \
  -d '{"integratorUID": "your-integrator-uid"}'

Method 3: Firebase SDK (Client-Side Apps)

Only needed if your application already uses Firebase Authentication for user management. Requires Firebase SDK, API keys, and project configuration.

// JavaScript - Firebase Authentication
import { getAuth, signInWithEmailAndPassword } from "firebase/auth";

const auth = getAuth();
const userCredential = await signInWithEmailAndPassword(
  auth,
  "user@example.com",
  "password"
);

// Get the JWT token
const token = await userCredential.user.getIdToken();

Include the token in API requests:

Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...

Base URLs & Environments

Health Check

Check API status (no authentication required).

Token Management

Generate and manage JWT access and refresh tokens.

Users

Manage user profiles and device tokens (admin or ownership required).

Animals

Retrieve animals and ANT+ location detections for a user.

{
  "success": true,
  "data": [
    {
      "MAC": "AA:BB:CC:DD:EE:FF",
      "ID": "SOW-2024-001",
      "Active": true,
      "Archived": false,
      "Suspicious": false,
      "Group": "Gestation 3",
      "Sex": "female",
      "Father": "BOAR-2020-012",
      "Mother": "SOW-2021-045",
      "Node": "2025.0008",
      "NodeWeight": 0.57,
      "WatchdogWeight": 0,
      "SignalStrength": 2,
      "Battery": 86,
      "CurrentActivity": 0.439,
      "DailyActivityLevel": 0.327,
      "CurrentTemperature": 37.6,
      "ReferenceTemperature": 36.8,
      "ReferenceTemperatureUpdatedAt": 1779262036773,
      "ReferenceTemperatureWindowDays": 7,
      "HealthScore": 92,
      "HeatProbability":  { "t": 1779228252190, "Result": 0.12 },
      "BirthProbability": { "t": 1779260404150, "Result": 0.04 },
      "EartagStart": 1750963064891,
      "Uid": "<owner-user-id>",
      "t": 1779260000000
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 245,
    "totalPages": 25
  },
  "timestamp": "2026-05-20T08:00:00.000Z"
}

Animal fields (response payload)

Every animal object returned by the endpoints above shares the same shape. Optional fields may be absent or null when the sensor has not produced data yet.

Temperature: CurrentTemperature vs ReferenceTemperature

The CurrentTemperature field is the latest ear-pinna reading from the BioTag, not a core body temperature. Absolute pinna values shift with ambient conditions (ventilation, sun exposure, tag fit), so the clinically meaningful signal is the deviation from the animal's own baseline:

delta = CurrentTemperature - ReferenceTemperature

ReferenceTemperature is a rolling 7-day median of CurrentTemperature, computed per animal and refreshed once per day. Samples outside 25 to 42 degrees Celsius are dropped as sensor noise before the median is taken.

Calibration window. ReferenceTemperature is null while a tag has fewer than 7 days of data or fewer than 100 valid samples in the window. Render an honest 'calibrating' fallback in the UI rather than substituting a default value.

Suggested deviation bands (starting point, tune per herd)

AI Predictions

Access AI-generated predictions for a specific animal.

{
  "data": [
    {
      "id": "pred_heat_001",
      "animalId": "animal_abc123",
      "type": "heat",
      "probability": 0.87,
      "confidence": "high",
      "predictedWindow": {
        "start": "2024-12-31T06:00:00Z",
        "end": "2024-12-31T18:00:00Z"
      },
      "factors": [
        "Increased activity",
        "Temperature elevation",
        "Movement pattern change"
      ],
      "createdAt": "2024-12-30T14:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 12
  }
}

Treatments

Access and manage treatment records for a user.

Births

Access birth records and statistics for a user.

GET /users/:userId/births/statistics - Response (200 OK)

{
  "success": true,
  "data": {
    "totalBirths": 25,
    "totalLiving": 300,
    "totalDead": 5,
    "averageLitterSize": 12.2,
    "survivalRate": 98.36
  },
  "timestamp": "2024-12-01T08:47:16.838Z"
}

LitterGuards

Monitor LitterGuard devices and sensor data.

Inseminations

Access and manage insemination records for a user. Track breeding events, search by criteria, and manage active/archived records.

Sensor Data

Access raw sensor readings, latest values, and analytics for individual animals. Sensor data is collected via BioTag+ ear tags and transmitted through BioNode gateways.

Use startDate and endDate query parameters to filter sensor data by time range.

Animal Events & Records

Access per-animal event records including births, inseminations, pregnancy checks, return-to-estrus, weanings, movements, and general events. All endpoints are nested under a specific animal.

Births

Inseminations

General Events

Pregnancy Checks

Return to Estrus

Weanings

Movements

Partner Management

Manage integrator-to-user account linking. Partners (integrators) can link to user accounts to access their data through the API.

Error Handling

The API uses standard HTTP status codes and returns detailed error messages in JSON format.

Error Response Format:

{
  "success": false,
  "error": "Invalid request parameters",
  "details": [
    {
      "field": "birthDate",
      "message": "Must be a valid ISO 8601 date"
    }
  ],
  "timestamp": "2024-12-01T08:47:16.838Z"
}

Rate Limits & Quotas

API usage is governed by two independent limits: an infrastructure rate limit per IP address, and a per-account daily quota based on your API tier. Both apply to every authenticated request.

IP rate limit

API tiers (per-endpoint daily quota)

On top of the IP limit, each account has a daily call quota counted separately per endpoint. Reads and writes both count. Quotas reset every day at 00:00 UTC. Your tier is set on your account; contact BioCV to upgrade.

Code Examples

Complete examples in popular programming languages to help you get started quickly.

# Health check
curl -X GET "https://api.biocv.info/api/v1/health"

# Generate an access token
curl -X POST "https://api.biocv.info/api/v1/tokens" \
  -H "Content-Type: application/json" \
  -d '{"integratorUID": "your-integrator-uid", "expiresIn": 3600, "refreshToken": true}'

# List animals for a user
curl -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  "https://api.biocv.info/api/v1/users/user123/animals?page=1&limit=10"

# Get predictions for an animal
curl -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  "https://api.biocv.info/api/v1/users/user123/animals/AA:BB:CC:DD:EE:FF/predictions?classificationType=heat"

// Using fetch API
const API_BASE = "https://api.biocv.info/api/v1";
const token = "your_jwt_token";
const userId = "user123";

// List animals
async function listAnimals() {
  const response = await fetch(`${API_BASE}/users/${userId}/animals?page=1&limit=10`, {
    headers: {
      "Authorization": `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  });
  return response.json();
}

// Get recent predictions for an animal
async function getRecentPredictions(animalMac) {
  const response = await fetch(
    `${API_BASE}/users/${userId}/animals/${animalMac}/predictions/recent?limit=10`,
    {
      headers: {
        "Authorization": `Bearer ${token}`,
        "Content-Type": "application/json"
      }
    }
  );
  return response.json();
}

// Example usage
const animals = await listAnimals();
if (animals.data?.length) {
  const predictions = await getRecentPredictions(animals.data[0].macAddress);
  console.log(`Predictions: ${predictions.data.length}`);
}

import requests

API_BASE = "https://api.biocv.info/api/v1"
USER_ID = "user123"
HEADERS = {
    "Authorization": "Bearer YOUR_JWT_TOKEN",
    "Content-Type": "application/json"
}

def list_animals(page=1, limit=10):
    response = requests.get(
        f"{API_BASE}/users/{USER_ID}/animals",
        headers=HEADERS,
        params={"page": page, "limit": limit}
    )
    return response.json()

def get_birth_statistics():
    response = requests.get(
        f"{API_BASE}/users/{USER_ID}/births/statistics",
        headers=HEADERS
    )
    return response.json()

def get_recent_predictions(animal_mac, limit=10):
    response = requests.get(
        f"{API_BASE}/users/{USER_ID}/animals/{animal_mac}/predictions/recent",
        headers=HEADERS,
        params={"limit": limit}
    )
    return response.json()

# Example usage
animals = list_animals()
print(f"Found {animals['pagination']['total']} animals")

stats = get_birth_statistics()
print(f"Total births: {stats['data']['totalBirths']}")

if animals["data"]:
    predictions = get_recent_predictions(animals["data"][0]["macAddress"])
    print(f"Recent predictions: {len(predictions['data'])}")

Getting Started

Your first steps after logging into the BioCV web application.

What You'll Learn

• How to navigate the main interface
• Understanding the dashboard
• Setting up your first animals
• Configuring basic settings

Sidebar Navigation

Dashboard Overview

The Dashboard is your central hub for monitoring farm operations. It provides at-a-glance visibility into animal status, predictions, treatments, and tasks.

Dashboard Cards

• Active Animals

  Total count of currently active animals

• Registered Animals

  Total animals ever registered including active and archived

• Suspicious Animals

  Count of animals with Health Score below 50

• Animals in Heat

  Animals currently detected as being in heat based on AI predictions

• Births

  Recent birth events typically from last 7 days

• Reluctant Animals

  Animals with breeding difficulties

Health Score Ranges

Cockpit

The Cockpit is a mobile-optimized interface designed for quick data entry while working in the barn.

Quick Action Tiles

Work Planner

The Work Planner helps you schedule, assign, and track farm tasks.

Priority Levels

Adding Animals

How to register new animals in BioCV, whether adding a single animal or importing many at once.

Adding Methods

Required Fields

• Animal ID

  Unique identifier for this animal

• Animal Type

  Sow or Boar

• Sex

  Male or Female

Viewing Animals

The Animals page provides a comprehensive grid view of all your animals.

Grid Columns

Health Score Colors

• 80-100: Healthy
• 50-79: Monitor
• 0-49: Suspicious

Animal Details

The Animal Details page provides comprehensive information about a single animal.

Available Tabs

• Overview
• History
• Events
• Treatments
• Predictions
• Sensor Data

Archiving Animals

Archiving removes an animal from active lists while preserving all historical data.

Archive Process

• 1
  Step 1

  Navigate to animal's detail page

• 2
  Step 2

  Click Archive button

• 3
  Step 3

  Select archive reason

• 4
  Step 4

  Add notes if needed

• 5
  Step 5

  Confirm archival

Insemination Recording

Fields

Pregnancy Check Recording

Results: Pregnant, Open (Not Pregnant), Recheck Needed

Methods: Ultrasound, Visual Observation, Other

Birth/Farrowing Recording

Fields

Weaning Recording

Fields: Animal, Date, Piglets Weaned Count, Weaning Weight (average)

Movement Recording

Fields: Animal, Date, Source Pen, Destination Pen, Reason

Recording Treatments

Treatment Fields

Treatment Statuses

Treatment Workflow

• 1
  Step 1

  Identify health issue

• 2
  Step 2

  Record health event (optional)

• 3
  Step 3

  Create treatment record

• 4
  Step 4

  Administer medication

• 5
  Step 5

  Monitor and update progress

• 6
  Step 6

  Complete treatment

Treatment Templates

Templates are pre-configured treatment plans that you can quickly apply to animals.

Benefits

• Save common treatment protocols
• Quickly apply to animals
• Ensure consistency across team

Usage

• 1
  Step 1

  Open Add Treatment dialog

• 2
  Step 2

  Click Use Template

• 3
  Step 3

  Select the template

• 4
  Step 4

  Adjust dates if needed

• 5
  Step 5

  Save the treatment

Health Events

Event Types

Recording Steps

• 1
  Step 1

  Navigate to animal detail page

• 2
  Step 2

  Click Add Health Event

• 3
  Step 3

  Select event type

• 4
  Step 4

  Add description and notes

• 5
  Step 5

  Save the event

Barn Layout

Design your barn structure using the barn builder interface.

• 1
  Step 1

  Navigate to Barn in the sidebar

• 2
  Step 2

  Click on the barn builder

• 3
  Step 3

  Add sections matching your workflow

• 4
  Step 4

  Add pens within sections

• 5
  Step 5

  Set pen capacities

Pen Management

Occupancy Colors

• Green: Below capacity
• Yellow: Near capacity
• Red: At or over capacity
• Gray: Empty

Animal Assignment

Assign animals to pens to track their locations.

• During animal creation - select pen
• From animal detail page - change pen assignment
• Using movement events - transfer between pens

3D Visualization

Features

• Physical layout of pens
• Color-coded occupancy
• Animal indicators
• Section boundaries

Controls

• Rotate: Click and drag
• Zoom: Scroll wheel
• Pan: Right-click and drag
• Select: Click on a pen

Temperature Sensors

Monitor temperature readings from BioNode environmental sensors and animal ear tags.

View temperature data on the BioT Dashboard with historical charts and trend analysis.

Water Sensors

Track water consumption for animals and pens.

• Identify unusual drinking patterns
• Detect potential health issues
• Monitor pen-level consumption

Sensor Alerts

Configuration Steps

• 1
  Step 1

  Navigate to Settings > Notifications

• 2
  Step 2

  Configure alert thresholds

• 3
  Step 3

  Set cooldown periods

• 4
  Step 4

  Choose notification channels (email, push, SMS)

Alert Types

• Temperature out of range
• Water consumption anomaly
• Sensor offline
• BioNode connection issues

AI Predictions

Prediction Types

Confidence Scores

Lisa AI Assistant

Lisa is the AI chat assistant that can answer questions, provide insights, and help navigate the system.

Capabilities

• Answer natural language questions
• Provide data-driven responses
• Navigate to relevant pages
• Summarize farm status

Usage

• 1
  Step 1

  Click the Lisa chat icon

• 2
  Step 2

  Ask questions in natural language

• 3
  Step 3

  Get data-driven responses

• 4
  Step 4

  Navigate to relevant pages

Suspicious Animals

Animals with a Health Score below 50 are marked as suspicious and require attention.

• 1
  Step 1

  Check Suspicious Animals card on dashboard

• 2
  Step 2

  Review animals with low Health Scores

• 3
  Step 3

  Investigate sensor data and recent events

• 4
  Step 4

  Take action or validate predictions

ERP Dashboard

The ERP Dashboard provides production KPIs and metrics at a glance.

• Current KPI values
• Recent trends
• Status indicators
• Alert highlights
• Period comparisons

Economics

Financial analysis tools for tracking costs and revenue related to your breeding operations.

• Cost tracking
• Revenue analysis
• Profit margins
• Per-animal costs

Data Export

Available Timeframes

Export Formats

Account Settings

• Profile (name, email, contact)
• Password
• Language
• Personal preferences

Team Management

• Team members list
• Invitations
• Role assignments

User Roles

• Admin (full access)
• Manager (management features)
• Worker (basic access)

Notifications

• Alert channels (email, push, SMS)
• Alert types
• Thresholds
• Cooldown periods

Dashboard Customization

• Card visibility
• Card order
• Default filters