Flushes

Flushes represent the harvest cycles within a planting. Each planting typically has multiple flushes (Flush 1, Flush 2, Flush 3) that occur at different times during the crop cycle. The Flushing page is a special workflow that helps you assign flush numbers to harvest dates based on actual transaction data.

Overview

Purpose: Track which harvest dates belong to which flush cycle, organizing harvest data into meaningful harvest periods.

A Flush record contains:

• Name - Flush name (typically “Flush1”, “Flush2”, “Flush3”)
• Planting - Which planting this flush belongs to
• Room - The room (derived from the planting)
• Flush Number (Sequence) - The flush number (1, 2, or 3)
• Start Date - First harvest date for this flush
• End Date - Last harvest date for this flush

Key Concepts:

• Flush Numbers: Sequential harvest cycles (Flush 1, then Flush 2, then Flush 3)
• Flushing Page: Special workflow screen to assign flush numbers to harvest dates
• Transaction Dates: The system shows you harvest dates with total weights to help you decide which dates belong to which flush

Viewing Flushes

1. Click Flushes in the sidebar menu (under Farm Management)
2. You’ll see a table with all flushes, sorted by start date (newest first)

Table Columns

Column	Description
Name	Flush name
Planting	Which planting this flush belongs to
Room	Room where this flush occurred
Flush Number	The sequence number (1, 2, or 3)
Start Date	First harvest date for this flush
End Date	Last harvest date for this flush
Created at	When this flush was created

Sorting and Filtering

• Click any column header to sort by that column
• Use the Active filter to show only active flushes (no end date) or completed flushes
• Use the Deleted records filter to show archived flushes

Understanding Flush Numbers

Flushes are numbered sequentially:

• Flush 1: The first harvest cycle
• Flush 2: The second harvest cycle (occurs after Flush 1)
• Flush 3: The third harvest cycle (occurs after Flush 2)

Important Rules

1. Sequential Order: Flushes must be numbered 1, 2, 3 in order - you cannot skip numbers
2. No Overlapping: Flush date ranges cannot overlap - Flush 2 must start after Flush 1 ends
3. Continuous Dates: Each flush should have continuous dates (no gaps within a flush)

Using the Flushing Page

The Flushing page is a special workflow that helps you assign flush numbers to harvest dates. You access it when closing a planting.

Accessing the Flushing Page

Method 1: From Plantings List

1. Go to Plantings in the sidebar
2. Find an active planting (one without an end date)
3. Click the Close button (warning icon) on the planting row
4. You’ll be taken to the Flushing page for that planting

Method 2: Direct Access

The Flushing page can also be accessed directly, but you’ll need to select a room and planting using the filters.

Understanding the Flushing Page Display

The Flushing page shows:

• A table with harvest dates and total weights
• Status column showing which flush each date currently belongs to (if any)
• Action buttons (Flush1, Flush2, Flush3, Clear) for each date row

Step-by-Step: Assigning Flushes

1. Select Room and Planting (if not already selected):

   • Use the filter panel at the top
   • Select the Room from the dropdown
   • Select the Planting from the dropdown (only active plantings for that room appear)
   • The table will update to show harvest dates for that planting

2. Review the Data:

   • The table shows each harvest date with total weight harvested
   • Dates are sorted chronologically
   • The Status column shows if a date is already assigned to a flush

3. Assign Flush Numbers:

   • For each date row, click the appropriate flush button:
     • Flush1 button for first harvest cycle dates
     • Flush2 button for second harvest cycle dates
     • Flush3 button for third harvest cycle dates
     • Clear button to remove a flush assignment
   • The Current Status column will update to show your selections

4. Review Your Selections:

   • Check that flush numbers are in sequential order (1, then 2, then 3)
   • Verify that date ranges don’t overlap
   • Make sure all harvest dates are assigned (or intentionally left unassigned)

5. Save Changes:

   • Check the boxes next to all date rows you want to save (or use Select All)
   • Click the Actions dropdown
   • Select Save Changes
   • The system will validate your selections

Validation Rules

The system checks your flush assignments before saving:

1. Sequential Order: Flushes must be numbered 1, 2, 3 in order

   • Error: “First flush must be Flush 1”
   • Error: “Found Flush X but expected Flush Y. Flushes must be sequential.”

2. No Overlapping Dates: Flush date ranges cannot overlap

   • Error: “Flush X starts on [date] which overlaps with Flush Y that ends on [date]”

3. Date Order: Start date must be before or equal to end date

   • Error: “Flush X: Start date cannot be after end date”

If validation fails, you’ll see error messages explaining what needs to be fixed. Correct the issues and try saving again.

What Happens When You Save

When you successfully save flush assignments:

1. Flush Records Created/Updated: The system creates new flush records or updates existing ones
2. Transactions Linked: Transactions for those dates are linked to the appropriate flush
3. Planting Closed: The planting’s end date is automatically set to the last flush’s end date
4. Success Notification: You’ll see a confirmation message for each flush created or updated

Creating a Flush Manually

Who can do this: Super Admin, Operations Manager

You can also create flushes directly without using the Flushing page:

1. Click Flushes in the sidebar
2. Click the New flush button (top right)
3. Fill in the form:
   • Name: Enter a name (e.g., “Flush1”, “Flush2”)
   • Planting: Select the planting this flush belongs to
   • Room: Select the room (should match the planting’s room)
   • Flush Number (Sequence): Enter 1, 2, or 3
   • Start Date: First harvest date for this flush
   • End Date: Last harvest date for this flush
4. Click Create

When to Create Manually

Manual creation is useful for:

• Correcting flush assignments
• Adding flushes that weren’t created through the Flushing page
• Making adjustments after initial setup

Viewing a Single Flush

1. From the Flushes list, click the eye icon (View) on any row
2. You’ll see all flush details including the associated planting and room

Editing a Flush

Who can do this: Super Admin, Operations Manager

1. From the Flushes list, click the pencil icon (Edit) on any row
2. Modify the fields as needed
3. Click Save

Editing Flush Dates

When you change flush dates:

• Transactions within the new date range will be linked to this flush
• Transactions outside the new date range may lose their flush assignment
• Be careful when editing dates on flushes that already have transactions

Changing Flush Number

You can change the flush number (sequence), but be aware:

• This may affect the sequential order validation
• Other flushes for the same planting may need adjustment
• Consider using the Flushing page workflow instead for major changes

Deleting a Flush

Who can do this: Super Admin, Operations Manager

1. From the Flushes list, click the Edit button
2. Click the Delete button
3. Confirm the deletion when prompted

Warning

Deleting a flush will:

• Remove the flush record
• Transactions linked to this flush will lose their flush assignment
• The flush number will be available for reassignment
• You can restore deleted flushes using the “Deleted records” filter

Viewing Flushes for a Planting

From the Planting View Page

1. Open a planting record (click the eye icon in Plantings)
2. Scroll to the Flushes panel
3. You’ll see all flushes for this planting
4. You can create, edit, or delete flushes from here

From the Flushes Section

1. Click Flushes in the sidebar
2. The table shows all flushes with their associated plantings
3. You can sort or filter to find specific plantings

Common Workflows

Closing a Planting with Flushes

1. Ensure all harvest dates have transactions recorded
2. Go to Plantings and find the active planting
3. Click the Close button
4. On the Flushing page:
   • Review the harvest dates and weights
   • Assign Flush1 to the first harvest period
   • Assign Flush2 to the second harvest period (after Flush1 ends)
   • Assign Flush3 to the third harvest period (after Flush2 ends)
5. Select all date rows
6. Click Actions → Save Changes
7. The planting is automatically closed

Correcting Flush Assignments

If you need to fix flush assignments:

1. Go to Flushes in the sidebar
2. Find the flush you want to correct
3. Click Edit
4. Adjust the dates or flush number as needed
5. Click Save

Or use the Flushing page:

1. Go to Plantings and open the planting
2. Click Close (even if already closed, you can still access the page)
3. Use the Clear button to remove incorrect assignments
4. Reassign dates to the correct flushes
5. Save changes

Adding a Missing Flush

If a flush wasn’t created during the initial setup:

1. Go to Flushes in the sidebar
2. Click New flush
3. Select the planting
4. Enter the flush number, name, and date range
5. Click Create

Make sure the flush number follows sequential order and doesn’t overlap with existing flushes.

Troubleshooting

Cannot Access Flushing Page

• Make sure you have permission to manage flushes (Super Admin or Operations Manager)
• The planting must exist and be active (no end date) to use the Close button
• Contact your administrator if you need access

Validation Errors When Saving

Common validation errors and solutions:

“First flush must be Flush 1”

• Make sure you start with Flush1, not Flush2 or Flush3
• Clear all assignments and start over with Flush1

“Flushes must be sequential”

• You cannot skip numbers (e.g., Flush1 then Flush3)
• Assign Flush1, then Flush2, then Flush3 in order

“Flush X overlaps with Flush Y”

• Flush date ranges cannot overlap
• Make sure Flush2 starts after Flush1 ends
• Make sure Flush3 starts after Flush2 ends

“Start date cannot be after end date”

• For each flush, the start date must be before or equal to the end date
• Check your date assignments

Dates Not Showing in Flushing Page

• Make sure transactions exist for the planting’s room and date range
• Check that the planting’s start date is before the transaction dates
• Verify the room and planting are correctly selected in the filters

Cannot Create Flush

Only Super Admins and Operations Managers can create flushes. Contact your administrator if you need this access.

Flush Not Appearing for Planting

• Check that the flush is linked to the correct planting
• Use the Flushes section and filter by planting
• Verify the flush hasn’t been deleted (use “Deleted records” filter)

Transactions Not Linked to Flush

• Transactions are automatically linked when you save flush assignments on the Flushing page
• If transactions aren’t linked, verify the transaction dates fall within the flush’s date range
• You may need to adjust flush dates to include the transaction dates

Planting Not Closing Automatically

• The planting closes automatically when you save flush assignments on the Flushing page
• The end date is set to the last flush’s end date
• If the planting didn’t close, check that flushes were successfully saved
• You can manually set an end date on the planting if needed