Farm Dashboard
Start here for the current state of batches, orders, sales, pending work, and key operational alerts.
Check pending orders → confirm or cancel → convert sales → review batch health → approve worker records → update stock/prices/reports.
Raw Dashboard Data
No data yet.
Create Batch
Leave this empty and the backend will create a code like BATCH-2026-0001.
Batch Tools
📋 Batch Detail Center
The main operational screen for one flock: summary, feed, mortality, weights, vaccines, medicine, sales, and expenses.
No batch selected
No summary loaded.
| Date | Type | KG | Cost | Status |
|---|
| Date | Count | Cause | Status |
|---|
| Date | Sample | Average KG | Expected | Assessment | Status |
|---|
| ID | Day | Date | Name | Status | Action |
|---|
| Date | Issue | Symptoms | Medicine | Dosage | Outcome | Status |
|---|
| Date | Description | Amount | Status |
|---|
| Date | Birds | Weight | Total | Payment |
|---|
Feed
Mortality
Weight
🩺 Record Medicine / Health Issue
Use this for sickness signs, treatment, medicine given, dosage, vet notes, and recovery outcome.
Batch Health History
No medicine/health data.
Vaccines
| ID | Day | Date | Name | Status | Action |
|---|
No data.
📦 Create Stock Item / New Procurement Lot
Admin/Manager only. The system generates the Stock Code automatically. When an item is finished, create the new procurement as a new stock item/lot.
Stock Movement
Workers can record usage only. Admin/Manager can record purchases, corrections, wastage, and usage.
Inventory Tools
Use the stock item ID in Feed, Medicine / Health, or Vaccine completion to auto-deduct stock.
| Stock Code | ID | Category | Name | Available | Minimum | Unit | Expiry |
|---|
No inventory data.
🔔 Alerts / Notifications Center
This center pulls urgent farm signals into one place: pending approvals, due vaccines, low stock, expiring stock, mortality warnings, and growth warnings.
Alert List
| Severity | Category | Title | Message | Count | Action |
|---|
Alert Details
No alerts loaded.
📈 Reports Center
Reports are restricted to Admin, Manager, and Investor where financial information is involved.
Report Table
No report loaded.
💸 Submit Expense
Workers can submit expenses. Manager/Admin records are approved immediately. Worker records go to Approvals.
Expense History
Financial history is visible only to Admin, Manager, and Investor.
No expense history loaded.
🏷️ Product Prices
Customers do not type prices. The customer portal uses the active prices set here.
| Product | Sale Type | Unit | Price/KG | Price/Bird | Weight Range | Currency | Status | Effective |
|---|
Set New Active Price
Order Processing
Review customer portal requests, confirm or cancel orders, then convert confirmed orders into sales.
Customers create accounts and submit order requests from the separate Customer Portal. Staff process orders here using customer code/name/phone, then confirm, cancel, or convert them to sales. Older orders may show inferred KG if they were created before the KG field existed.
| Code | Batch | KG Requested | Birds / Reserved | Customer Code | Customer | Phone | Status | Estimate | Action |
|---|
No orders loaded.
👤 Customer
💰 Record Sale
Sales are restricted to Admin and Manager. Choose Alive Bird or Kitchen Ready Chicken. KG sold and selling price per KG are required.
✅ Manager Approvals
Review worker-submitted records. Approved records affect summaries. Rejected records stay in history but are not counted.
Feed Records
| ID | Batch | Date | Type | KG | Cost | Action |
|---|
Mortality Records
| ID | Batch | Date | Count | Cause | Action |
|---|
Weight Records
| ID | Batch | Date | Average KG | Assessment | Action |
|---|
Medicine / Health Records
| ID | Batch | Date | Issue | Medicine | Outcome | Action |
|---|
Expenses
| ID | Farm | Batch | Date | Description | Amount | Action |
|---|
No approval data loaded.
Create User
User Tools
Use List Users to find the User ID before changing status or resetting password.
No data.
🔒 User Access Control
Admin-only. Use this to suspend access or reset passwords when staff/customer accounts need control.
🧰 Backup Database
🛡️ Backup / Restore Safety
Production rule: always create and download a fresh backup before restoring any database file. Restore is powerful and should only be done by Admin.
- Create a fresh backup.
- Download the fresh backup to your computer.
- Confirm staff are not actively entering records.
- Select the restore database file.
- Restore only if you are sure.
- Restart backend after restore if data looks stale.
Create a safe copy of the SQLite database before major changes or before moving machines.
| Filename | Size | Modified | Download |
|---|
Restore Database
Restore only when necessary. After restoring, restart the backend server.
No backup action yet.
🛠️ Farm Profile
🔐 Change My Password
Use this before production. Password must be at least 10 characters and include letters and numbers.
🛡️ Login Protection
Production login protection is enabled in the backend: repeated failed login attempts are temporarily locked and login events are written to Audit Logs.
Configure limits in .env using POULTRYOPS_LOGIN_MAX_FAILED_ATTEMPTS and POULTRYOPS_LOGIN_LOCKOUT_MINUTES.
Admin can update the farm profile. Manager can view settings.
Operational Settings
Current Settings
No settings loaded.
System
No data.