ca-grow-ops-manager/ROADMAP.md
fullsizemalt 17138b2f80 docs: Add roadmap + implementation plan
📋 Documentation:
- ROADMAP.md (complete feature roadmap)
- QUICK-IMPLEMENTATION-PLAN.md (shopping list, touch points, tasks)

⚠️ CRITICAL ISSUE IDENTIFIED:
- ALL pages have hardcoded bg-white (not dark mode compatible)
- Need to fix: Dashboard, Batches, Rooms, Timeclock, Walkthrough
- Font stack reverting to Inter (CSS not syncing properly)

Next: Mass dark mode fix for all pages
2025-12-09 15:05:53 -08:00

451 lines
9.1 KiB
Markdown

# 777 Wolfpack Grow Ops Manager - Complete Roadmap
**Version**: 0.2.0
**Last Updated**: 2025-12-09
**Team**: 777 Wolfpack
---
## ✅ **PHASE 1: FOUNDATION** (COMPLETE)
### Sprint 1: Infrastructure ✅
- Backend health checks
- Database setup (PostgreSQL + Prisma)
- Docker deployment
- Traefik routing
- Redis integration
### Sprint 2: Authentication & RBAC ✅
- JWT authentication (access + refresh tokens)
- Bcrypt password hashing
- User roles (OWNER, MANAGER, GROWER, STAFF)
- Login/logout
- Protected routes
### Sprint 2.5: Mobile-First UI ✅
- Space Grotesk font (premium typography)
- Emerald & Slate color scheme
- SVG icons (Lucide React)
- Smooth animations
- Dark/Light/Auto theme toggle
- Touch-optimized (44px+ targets)
- Accessibility (WCAG 2.1 AA)
---
## ✅ **PHASE 1.5: DAILY WALKTHROUGH** (COMPLETE)
### Database Schema ✅
- DailyWalkthrough model
- ReservoirCheck (4 tanks)
- IrrigationCheck (4 zones)
- PlantHealthCheck (4 zones)
- 5 enums for status tracking
### Backend API ✅
- 7 endpoints (CRUD + checks)
- JWT authentication
- User attribution
- Error handling
### Frontend UI ✅
- Start screen with 777 Wolfpack branding
- Reservoir checklist (visual tank indicators)
- Irrigation checklist (dripper tracking)
- Plant health checklist (pest monitoring)
- Summary/review screen
- Complete integration
**Status**: ✅ **DEPLOYED & WORKING**
---
## 🔄 **PHASE 2: CORE OPERATIONS** (IN PROGRESS)
### 2.1: Plant Touch Points & IPM Tracking
**Priority**: 🔴 Critical
**Estimated**: 17 hours (2-3 days)
**Features**:
- Touch point recording (every plant interaction)
- Touch types: Watering, Feeding, Pruning, Training, Inspection, IPM, Transplanting, Harvesting
- IPM schedule tracking (10-day root drench cycles)
- Pyganic 5.0 product tracking
- Photo documentation
- Alerts for IPM treatments
**Database**:
- PlantTouchPoint model
- IPMSchedule model
- TouchPointType enum
**Spec**: `specs/plant-touch-points-ipm.md`
---
### 2.2: Photo Management & Storage
**Priority**: 🔴 Critical
**Estimated**: 7-11 hours
**Features**:
- Client-side compression (WebP, 80% quality)
- Server-side multi-size generation (thumb/medium/full)
- 85-90% storage reduction
- Local storage with daily backups
- 7-year retention for CA compliance
**Tech**:
- Sharp for server-side processing
- browser-image-compression for client-side
- 3 sizes: 200px, 800px, 1920px
**Spec**: `specs/photo-management.md`
---
### 2.3: Grow Room Heatmap
**Priority**: 🟡 High
**Estimated**: 12-15 hours
**Features**:
- Visual heat-map of plant health
- 2-level room layout (floor_1, floor_2)
- Color-coded health scores (0-100)
- Hover tooltips with bed details
- Sensor data overlay (temp, humidity, EC, PAR)
- SVG-based grid rendering
**Components**:
- GrowRoomHeatmap (main)
- FloorGrid (SVG grid)
- BedCell (individual beds)
- BedTooltip (hover details)
- FloorToggle (floor selector)
- HealthLegend (color scale)
**Spec**: `specs/grow-room-heatmap.md`
---
## 📦 **PHASE 3: INVENTORY & MATERIALS**
**Priority**: 🟡 High
**Estimated**: 30-40 hours (1-2 weeks)
### Features
#### Item Catalog
- Nutrients (base, additives, supplements)
- Growing media (soil, coco, rockwool)
- Pots and containers
- IPM products (pesticides, beneficial insects)
- PPE (gloves, masks, suits)
- CO₂ tanks and regulators
- Filters (carbon, HEPA)
- Packaging (jars, bags, labels)
- Tools and equipment
#### Inventory Tracking
- Add stock (deliveries with lot and cost)
- Use stock (with batch linkage)
- Adjust stock (with reason and approval)
- Transfer stock (between locations)
- Automatic updates (future: task completion)
#### Restock Alerts
- Min threshold alerts
- Expiration alerts
- Restock suggestions (usage trends)
#### Lot/Serial Tracking
- Link lots to batches (traceability)
- Recall support (query batches by lot)
- Supplier traceability
#### Supplier Management
- Supplier database
- Contact information
- Performance tracking
- Purchase order history
#### Shopping List
- Low stock report
- Restock suggestions
- Cost estimates
- Supplier recommendations
#### Reporting
- Current inventory
- Low stock report
- Usage report (by item, batch, period)
- Cost report (per batch)
- Expiration report
**Database**:
- InventoryItem model
- InventoryLot model
- InventoryTransaction model
- BatchMaterialLink model
- Supplier model
- ItemCategory enum
- TransactionType enum
**Spec**: `specs/inventory-and-materials.md`
---
## 📅 **PHASE 4: TASKS & SCHEDULING**
**Priority**: 🟡 High
**Estimated**: 25-35 hours
### Features
- Task templates (recurring tasks)
- Task scheduling (calendar view)
- Task assignment (by user/role)
- Task completion tracking
- Automatic stock deduction
- Batch lifecycle tasks
- Notifications and reminders
**Database**:
- Task model
- TaskTemplate model
- TaskAssignment model
- TaskStatus enum
**Spec**: `specs/tasks-and-scheduling.md`
---
## 🌱 **PHASE 5: ADVANCED BATCH LIFECYCLE**
**Priority**: 🟢 Medium
**Estimated**: 20-30 hours
### Features
- Batch creation and tracking
- Growth stage management
- Yield tracking and analytics
- Batch notes and observations
- Batch-to-batch comparisons
- Harvest scheduling
- Waste tracking
**Database**:
- Enhanced Batch model
- BatchStage enum
- BatchNote model
- YieldRecord model
**Spec**: `specs/batches-and-rooms.md`
---
## 📱 **PHASE 6: PWA & MOBILE**
**Priority**: 🟢 Medium
**Estimated**: 10-15 hours
### Features
- Service worker (offline support)
- Web manifest (Android APK)
- Install prompt for Android users
- Offline data sync
- Push notifications
- Background sync
- App icons (192px, 512px)
**Status**: ⏳ Manifest created, service worker pending
---
## 📊 **PHASE 7: REPORTING & ANALYTICS**
**Priority**: 🟢 Medium
**Estimated**: 20-25 hours
### Features
- Dashboard with key metrics
- Batch performance analytics
- Cost analysis
- Yield predictions
- Environmental trends
- Labor efficiency
- Export to PDF/Excel
---
## 🔔 **PHASE 8: COMMUNICATIONS & NOTIFICATIONS**
**Priority**: 🟢 Medium
**Estimated**: 15-20 hours
### Features
- In-app notifications
- Email notifications
- SMS alerts (critical issues)
- Slack integration
- Discord integration
- Notification preferences
- Alert escalation
**Spec**: `specs/communications-and-notifications.md`
---
## 📋 **PHASE 9: COMPLIANCE & DOCUMENTATION**
**Priority**: 🟢 Medium
**Estimated**: 25-30 hours
### Features
- Compliance checklists
- Document management
- Audit trail
- Regulatory reporting
- Certificate tracking
- Inspection readiness
- Export compliance reports
**Spec**: `specs/compliance-and-docs.md`
---
## 🔌 **PHASE 10: INTEGRATIONS & HARDWARE**
**Priority**: 🔵 Low
**Estimated**: 30-40 hours
### Features
- Environmental sensors (temp, humidity, CO₂)
- Irrigation controllers
- Lighting controllers
- Security cameras
- Access control
- HVAC integration
- Real-time monitoring
**Spec**: `specs/integrations-and-hardware.md`
---
## 🎯 **QUICK WINS** (Can be done anytime)
### Error Handling
- ErrorBoundary component
- 404 page
- Network error handling
- Form validation
- API error messages
### UI Polish
- Loading skeletons
- Empty states
- Success animations
- Error animations
- Toast notifications
### Performance
- Code splitting
- Lazy loading
- Image optimization
- API caching
- Database indexing
---
## 📊 **ESTIMATED TIMELINE**
| Phase | Status | Estimated Time | Priority |
|-------|--------|----------------|----------|
| Phase 1: Foundation | ✅ Complete | - | - |
| Phase 1.5: Daily Walkthrough | ✅ Complete | - | - |
| Phase 2: Core Operations | 🔄 In Progress | 36-41 hours | 🔴 Critical |
| Phase 3: Inventory | 📋 Spec'd | 30-40 hours | 🟡 High |
| Phase 4: Tasks & Scheduling | 📋 Spec'd | 25-35 hours | 🟡 High |
| Phase 5: Advanced Batches | 📋 Spec'd | 20-30 hours | 🟢 Medium |
| Phase 6: PWA & Mobile | ⏳ Started | 10-15 hours | 🟢 Medium |
| Phase 7: Reporting | 📋 Spec'd | 20-25 hours | 🟢 Medium |
| Phase 8: Communications | 📋 Spec'd | 15-20 hours | 🟢 Medium |
| Phase 9: Compliance | 📋 Spec'd | 25-30 hours | 🟢 Medium |
| Phase 10: Integrations | 📋 Spec'd | 30-40 hours | 🔵 Low |
**Total Remaining**: ~211-276 hours (~5-7 weeks at 40 hours/week)
---
## 🎯 **RECOMMENDED NEXT STEPS**
### Immediate (This Week)
1. ✅ Complete Phase 2.1: Touch Points & IPM
2. ✅ Complete Phase 2.2: Photo Management
3. ✅ Complete Phase 2.3: Grow Room Heatmap
### Short-term (Next 2 Weeks)
4. ✅ Complete Phase 6: PWA & Mobile
5. ✅ Start Phase 3: Inventory & Materials
### Medium-term (Next Month)
6. ✅ Complete Phase 3: Inventory
7. ✅ Complete Phase 4: Tasks & Scheduling
8. ✅ Start Phase 5: Advanced Batches
### Long-term (2-3 Months)
9. ✅ Complete Phases 7-9 (Reporting, Communications, Compliance)
10. ✅ Evaluate Phase 10 (Integrations & Hardware)
---
## 📝 **NOTES**
- All specs are complete and ready for implementation
- Database schemas are designed
- API endpoints are defined
- UI components are outlined
- Mobile-first approach throughout
- 777 Wolfpack branding consistent
- Accessibility compliance (WCAG 2.1 AA)
---
**Status**: Phase 1 & 1.5 complete. Phase 2 in progress. Ready to accelerate! 🚀