Operations: Plant Work

Dashboard & WIP List

9:41

Active Items

Near Storage

In Storage

All

Pickup

In Plant

Ready

Stored

All Types

Area Rugs

Drapery

Blinds

Upholstery

PLT-000142

Margaret Thompson

8x10 Persian wool rug, blue/cream pattern

Area Rug

Cleaning

In: Feb 28 Due: Mar 12

PLT-000138

David Chen

Linen drapery panels, 4 sets, ivory

Drapery

Ready

In: Feb 20 Due: Mar 8

PLT-000145

Sarah Rodriguez

2 roman blinds, custom linen, beige

Blinds

Pending Pickup

Due: Mar 14

PLT-000119

James Whitfield

Velvet sofa cushion covers, set of 5

Upholstery

Stored

In: Jan 15 Due: Feb 1

Dashboard (Populated)

Summary cards + SegmentedControl + type pills
listPlantWorkItems + getPlantQueueSummary

9:41

Active Items

Near Storage

In Storage

All

Pickup

In Plant

Ready

Stored

No plant work items

Track pickup and delivery items like area rugs, drapery, and blinds through your plant processing workflow.

Empty State

IconCircle D hero + CTA to first intake

Item Detail

9:41

In Cleaning

Updated 2 hours ago

Customer

Margaret Thompson

(330) 555-0187

m.thompson@email.com

1247 Oak Valley Dr, Akron, OH 44313

Item Details

Area Rug

8x10 Persian wool rug, blue/cream pattern with fringe

96" x 120" (80.0 sq ft)

Quantity: 1

Condition Notes

Light pet stains in southwest corner. Minor fringe unraveling on east side. Customer noted high sentimental value.

Location & Storage

Rack

A-12

Bin

Days in Plant

Storage Fee

$0.00

Detail — Top Half

Status hero + actions + customer + item details
getPlantWorkItem

9:41

Schedule

Pickup Date

Feb 27

Actual Pickup

Feb 27

Received

Feb 28

Delivery Date

Mar 12

Pricing

Quoted

$485.00

Final

$485.00

Status History

In Cleaning Mar 6, 10:15 AM

Submersion wash started, pet treatment applied

by Mike Reynolds

Inspected Mar 4, 2:30 PM

Stains confirmed, no dye instability

by Mike Reynolds

Received at Plant Feb 28, 9:45 AM

Placed in rack A-12, bin 05

by Carlos Diaz

Picked Up Feb 27, 3:20 PM

by Carlos Diaz

Pending Pickup Feb 25, 11:00 AM

Customer called in, scheduled pickup

by Front Desk

Detail — Bottom Half

Schedule + pricing + status timeline
Vertical timeline with colored dots + connecting lines

9:41

In Storage

Updated 12 days ago

Customer

James Whitfield

(216) 555-0293

j.whitfield@email.com

Location & Storage

Rack

C-03

Bin

Days in Plant

Storage Fee

$22.00

Pricing

Quoted

$320.00

Final

$295.00

Schedule

Received

Jan 15

Delivery Date

Feb 1 (overdue)

Detail — Stored Item

52 days in plant, storage fee accruing
Warning/error color states for overdue

Bottom Sheets

9:41

In Cleaning

Updated 2 hours ago

Customer

Margaret Thompson

(330) 555-0187

1247 Oak Valley Dr, Akron

Update Status

New Status

Drying

Finishing

Rack Location

Bin Number

Notes (optional)

Update Status Sheet

Status options + rack/bin fields + notes
updatePlantWorkItemStatus

9:41

Ready for Delivery

Updated 1 day ago

Customer

James Kowalski

(216) 555-0234

892 Elm St, Cleveland

Schedule Delivery

Delivery Date

March 10, 2026

Delivery Notes (optional)

Schedule Delivery Sheet

Date picker + delivery notes
scheduleDelivery

9:41

In Cleaning

Updated 2 hours ago

Customer

Margaret Thompson

(330) 555-0187

