feat: Plant Touch Points & IPM Tracking Spec
📋 New Feature Spec from 777 Wolfpack Feedback
Requirements:
- Touch points system for every plant interaction
- Record data at each touch point (type, notes, photos)
- IPM schedule tracking (10-day root drench cycles)
- Pyganic 5.0 product tracking
- Mobile-first quick entry
- Alerts for IPM treatments
Database Design:
- PlantTouchPoint model (touch type, measurements, photos)
- IPMSchedule model (10-day intervals, auto-calc next treatment)
- TouchPointType enum (WATERING, FEEDING, IPM_TREATMENT, etc.)
UI Design:
- Quick action buttons for common touch points
- IPM schedule screen with alerts
- Photo capture
- Touch point history timeline
Priority: Phase 2 (after Daily Walkthrough)
Estimated: 17 hours (2-3 days)
Team: 777 Wolfpack
Status: Spec Complete - Ready for Phase 2
This commit is contained in:
fullsizemalt
parent
84ac830a10
commit
d83c794963
2 changed files with 343 additions and 21 deletions
|
|
@ -12,33 +12,27 @@
|
||||||
|
|
||||||
- **Email**: `admin@runfoo.run`
|
- **Email**: `admin@runfoo.run`
|
||||||
- **Password**: `password123`
|
- **Password**: `password123`
|
||||||
- **Role**: OWNER
|
|
||||||
- **Permissions**: Full access to all features
|
|
||||||
- **Hourly Rate**: $50.00
|
|
||||||
|
|
||||||
### Manager Account
|
## Login Credentials
|
||||||
|
|
||||||
- **Email**: `manager@runfoo.run`
|
All test users have the password: `password123`
|
||||||
- **Password**: `password123`
|
|
||||||
- **Role**: MANAGER
|
|
||||||
- **Permissions**: Full access except user management
|
|
||||||
- **Hourly Rate**: $35.00
|
|
||||||
|
|
||||||
### Grower Account
|
### Test Users (All Roles)
|
||||||
|
|
||||||
- **Email**: `grower@runfoo.run`
|
| Email | Password | Role | Hourly Rate | Name |
|
||||||
- **Password**: `password123`
|
|-------|----------|------|-------------|------|
|
||||||
- **Role**: GROWER
|
| <admin@runfoo.run> | password123 | OWNER | $50.00 | Facility Owner |
|
||||||
- **Permissions**: Read/write batches, rooms, tasks
|
| <manager@runfoo.run> | password123 | MANAGER | $35.00 | Test Manager |
|
||||||
- **Hourly Rate**: $30.00
|
| <grower@runfoo.run> | password123 | GROWER | $30.00 | Test Grower |
|
||||||
|
| <staff@runfoo.run> | password123 | STAFF | $20.00 | Test Staff |
|
||||||
|
|
||||||
### Staff Account
|
### 777 Wolfpack Team (Production Users)
|
||||||
|
|
||||||
- **Email**: `staff@runfoo.run`
|
| Email | Password | Role | Hourly Rate | Name |
|
||||||
- **Password**: `password123`
|
|-------|----------|------|-------------|------|
|
||||||
- **Role**: STAFF
|
| <travis@runfoo.run> | password123 | MANAGER | $35.00 | Travis |
|
||||||
- **Permissions**: Read-only + timeclock
|
| <jen@runfoo.run> | password123 | GROWER | $30.00 | Jen |
|
||||||
- **Hourly Rate**: $20.00
|
| <king@runfoo.run> | password123 | GROWER | $30.00 | King |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
|
||||||
328
specs/plant-touch-points-ipm.md
Normal file
328
specs/plant-touch-points-ipm.md
Normal file
|
|
@ -0,0 +1,328 @@
|
||||||
|
# Feature Spec: Plant Touch Points & IPM Tracking
|
||||||
|
|
||||||
|
**Priority**: 🟡 High (Phase 2)
|
||||||
|
**Team**: 777 Wolfpack
|
||||||
|
**Date**: 2025-12-09
|
||||||
|
**Status**: New Requirement
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 Overview
|
||||||
|
|
||||||
|
A **touch points system** that allows staff to record data at each interaction with plants, with specific focus on **IPM (Integrated Pest Management)** tracking for the veg room.
|
||||||
|
|
||||||
|
**Key Insight from 777 Wolfpack**:
|
||||||
|
> "Basically a touch points app - at each touch point to plant to simply record and compile data"
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🎯 User Story
|
||||||
|
|
||||||
|
**As a** 777 Wolfpack grower
|
||||||
|
**I want** to record data every time I interact with a plant
|
||||||
|
**So that** we have a complete history of all plant interactions and can track IPM schedules
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ✅ Core Requirements
|
||||||
|
|
||||||
|
### 1. Plant Touch Points
|
||||||
|
|
||||||
|
**What**: Record every interaction with plants
|
||||||
|
|
||||||
|
**Touch Point Types**:
|
||||||
|
|
||||||
|
- Watering
|
||||||
|
- Feeding
|
||||||
|
- Pruning
|
||||||
|
- Training
|
||||||
|
- Inspection
|
||||||
|
- IPM Treatment
|
||||||
|
- Transplanting
|
||||||
|
- Harvesting
|
||||||
|
|
||||||
|
**Data to Capture**:
|
||||||
|
|
||||||
|
- Touch point type
|
||||||
|
- Plant/Batch ID
|
||||||
|
- Date/Time (auto)
|
||||||
|
- Staff member (auto from JWT)
|
||||||
|
- Notes
|
||||||
|
- Photos (optional)
|
||||||
|
- Measurements (height, width, etc.)
|
||||||
|
- Issues observed
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2. IPM Plan - Root Drench Schedule
|
||||||
|
|
||||||
|
**What**: 10-day cycle root drench IPM plan for veg room
|
||||||
|
|
||||||
|
**Specific Product**: Pyganic 5.0 (when budget allows)
|
||||||
|
|
||||||
|
**Schedule**:
|
||||||
|
|
||||||
|
- **Day 0**: Root drench with Pyganic 5.0
|
||||||
|
- **Day 10**: Root drench with Pyganic 5.0
|
||||||
|
- **Day 20**: Root drench with Pyganic 5.0
|
||||||
|
- **Day 30**: Root drench with Pyganic 5.0
|
||||||
|
- (Repeat every 10 days)
|
||||||
|
|
||||||
|
**Requirements**:
|
||||||
|
|
||||||
|
- [ ] Track last IPM treatment date per batch
|
||||||
|
- [ ] Calculate next treatment date (10 days)
|
||||||
|
- [ ] Alert when treatment is due
|
||||||
|
- [ ] Record treatment completion
|
||||||
|
- [ ] Track product used (Pyganic 5.0)
|
||||||
|
- [ ] Track dosage/concentration
|
||||||
|
- [ ] Photo of treatment (before/after)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🏗️ Implementation Design
|
||||||
|
|
||||||
|
### Database Schema
|
||||||
|
|
||||||
|
#### PlantTouchPoint Model
|
||||||
|
|
||||||
|
```prisma
|
||||||
|
model PlantTouchPoint {
|
||||||
|
id String @id @default(uuid())
|
||||||
|
batchId String
|
||||||
|
batch Batch @relation(fields: [batchId], references: [id])
|
||||||
|
plantId String? // Optional individual plant ID
|
||||||
|
|
||||||
|
touchType TouchPointType
|
||||||
|
performedBy String
|
||||||
|
user User @relation(fields: [performedBy], references: [id])
|
||||||
|
|
||||||
|
timestamp DateTime @default(now())
|
||||||
|
notes String?
|
||||||
|
photoUrls String[] // Array of photo URLs
|
||||||
|
|
||||||
|
// Measurements
|
||||||
|
heightCm Float?
|
||||||
|
widthCm Float?
|
||||||
|
|
||||||
|
// IPM specific
|
||||||
|
ipmProduct String? // e.g., "Pyganic 5.0"
|
||||||
|
ipmDosage String? // e.g., "1 oz per gallon"
|
||||||
|
|
||||||
|
// Issues
|
||||||
|
issuesObserved Boolean @default(false)
|
||||||
|
issueType String?
|
||||||
|
|
||||||
|
createdAt DateTime @default(now())
|
||||||
|
updatedAt DateTime @updatedAt
|
||||||
|
|
||||||
|
@@map("plant_touch_points")
|
||||||
|
}
|
||||||
|
|
||||||
|
enum TouchPointType {
|
||||||
|
WATERING
|
||||||
|
FEEDING
|
||||||
|
PRUNING
|
||||||
|
TRAINING
|
||||||
|
INSPECTION
|
||||||
|
IPM_TREATMENT
|
||||||
|
TRANSPLANTING
|
||||||
|
HARVESTING
|
||||||
|
OTHER
|
||||||
|
}
|
||||||
|
|
||||||
|
model IPMSchedule {
|
||||||
|
id String @id @default(uuid())
|
||||||
|
batchId String
|
||||||
|
batch Batch @relation(fields: [batchId], references: [id])
|
||||||
|
|
||||||
|
product String // "Pyganic 5.0"
|
||||||
|
intervalDays Int // 10
|
||||||
|
lastTreatment DateTime?
|
||||||
|
nextTreatment DateTime?
|
||||||
|
|
||||||
|
isActive Boolean @default(true)
|
||||||
|
|
||||||
|
createdAt DateTime @default(now())
|
||||||
|
updatedAt DateTime @updatedAt
|
||||||
|
|
||||||
|
@@map("ipm_schedules")
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📱 Mobile UI Design
|
||||||
|
|
||||||
|
### Touch Point Entry Screen
|
||||||
|
|
||||||
|
**Layout** (Mobile-First):
|
||||||
|
|
||||||
|
1. **Quick Actions** (Large buttons)
|
||||||
|
- 💧 Water
|
||||||
|
- 🍃 Feed
|
||||||
|
- ✂️ Prune
|
||||||
|
- 🔍 Inspect
|
||||||
|
- 🛡️ IPM Treatment
|
||||||
|
|
||||||
|
2. **Batch Selection**
|
||||||
|
- Dropdown or quick select
|
||||||
|
- Show current room/location
|
||||||
|
|
||||||
|
3. **Data Entry**
|
||||||
|
- Notes (optional)
|
||||||
|
- Photos (camera button)
|
||||||
|
- Measurements (optional)
|
||||||
|
|
||||||
|
4. **Submit**
|
||||||
|
- Save touch point
|
||||||
|
- Return to dashboard
|
||||||
|
|
||||||
|
### IPM Schedule Screen
|
||||||
|
|
||||||
|
**Layout**:
|
||||||
|
|
||||||
|
1. **Active Batches** (Veg Room)
|
||||||
|
- Batch name
|
||||||
|
- Last IPM treatment date
|
||||||
|
- Next treatment date
|
||||||
|
- Days until next treatment
|
||||||
|
|
||||||
|
2. **Treatment Due** (Alert)
|
||||||
|
- Red badge if overdue
|
||||||
|
- Yellow badge if due today
|
||||||
|
- Green if not due
|
||||||
|
|
||||||
|
3. **Record Treatment**
|
||||||
|
- Tap batch → Record IPM treatment
|
||||||
|
- Auto-fill product (Pyganic 5.0)
|
||||||
|
- Enter dosage
|
||||||
|
- Take photos
|
||||||
|
- Submit
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔔 Notifications
|
||||||
|
|
||||||
|
### IPM Treatment Alerts
|
||||||
|
|
||||||
|
- **3 days before**: "IPM treatment due in 3 days for Batch X"
|
||||||
|
- **Day of**: "IPM treatment DUE TODAY for Batch X"
|
||||||
|
- **Overdue**: "IPM treatment OVERDUE for Batch X (2 days late)"
|
||||||
|
|
||||||
|
### Touch Point Reminders
|
||||||
|
|
||||||
|
- Daily reminder to record touch points
|
||||||
|
- Weekly summary of touch points per batch
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📊 Reporting
|
||||||
|
|
||||||
|
### Touch Point History
|
||||||
|
|
||||||
|
- View all touch points for a batch
|
||||||
|
- Filter by type (watering, feeding, IPM, etc.)
|
||||||
|
- Timeline view
|
||||||
|
- Photo gallery
|
||||||
|
|
||||||
|
### IPM Compliance Report
|
||||||
|
|
||||||
|
- All batches with IPM schedules
|
||||||
|
- Treatment history
|
||||||
|
- Compliance percentage
|
||||||
|
- Upcoming treatments
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ✅ Acceptance Criteria
|
||||||
|
|
||||||
|
- [ ] Staff can quickly record touch points on mobile
|
||||||
|
- [ ] All touch point types supported
|
||||||
|
- [ ] Photos can be attached to touch points
|
||||||
|
- [ ] IPM schedule auto-calculates next treatment date
|
||||||
|
- [ ] Alerts sent for upcoming IPM treatments
|
||||||
|
- [ ] Touch point history viewable per batch
|
||||||
|
- [ ] IPM compliance report available
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🚀 Implementation Priority
|
||||||
|
|
||||||
|
**Phase**: Should be in **Phase 2** (after Daily Walkthrough)
|
||||||
|
|
||||||
|
**Estimated Effort**:
|
||||||
|
|
||||||
|
- Database schema: 2 hours
|
||||||
|
- Backend API: 4 hours
|
||||||
|
- Mobile UI: 6 hours
|
||||||
|
- IPM scheduling logic: 3 hours
|
||||||
|
- Notifications: 2 hours
|
||||||
|
- **Total**: ~17 hours (2-3 days)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔗 Related Features
|
||||||
|
|
||||||
|
- **Daily Walkthrough**: Touch points can be created during walkthrough
|
||||||
|
- **Batches and Rooms**: Touch points linked to batches
|
||||||
|
- **Tasks and Scheduling**: IPM treatments are scheduled tasks
|
||||||
|
- **Compliance**: Touch point history is audit trail
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📝 Notes from 777 Wolfpack Team
|
||||||
|
|
||||||
|
> "Basically a touch points app at each touch point to plant to simply record and compile data"
|
||||||
|
|
||||||
|
This is the core workflow - every time a grower touches a plant, they should be able to quickly record what they did.
|
||||||
|
|
||||||
|
> "Root drench ipm plan on 10 day sections in veg room with pyganic 5.0 once we can afford it"
|
||||||
|
|
||||||
|
**Key Details**:
|
||||||
|
|
||||||
|
- **Product**: Pyganic 5.0 (organic pyrethrin-based insecticide)
|
||||||
|
- **Schedule**: Every 10 days
|
||||||
|
- **Application**: Root drench
|
||||||
|
- **Room**: Veg room only
|
||||||
|
- **Budget**: "Once we can afford it" - need to track product inventory/cost
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 💡 Quick Wins
|
||||||
|
|
||||||
|
### MVP (Minimum Viable Product)
|
||||||
|
|
||||||
|
1. Simple touch point recording (type, notes, photo)
|
||||||
|
2. IPM schedule tracker (10-day intervals)
|
||||||
|
3. Basic alerts for IPM treatments
|
||||||
|
|
||||||
|
### Future Enhancements
|
||||||
|
|
||||||
|
- [ ] Barcode scanning for plant IDs
|
||||||
|
- [ ] Voice-to-text for notes
|
||||||
|
- [ ] AI-powered issue detection from photos
|
||||||
|
- [ ] Inventory tracking for IPM products
|
||||||
|
- [ ] Cost tracking per treatment
|
||||||
|
- [ ] Integration with environmental sensors
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🎯 Success Metrics
|
||||||
|
|
||||||
|
### Adoption
|
||||||
|
|
||||||
|
- 80%+ of plant interactions recorded
|
||||||
|
- Average touch point entry time < 30 seconds
|
||||||
|
- 100% IPM treatment compliance
|
||||||
|
|
||||||
|
### Quality
|
||||||
|
|
||||||
|
- Complete touch point history for all batches
|
||||||
|
- Zero missed IPM treatments
|
||||||
|
- Early pest detection through regular touch points
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**Status**: ✅ Spec Complete - Ready for Implementation
|
||||||
|
**Next Step**: Review with 777 Wolfpack team, then implement in Phase 2
|
||||||
Loading…
Add table
Reference in a new issue