Agricultural Land Leasing Tracker

A specialized skill for working with KrishFlow, a Ruby on Rails 8 application that manages agricultural land leasing, tracking land ownership, farmer leases, and financial returns based on Indian financial year snapshots.

What This Skill Does

This skill helps you navigate and develop KrishFlow, understanding its unique person-centric architecture where individuals can be both landowners and farmers, its financial year snapshot system (April-March), and its land size conversion logic (bigha/biswa units).

Core Architecture Understanding

Person-Centric Data Model

The application uses a dual-role system where a `Person` can simultaneously be:

Key Model Relationships

```

Person (landowner/farmer)

├── owned_lands (as landowner)

└── lease_snapshots (as farmer)

Land (physical property)

├── belongs_to :landowner (Person)

└── has_many :lease_snapshots

LeaseSnapshot (yearly lease terms)

├── belongs_to :land

├── belongs_to :farmer (Person)

└── has_many :payments

Payment (transaction record)

└── belongs_to :lease_snapshot

```

Financial Year System

Land Size Conversion

Development Instructions

1. Initial Setup

When setting up the project:

```bash

bundle install

rails db:create db:migrate db:seed

rails server

```

2. Creating Migrations

Always follow the person-centric model when creating database changes:

3. Working with Models

When modifying models:

4. Building Features

Follow these patterns:

5. Testing

Run tests frequently during development:

```bash

Full test suite

rails test

Specific model tests

rails test test/models/person_test.rb

Single test method

rails test test/models/person_test.rb:test_validation

System tests (UI)

rails test:system

```

6. Code Quality Checks

Before committing changes:

```bash

Security scan

bundle exec brakeman

Code style

bundle exec rubocop

```

7. Database Operations

When working with data:

```bash

Create new migration

rails generate migration MigrationName

Reset database (development only)

rails db:drop db:create db:migrate db:seed

Interactive console

rails console

```

Authentication Note

The application has Devise gem installed but **not configured**. No User model or authentication routes exist. The app currently runs without authentication.

To implement authentication:

1. Run: `rails generate devise:install`

2. Run: `rails generate devise User`

3. Run: `rails db:migrate`

4. Add `devise_for :users` to `config/routes.rb`

5. Uncomment authentication UI in `app/views/layouts/application.html.erb`

Tech Stack

Important Constraints

1. **Financial year format**: Always "YYYY-YY" (e.g., "2024-25")

2. **Size units**: Store all sizes in `biswas`, display as `bigha/biswa`

3. **Person roles**: Never create separate Landowner/Farmer models - use Person with scopes

4. **Unique constraints**: One LeaseSnapshot per land per financial year

5. **Nested resources**: Always access payments through their lease snapshot

Example Workflows

Adding a New Land Lease

1. Find or create Person (landowner)

2. Create Land associated with landowner

3. Find or create Person (farmer)

4. Create LeaseSnapshot linking land to farmer for current financial year

5. Create Payments associated with the snapshot

Generating Financial Reports

Route Structure

The application uses nested resources: