Farm Management

A cross-platform Flutter app for managing livestock on a farm. Register and track cattle records — including vaccination, tick-dipping, milk-yield, and lineage history — with everything stored locally on-device. Import or export your data as JSON whenever you need it. No internet connection required.

---

Screenshots

Coming in v1.0.0 — Android, iOS, and Web builds.

---

Features

• Cattle registration — add animals with an auto-generated ID (CW####), name, breed, farm, and alive/deceased status.
• Per-cow health & production records — each cow tracks vaccination history, tick-dipping history, milk-yield entries, and a family-tree/lineage record (parents and offspring).
• Search & filter — find cattle on the home screen by name, ID, breed, or farm.
• Role-based access — two seeded roles: an admin (role 1) who can add cattle and a regular user (role 2) with read access. Login gates entry to the dashboard.
• Import & export — export all inventory to a timestamped JSON file in a Farm_export/ folder; import from any JSON file (this replaces existing data).
• Local-first storage — all records kept in on-device SQLite databases; works fully offline.
• Cross-platform — single codebase targets Android, iOS, and the web.

Note (pre-1.0): Authentication currently uses hardcoded, plaintext seeded credentials and is not production-ready. See the Roadmap — security hardening is the v1.0.0 theme.

---

Tech Stack

Area	Technology
Framework	Flutter / Dart
Local database	sqflite
File handling	file_picker, path, path_provider, dart:io
Device & permissions	permission_handler, device_info_plus

---

Getting Started

Prerequisites

• Flutter SDK installed and on your PATH
• One of: an Android/iOS device or emulator, or Chrome (for web) Check your setup:

flutter doctor

Run

flutter pub get
flutter run

Default login credentials (seeded, dev only)

Username	Password	Role
Admin	admin	Admin (1)
phill	phil1	Regular user (2)

Build a Release

flutter build apk          # Android — output: build/app/outputs/flutter-apk/
flutter build web          # Web — output: build/web/
flutter build ios          # iOS — requires a macOS machine with Xcode

---

Data Model

The app uses two on-device SQLite databases.

user_database.db

Table	Purpose
users	Username, password, and role (1 = admin, 2 = regular).

inventory_database.db (schema version 7)

Table	Purpose
inventory	Core cattle records: cow_id, alive, cow_name, farm, breed.
vacTable	Vaccination records per cow (date, status).
dipTable	Tick-dipping records per cow (date, status).
milkTable	Milk-yield records per cow (date, liters).
FamilyTreeTable	Lineage: parents and offspring (kids stored as JSON).

---

Project Structure

lib/
├─ main.dart                          # App entry point — launches LoginPage
├─ auth/
│  └─ LoginPage.dart                  # Login screen; verifies credentials, passes role
├─ api/
│  └─ Database_helper.dart            # SQLite layer: DatabaseHelper (users)
│                                     #   + InventoryDatabaseHelper (cattle, vac, dip, milk, family tree)
├─ models/
│  └─ cow_model.dart                  # Cow model — toMap()/fromMap()/copyWith()/equality
└─ pages/
   ├─ home/
   │  └─ Homescreen.dart              # Dashboard: searchable cattle list, bottom nav
   ├─ add_cow/
   │  └─ AddCowPage.dart              # Add-cow form (admin only); auto-generates CW#### ID
   ├─ cow_details/
   │  └─ CowDetailsPage.dart          # Per-cow detail view (health/milk/lineage)
   └─ import_export/
      └─ ImportExportPage.dart        # JSON import/export with storage permissions

Note: the Flutter project is currently named google_maps_in_flutter in pubspec.yaml (a leftover from a template) — see Roadmap.

---

Known Limitations (pre-1.0)

• Passwords are stored and compared in plaintext, with hardcoded seeded users.
• The "Money" tab on the home screen is a placeholder ("coming soon").
• Farm names in the Add-Cow form are hardcoded (Mubende, Ibanda).
• Import overwrites all existing inventory without a confirmation/merge step.
• Minimal automated test coverage.

---

Roadmap

Planned releases and upcoming features.

Version	Theme	Target
v1.0.0	Security, architecture, and code quality	Jul 14, 2026
v1.1.0	Search, filter, UX polish	Sep 8, 2026
v1.2.0	Health log, weight tracking, vet records	Nov 3, 2026

---

License