1247 Oak Valley Dr, Akron

Request Reclean

Reason for Reclean

Request Reclean Sheet

Reason textarea (required) + submit
requestReclean

New Plant Item — Intake

9:41

Customer Information

Customer Name

Phone Number

Address

Item Type

Area Rug

Drapery

Blinds

Upholstery

Specialty

Other

Intake — Top

Customer info + 6-button item type grid
Selected = terracotta fill, unselected = outline

9:41

Item Details

Description

Quantity

Quoted Price

Dimensions (inches)

Width

Length

54.0 sq ft

Condition Notes

Pickup Schedule

Initial Status

Pickup Date

March 10, 2026

Pickup Notes

Intake — Bottom

Item details with dimensions + sq ft preview
Pickup scheduling + submit
createPlantWorkItem

Plant Settings

9:41

Storage Settings

Configure when storage fees begin and the monthly rate.

Grace Period (days)

Days before storage fees apply

Monthly Storage Rate

Per item per month

Items exceeding the grace period will automatically be marked as “stored” and begin accumulating storage fees.

Tag Numbering

Configure how tag numbers are generated for new items.

Tag Prefix

Preview:

PLT-000146

Notifications

Notify Customer on Status Change Send updates when item status changes

Notify Dispatch When Ready Alert dispatch team when items are ready for delivery

Current Stats

Next Tag Number

146

Settings Updated

3/5/2026

Plant Settings

Storage config + tag prefix + notifications + stats
getPlantWorkSettings / upsertPlantWorkSettings

Data Architecture

Source Files

app/(contractor)/(tabs)/(home)/operations/plant-work/index.tsx — Dashboard (WIP list)
app/(contractor)/(tabs)/(home)/operations/plant-work/[id].tsx — Item Detail
app/(contractor)/(tabs)/(home)/operations/plant-work/intake.tsx — New Plant Item
app/(contractor)/(tabs)/(home)/operations/plant-work/settings.tsx — Plant Settings

Convex Queries

api.operations.plantWork.listPlantWorkItems — Paginated WIP list with filters
api.operations.plantWork.getPlantQueueSummary — Aggregate counts (active, near storage, in storage)
api.operations.plantWork.getPlantWorkItem — Single item with full history + computed fields
api.operations.plantWork.getPlantWorkSettings — Contractor plant settings

Convex Mutations

api.operations.plantWork.createPlantWorkItem — Create new item with auto-generated tag number
api.operations.plantWork.updatePlantWorkItemStatus — Advance status + rack/bin + notes + timestamp
api.operations.plantWork.scheduleDelivery — Set delivery date + notes on ready items
api.operations.plantWork.requestReclean — Flag item for reclean with reason
api.operations.plantWork.upsertPlantWorkSettings — Save storage/tag/notification settings

Status Flow

MAIN FLOW: pending_pickup → picked_up → received_at_plant → inspected → in_cleaning → drying → finishing → quality_check → ready_for_delivery → out_for_delivery → delivered BRANCH — STORAGE: Any in-plant status → stored (auto after grace period) stored → ready_for_delivery (manual release) BRANCH — RECLEAN: quality_check → reclean_requested → reclean_in_progress → quality_check TERMINAL: Any status → abandoned (manual, admin only)

Item Types

area_rug — Area rugs (has width/length dimensions)
drapery — Drapery panels (has width/length dimensions)
blinds — Window blinds
upholstery — Furniture upholstery
specialty — Special/custom items
other — Miscellaneous

Key Computed Fields

daysInPlant — Days since receivedAtPlantAt, warning color if > 30
storageFeeCents — Pro-rated from storageRatePerMonthCents after grace period
squareFeet — (widthInches × lengthInches) / 144
isOverdue — deliveryDate < today && status !== "delivered"

Operations: Plant Work

Plant Operations Hub

Intake & Configuration

Data Architecture

Source Files

Convex Queries

Convex Mutations

Status Flow

Item Types

Key Computed Fields