Canonical source: the canonical features document for this domain is
deep-dive/features.md, rendered in the docs center. This file is its operational companion (service topology, APIs, schemas, runtime detail) — reconciled by linking, not duplicated (§2, §13).
Comprehensive agriculture and home gardening platform: plant encyclopedias, companion planting intelligence, climate zone systems, IoT sensor networks, garden automation, hydroponic and aquaponic systems, food preservation with USDA/NCHFP compliance, community gardening, task scheduling, analytics, and AI-driven agricultural intelligence.
Table of Contents#
- Plant Encyclopedia and Knowledge Base
- Companion Planting Intelligence
- Pest and Disease Management
- Climate Zone System
- Seasonal Calendar and Planning
- Plant Search and Discovery
- Weather Integration
- IoT Sensor Network
- Garden Automation
- Garden Planning and Design
- Crop Rotation and Succession Planting
- Hydroponic Systems
- Aquaponics
- Indoor Growing and Controlled Environment
- Microgreens Production
- Mushroom Cultivation
- Seed and Supply Inventory
- Garden Journaling
- Post-Harvest Preservation
- Task and Schedule Management
- Community Gardening Platform
- Agricultural Analytics
- AI-Powered Agricultural Intelligence
- Data Foundation
1. Plant Encyclopedia and Knowledge Base#
1.1 Species Data Models#
| Capability | Description |
|---|---|
| Complete species profiles | Full botanical records with taxonomy, growing requirements, planting instructions, care guides, harvest timing, and nutritional content |
| Variety tracking | Multiple cultivar varieties per species with distinct growing characteristics, disease resistance, and flavor profiles |
| Taxonomic classification | Formal taxonomy (family, genus, species) for accurate plant identification and grouping |
| Growing requirements | Detailed sun, water, soil pH, soil type, temperature range, spacing, and depth requirements per species |
| Planting instructions | Step-by-step planting guidance covering direct sow, transplant, container, and raised bed methods |
| Care guides | Ongoing care instructions for watering frequency, fertilization schedule, pruning, staking, and mulching |
| Harvest information | When to harvest, how to harvest, expected yield, and storage recommendations after picking |
| Nutritional data | Per-serving nutritional profiles for edible plants including vitamins, minerals, and macronutrients |
| Culinary uses | Cooking applications, flavor profiles, and preparation methods for edible species |
| Medicinal uses | Traditional and documented medicinal properties, dosage guidance, and safety warnings |
1.2 Pre-Built Plant Databases#
| Capability | Description |
|---|---|
| Vegetable database | Comprehensive collection of vegetables with full growing profiles organized by family and season |
| Herb database | Culinary and medicinal herbs with growing conditions, harvest methods, and usage information |
| Fruit database | Fruit trees, bushes, and vines with pollination requirements, chill hours, and yield expectations |
| Flower database | Ornamental flowers categorized by bloom time, color, height, and pollinator attraction |
| Database validation | Built-in data integrity checks ensuring all plant records meet schema requirements |
| Cross-category search | Unified search across all plant databases with category-based filtering |
2. Companion Planting Intelligence#
2.1 Companion Relationships#
| Capability | Description |
|---|---|
| Companion database | Complete database of plant companion relationships with documented interaction mechanisms |
| Beneficial pairings | Identification of plants that actively help each other through pest deterrence, nutrient sharing, or shade provision |
| Detrimental pairings | Warnings for plants that inhibit each other through allelopathy, competition, or disease transmission |
| Relationship scoring | Numeric compatibility scores for any plant pairing based on multiple interaction factors |
| Mechanism documentation | Scientific explanation of why each companion relationship works (nitrogen fixation, trap cropping, etc.) |
2.2 Advanced Companion Planning#
| Capability | Description |
|---|---|
| Guild planting | Automated guild planting suggestions that combine complementary plants into self-supporting groups |
| Three Sisters layout | Pre-built layout generation for the traditional corn-beans-squash companion planting system |
| Bed compatibility | Whole-bed compatibility analysis that checks all plant-to-plant interactions within a garden bed |
| Companion chart | Visual companion chart generation showing relationships between selected plants as a matrix |
3. Pest and Disease Management#
3.1 Identification and Diagnosis#
| Capability | Description |
|---|---|
| Pest database | Comprehensive catalog of common garden pests with identification photos, damage symptoms, and host plants |
| Disease database | Plant disease reference covering bacterial, fungal, viral, and physiological conditions |
| Beneficial insect database | Catalog of beneficial insects with the pests they control and how to attract them |
| Pest identification | Symptom-based pest identification from observed damage patterns on plants |
| Treatment recommendations | Multi-option treatment plans ranging from organic to chemical with application instructions |
3.2 Integrated Pest Management (IPM)#
| Capability | Description |
|---|---|
| IPM plan generation | Automated generation of Integrated Pest Management plans based on garden conditions and pest pressure |
| Prevention strategies | Proactive prevention recommendations including crop rotation, companion planting, and physical barriers |
| Biological control | Guidance on using beneficial insects and organisms to control pest populations naturally |
| Threshold monitoring | Pest population tracking against action thresholds to determine when intervention is needed |
4. Climate Zone System#
4.1 Zone Classification#
| Capability | Description |
|---|---|
| USDA hardiness zones | Complete USDA Plant Hardiness Zone Map with minimum temperature ranges for all zones (1a through 13b) |
| Koppen climate classification | Global Koppen climate classification system mapping climate types to growing conditions |
| AHS heat zones | American Horticultural Society Heat Zone Map with heat day counts affecting plant performance |
| Frost date lookup | State-by-state last spring frost and first fall frost date database for planting timing |
4.2 Climate Calculations#
| Capability | Description |
|---|---|
| Growing season length | Automatic calculation of growing season duration from frost date data for any location |
| Growing degree days (GDD) | Accumulated heat unit tracking for predicting plant development stages and harvest dates |
| Chill hours | Chill hour accumulation calculation for fruit trees and perennials requiring winter dormancy |
| Hardiness checking | Automatic plant-to-zone compatibility verification to prevent planting in unsuitable climates |
| Zone-based filtering | Filter the entire plant database to show only species suitable for a given hardiness zone |
| Microclimate estimation | Microclimate factor analysis accounting for elevation, urban heat islands, wind exposure, and proximity to water |
5. Seasonal Calendar and Planning#
5.1 Planting Calendars#
| Capability | Description |
|---|---|
| Zone-based planting calendar | Planting calendars customized to local hardiness zone with indoor start, direct sow, and transplant dates |
| Seed start schedules | Indoor seed starting schedules calculated backward from transplant dates with light and temperature requirements |
| Transplant schedules | Outdoor transplant timing based on frost dates, soil temperature, and hardening-off completion |
| Succession schedules | Staggered planting schedules for continuous harvest throughout the growing season |
| Fall planting calendars | Reverse-calculated fall planting dates for second-season crops and overwintering varieties |
| Monthly task lists | Month-by-month gardening task lists customized to zone and garden contents |
5.2 Moon Phase Gardening#
| Capability | Description |
|---|---|
| Moon phase calculation | Accurate moon phase calculation for any date including new, waxing, full, and waning phases |
| Moon planting advice | Traditional lunar gardening guidance correlating planting activities with moon phase cycles |
| Printable calendar | Exportable printable calendar combining planting dates, moon phases, and task reminders |
6. Plant Search and Discovery#
6.1 Search Capabilities#
| Capability | Description |
|---|---|
| Fuzzy name search | Fuzzy string matching for finding plants even with misspelled or partial names |
| Faceted search | Multi-facet search with filter counts covering plant type, sun needs, water needs, hardiness zone, and family |
| Full-text search | Combined search across plant name, description, growing notes, and culinary uses |
| Nutrition-based search | Find plants by nutritional content (high vitamin C, high iron, high protein, etc.) |
6.2 Plant Recommendations#
| Capability | Description |
|---|---|
| Similar plant suggestions | Find plants similar to a selected species based on growing conditions and family |
| Beginner suggestions | Curated easy-to-grow plant recommendations for new gardeners based on zone and conditions |
| Pollinator plant suggestions | Recommendations for plants that attract bees, butterflies, and other pollinators |
| Edible landscaping | Suggestions for attractive edible plants that serve both ornamental and food production purposes |
| Problem-solver suggestions | Plants recommended for specific challenges (drought-tolerant, shade-loving, deer-resistant) |
| Harvest-time suggestions | Find plants by desired harvest window to fill gaps in seasonal food production |
7. Weather Integration#
7.1 Data and Conditions#
| Capability | Description |
|---|---|
| Multi-source data adapters | Weather data integration from multiple weather service providers with unified data format |
| Current conditions analysis | Real-time weather condition assessment with relevance to garden activities |
| Forecast integration | Multi-day weather forecasting integrated with garden planning and task scheduling |
| Historical data | Historical weather data access for trend analysis and season comparison |
7.2 Garden-Specific Weather#
| Capability | Description |
|---|---|
| Weather alerts | Configurable alerts for frost warnings, heat waves, heavy rain, hail, and wind events affecting gardens |
| Growing degree day tracking | Automatic GDD accumulation from weather data for crop maturity prediction |
| Garden weather integration | Translation of raw weather data into actionable gardening recommendations (water, cover, harvest) |
| Frost protection triggers | Automated notifications when temperatures approach frost thresholds for tender plants |
8. IoT Sensor Network#
8.1 Device Management#
| Capability | Description |
|---|---|
| Device registration | Register and manage garden sensor devices with unique identifiers and metadata |
| Device discovery | Automatic discovery of compatible sensors on the local network |
| Lifecycle management | Complete device lifecycle tracking from provisioning through decommission |
8.2 Protocol Support#
| Capability | Description |
|---|---|
| MQTT integration | Native MQTT protocol adapter for publish/subscribe sensor communication |
| Zigbee support | Zigbee mesh network protocol adapter for low-power garden sensor networks |
| BLE (Bluetooth Low Energy) | BLE protocol adapter for close-range sensor communication and phone-based reads |
| LoRa support | LoRa long-range protocol adapter for sensors deployed across large garden or farm areas |
8.3 Data Collection and Analytics#
| Capability | Description |
|---|---|
| Reading collection | Sensor data collection with validation, normalization, and unit conversion |
| Sensor types | Support for soil moisture, soil temperature, air temperature, humidity, light level, pH, and EC sensors |
| Time-series analytics | Time-series data storage with aggregation (hourly, daily, weekly) and trend analysis |
| Anomaly detection | Automatic identification of unusual sensor readings indicating equipment malfunction or extreme conditions |
| Sensor calibration | Calibration workflow management with drift correction and accuracy verification |
| Commercial integrations | Pre-built adapters for popular commercial garden monitoring systems and sensor platforms |
9. Garden Automation#
9.1 Rules Engine#
| Capability | Description |
|---|---|
| Condition-action rules | Flexible rules engine supporting complex triggers based on sensor readings, time, and weather conditions |
| Multi-condition triggers | Compound triggers combining sensor thresholds, time schedules, and weather forecasts |
| Action execution | Automated execution of actions including irrigation, ventilation, heating, and notification |
| Rule scheduling | Time-based rule activation with recurring schedules and seasonal adjustments |
9.2 Irrigation Control#
| Capability | Description |
|---|---|
| Smart scheduling | Weather-adjusted irrigation scheduling that accounts for recent rainfall and soil moisture |
| Zone control | Multi-zone irrigation management with independent schedules per garden area |
| Moisture-based activation | Sensor-driven irrigation that waters only when soil moisture drops below configured thresholds |
| Water usage tracking | Total water consumption monitoring with historical comparisons and efficiency metrics |
9.3 Climate Control#
| Capability | Description |
|---|---|
| Greenhouse management | Automated greenhouse climate control for ventilation, heating, cooling, and humidity |
| Temperature regulation | Automated heating and cooling activation based on temperature setpoints and plant requirements |
| Humidity control | Humidity monitoring and regulation through ventilation and misting system control |
| Ventilation management | Automatic vent opening and fan control based on temperature and humidity readings |
9.4 Alerts and Scenes#
| Capability | Description |
|---|---|
| Critical condition alerts | Automated notifications for frost warnings, extreme heat, dry soil, and pest detections |
| Predefined scenes | Pre-built automation scenarios (nighttime frost protection, morning watering, greenhouse ventilation) |
| Custom scenes | User-defined automation bundles that group multiple actions into single-trigger scenarios |
| Automation history | Complete audit log of all automated actions for review, debugging, and optimization |
10. Garden Planning and Design#
10.1 Layout Engine#
| Capability | Description |
|---|---|
| Canvas-based designer | Interactive garden layout canvas with element manipulation (add, remove, move, rotate, resize, copy) |
| Grid snapping | Precise element placement with configurable grid alignment for accurate garden bed positioning |
| Layer management | Multiple visual layers for separating beds, paths, structures, and water features |
| Undo/redo history | Full undo/redo capability for non-destructive garden plan editing |
| Area calculations | Automatic calculation of total garden area, individual bed area, and plantable space |
| Shape support | Multiple bed shapes, path types, structure types, and water feature elements |
10.2 Plant Placement#
| Capability | Description |
|---|---|
| Square-foot gardening | Grid-based plant placement following square-foot gardening methodology with plants-per-square calculations |
| Row planting | Traditional row planting layout with customizable row spacing and plant spacing |
| Spacing validation | Automatic validation that plant spacing meets minimum requirements for healthy growth |
| Companion compatibility | Real-time companion planting compatibility checking as plants are placed in a bed |
| Mature size overlap | Detection of plants whose mature size will overlap, causing competition for light and space |
| Vertical space planning | Planning for vertical growing with trellises, cages, and support structures |
10.3 Sun and Shadow Analysis#
| Capability | Description |
|---|---|
| Solar position calculation | Accurate sun position (altitude, azimuth) calculation for any location and date |
| Sunrise/sunset times | Precise sunrise and sunset calculations for daylength-dependent planting decisions |
| Daylength calculation | Day length computation across seasons for photoperiod-sensitive crops |
| Structure shadows | Shadow casting analysis from buildings, fences, and other structures throughout the day |
| Tree shadows | Tree shadow modeling accounting for canopy shape, height, and seasonal leaf cover |
| Light zone classification | Automatic classification of garden areas into full sun, partial sun, partial shade, and full shade zones |
| Sun heatmap generation | Visual heatmap of cumulative daily sun exposure across the entire garden layout |
| Optimal bed placement | AI-recommended bed positions that maximize sun exposure for light-demanding crops |
10.4 Garden Templates#
| Capability | Description |
|---|---|
| Template library | Pre-built garden plan templates for common garden types (vegetable, herb, flower, container, raised bed) |
| Difficulty filtering | Filter templates by gardening experience level (beginner, intermediate, advanced) |
| Zone filtering | Filter templates by USDA hardiness zone compatibility |
| Custom templates | Create and save custom garden templates for reuse or sharing |
| Template instantiation | Convert a template into a full garden plan with all elements pre-configured |
10.5 Export and Reporting#
| Capability | Description |
|---|---|
| Plant shopping lists | Auto-generated shopping lists of plants needed to implement a garden plan |
| Seed order lists | Seed quantity calculations with supplier pricing for mail-order purchasing |
| Materials lists | Complete materials list (soil, compost, lumber, hardware) for garden construction |
| Planting calendar export | Export a planting calendar derived from the specific plants in a garden plan |
| Bed labels | Printable bed labels and row markers for physical garden identification |
| Plan summaries | Overview summaries with statistics, costs, and key dates for a garden plan |
| JSON import/export | Full garden plan serialization for backup, sharing, and cross-device transfer |
11. Crop Rotation and Succession Planting#
11.1 Crop Rotation#
| Capability | Description |
|---|---|
| Plant family grouping | Plant classification by family group (nightshades, brassicas, legumes, etc.) with soil impact tracking |
| Four-year rotation plans | Automated generation of four-year crop rotation plans that cycle families through garden beds |
| Rotation validation | Validation of rotation plans against agronomic rules (no same-family back-to-back, nitrogen fixers follow heavy feeders) |
| Next crop suggestions | Smart suggestions for which crop to plant next based on what was previously grown in a bed |
| Nitrogen balance tracking | Soil nitrogen contribution and depletion tracking across rotation years |
| Cover crop planning | Cover crop recommendations for off-season soil improvement including species selection and termination timing |
| Perennial accounting | Permanent placement tracking for perennial crops that do not rotate |
| Rotation schedules | Exportable multi-year rotation schedules showing which crops go where each season |
11.2 Succession Planting#
| Capability | Description |
|---|---|
| Sowing interval calculation | Optimal sowing interval computation based on days to maturity and desired harvest window |
| Succession plan creation | Multi-sowing succession plans for continuous harvest of quick-maturing crops |
| Seed quantity calculation | Total seed quantity needed across all succession sowings including germination rate adjustments |
| Fall succession planning | Late-season succession planting optimized for shorter days and cooler temperatures |
| Harvest timelines | Visual harvest timeline showing expected production windows across all succession plantings |
| Actual vs. planned tracking | Side-by-side comparison of planned succession dates against actual sowing and harvest dates |
| Yield estimates | Per-sowing and total-season yield estimates based on crop yield databases |
| Succession crop suggestions | Recommendations for crops well-suited to succession planting with estimated yields |
12. Hydroponic Systems#
12.1 System Management#
| Capability | Description |
|---|---|
| Seven system types | Support for NFT, DWC, ebb and flow, drip, aeroponic, Kratky (passive), and wick hydroponic systems |
| System templates | Pre-configured templates for each system type with component lists and setup guides |
| Setup cost estimation | Total cost estimation for building a hydroponic system from a template including all components |
| Power consumption | Daily and monthly electricity consumption calculation based on pumps, lights, and climate control |
| System comparison | Side-by-side comparison of different hydroponic system types on cost, complexity, and suitability |
| Component management | Individual component tracking with replacement cost calculation and maintenance scheduling |
| Crop recommendations | Recommended crops for each hydroponic system type based on root structure and nutrient needs |
12.2 Nutrient Management#
| Capability | Description |
|---|---|
| EC/TDS management | Electrical conductivity and total dissolved solids monitoring with target ranges per growth stage |
| pH adjustment | pH adjustment calculations with dosage recommendations for pH up and pH down solutions |
| Nutrient lockout detection | Identification of pH-induced nutrient lockout conditions preventing uptake of specific elements |
| Deficiency diagnosis | Symptom-based nutrient deficiency identification from visual plant symptoms |
| Brand profiles | Nutrient brand database (General Hydroponics, Advanced Nutrients, etc.) with mixing ratios |
| Mixing recipe calculation | Custom mixing recipes calculated from target EC and nutrient ratio specifications |
| Purchase list generation | Nutrient product purchase lists with quantity calculations based on reservoir size and change frequency |
| Plant nutrient profiles | Per-crop nutrient profiles specifying optimal EC, pH, and macro/micronutrient ratios by growth stage |
12.3 Reservoir Management#
| Capability | Description |
|---|---|
| Water level monitoring | Reservoir water level tracking with threshold alerts for low, critical, and refill levels |
| Temperature control | Water temperature monitoring with heating and cooling recommendations for root zone health |
| pH auto-dosing | Dosing command generation for automated pH adjustment systems with safety limits |
| Evaporation rate | Evaporation rate calculation based on temperature, humidity, and reservoir surface area |
| Cleaning schedules | Automated reservoir cleaning schedules with method recommendations and reminders |
| Anomaly detection | Unusual reading detection for pH swings, EC spikes, and temperature excursions |
| Trend analysis | Long-term trend analysis for reservoir parameters to predict maintenance needs |
| Refill estimation | Days-until-refill estimation based on current level and consumption rate |
13. Aquaponics#
13.1 Fish Management#
| Capability | Description |
|---|---|
| Fish species database | Comprehensive database of aquaponic fish species with temperature preferences, growth rates, and difficulty ratings |
| Species compatibility | Temperature and behavior compatibility checking between fish species in shared systems |
| Stocking density | Maximum fish count and stocking density calculations based on tank volume and filtration capacity |
| Feeding calculations | Feeding amount and schedule calculations based on fish count, size, and water temperature |
| Growth tracking | Fish growth record keeping with weight measurements and feed conversion ratio calculation |
| Edible species filtering | Filter for food-producing fish species suitable for harvest |
13.2 System Balance#
| Capability | Description |
|---|---|
| Nitrogen cycle monitoring | Ammonia, nitrite, and nitrate level monitoring with cycling status assessment |
| Water quality assessment | Comprehensive water quality evaluation against fish and plant requirements |
| Fish-to-plant ratio | Calculation of optimal fish biomass to grow bed area ratios for nutrient balance |
| Grow bed ratio | Grow bed volume calculations relative to fish tank capacity |
| Fish disease diagnosis | Symptom-based fish disease identification with treatment recommendations |
| Balance reporting | System balance reports combining water quality, fish health, and plant growth metrics |
14. Indoor Growing and Controlled Environment#
14.1 Lighting#
| Capability | Description |
|---|---|
| Grow light database | Database of grow light options (LED, HPS, CMH) with PAR output, spectrum, and efficiency ratings |
| DLI calculation | Daily Light Integral calculation from PPFD and photoperiod for matching plant light requirements |
| PPFD at distance | Light intensity calculation at various mounting heights accounting for beam spread |
| Light cost comparison | Electricity cost comparison across different grow light technologies for the same growing area |
| Photoperiod scheduling | Automated light schedule generation for vegetative and flowering photoperiods |
14.2 Environment Control#
| Capability | Description |
|---|---|
| VPD calculation | Vapor Pressure Deficit calculation from temperature and humidity for optimal transpiration |
| VPD chart generation | Visual VPD chart generation showing optimal zones by growth phase |
| CO2 supplementation | CO2 enrichment planning with source selection, target PPM, and cost estimation |
| Grow tent sizing | Grow space sizing recommendations based on plant count, light requirements, and ventilation needs |
| Environment setpoints | Automated setpoint generation for temperature, humidity, CO2, and light by growth phase |
| Electricity cost estimation | Total electricity cost estimation for lighting, ventilation, and climate control equipment |
| Indoor growing guides | Step-by-step indoor growing guides for common crops with environment specifications |
15. Microgreens Production#
| Capability | Description |
|---|---|
| Variety database | Microgreen variety catalog with germination time, grow time, difficulty rating, and flavor profile |
| Tray lifecycle | Complete tray management from seeding through blackout, growing, and harvest stages |
| Seed density calculation | Optimal seed density calculation per tray size for even coverage and maximum yield |
| Production scheduling | Multi-tray production scheduling for continuous daily or weekly harvest |
| Cost analysis | Per-tray cost analysis including seed, media, water, and electricity inputs |
| Profitability ranking | Variety ranking by profit margin accounting for seed cost, grow time, and market value |
| Seed inventory calculation | Seed inventory planning based on production schedule and tray count |
| Production reporting | Yield and quality reporting across batches with trend analysis |
16. Mushroom Cultivation#
16.1 Species and Growing#
| Capability | Description |
|---|---|
| Species database | Mushroom species catalog covering oyster, shiitake, lion's mane, reishi, and more with growing parameters |
| Culinary species | Filter for culinary mushroom species with flavor profiles and cooking applications |
| Medicinal species | Filter for medicinal mushroom species with documented health properties |
| Difficulty ratings | Species difficulty ratings for matching grower experience level to appropriate species |
| Substrate matching | Species-to-substrate compatibility with optimal substrate recipes |
16.2 Cultivation Management#
| Capability | Description |
|---|---|
| Substrate recipes | Substrate preparation recipes with ingredient ratios, sterilization methods, and hydration targets |
| Spawn calculations | Spawn quantity calculations based on substrate weight and target inoculation rate |
| Colonization tracking | Colonization progress tracking with timeline estimation for full colonization |
| Biological efficiency | Biological efficiency calculation (fresh mushroom weight vs. dry substrate weight) |
| Flush management | Multi-flush harvest tracking with yield records per flush and total production |
| Contamination identification | Contamination type identification (trichoderma, cobweb, wet spot, etc.) with severity assessment |
| Fruiting condition validation | Verification that temperature, humidity, CO2, and light conditions meet species requirements |
| Growing guide generation | Complete growing guides generated per species with step-by-step instructions |
17. Seed and Supply Inventory#
17.1 Seed Inventory#
| Capability | Description |
|---|---|
| Seed lot tracking | Individual seed lot management with quantity, purchase date, source, and storage conditions |
| Viability tables | Species-specific seed viability data showing expected germination rates by seed age |
| Germination rate estimation | Estimated germination percentage based on seed age, species, and storage conditions |
| Expiration monitoring | Alerts for seed lots approaching or past their expected viability window |
| Needs calculation | Seed quantity requirements calculated from garden plans with germination rate adjustments |
| Shopping list generation | Automated seed shopping lists based on garden plan needs minus current inventory |
| Cost tracking | Seed expenditure tracking by season, species, and supplier |
17.2 Supplier Management#
| Capability | Description |
|---|---|
| Supplier database | Seed supplier directory with ratings, catalog listings, and order history |
| Germination tracking by supplier | Germination success rates tracked per supplier to identify reliable sources |
| Price comparison | Cross-supplier price comparison for the same varieties including shipping costs |
| Order history | Complete order history with arrival tracking and satisfaction records |
| Wishlist-to-order | Wishlist management with one-click conversion to supplier orders |
17.3 Seed Saving#
| Capability | Description |
|---|---|
| Saving guides | Species-specific seed saving guides with difficulty ratings and processing methods |
| Isolation distance | Minimum isolation distance calculations to prevent unwanted cross-pollination |
| Population requirements | Minimum plant population sizes needed to maintain genetic diversity when saving seed |
| Saving calendars | Seed saving calendars showing optimal harvest timing for seed collection |
| Lineage tracking | Seed lineage records tracking parent plants across generations |
| Success rate tracking | Seed saving success rates with germination testing records |
| Yield estimation | Expected seed yield estimates per plant by species |
17.4 Plant and Supply Inventory#
| Capability | Description |
|---|---|
| Live plant tracking | Inventory of live plants with status tracking (seedling, hardening, transplanted, established) |
| Hardening-off schedules | Day-by-day hardening-off progression schedules with increasing outdoor exposure |
| Propagation records | Propagation tracking (cuttings, divisions, layering) with success rate calculation |
| Supply management | Consumable supply tracking (soil, fertilizer, mulch) with quantity monitoring and reorder alerts |
| Tool inventory | Durable tool management with maintenance scheduling, lending/return tracking, and condition assessment |
| Usage rate analysis | Supply consumption rate analysis with estimated resupply dates |
18. Garden Journaling#
18.1 Observations and Records#
| Capability | Description |
|---|---|
| Daily observations | Structured observation entries with weather conditions, plant status, and activity notes |
| Photo management | Photo attachments with tagging, before/after comparisons, and gallery organization |
| Growth tracking | Plant growth measurement tracking with height, spread, flowering, and fruiting records |
| Harvest logging | Harvest record keeping with weight, quality, and per-plant yield tracking |
18.2 Search and Insights#
| Capability | Description |
|---|---|
| Entry search | Full-text search across journal entries with date range and tag filtering |
| AI-powered insights | Machine learning analysis of journal data to identify patterns, predict issues, and suggest improvements |
| Seasonal summaries | Automated seasonal summary generation from accumulated journal observations |
19. Post-Harvest Preservation#
19.1 Harvest Planning#
| Capability | Description |
|---|---|
| Yield forecasting | Harvest yield prediction using crop yield databases and growing condition factors |
| Peak harvest prediction | Prediction of peak harvest windows for planning preservation sessions |
| Preservation needs assessment | Assessment of preservation capacity needed based on expected harvest volumes |
| Session scheduling | Preservation session planning with time estimates and priority ordering |
| Container needs | Container quantity calculations (jars, bags, trays) for planned preservation volumes |
| Prep checklists | Auto-generated preparation checklists for each preservation session |
| Surplus planning | Surplus management plans for excess harvest (donations, sales, composting) |
| Harvest calendar | Combined harvest and preservation calendar with all planned activities |
19.2 Canning#
| Capability | Description |
|---|---|
| Water bath canning | Water bath canning support for high-acid foods with complete processing guides |
| Pressure canning | Pressure canning support for low-acid foods with dial and weighted gauge instructions |
| Altitude adjustments | Automatic altitude-adjusted processing times and pressures per USDA guidelines |
| Recipe scaling | Canning recipe scaling with proportional ingredient adjustment for different batch sizes |
| Acid addition calculation | Acid (lemon juice, citric acid) addition calculations to ensure safe acidity levels |
| Batch management | Batch tracking from preparation through processing with seal checking records |
| Jar inventory | Jar inventory management by size and mouth type with usage and availability tracking |
| Lid reorder alerts | Lid and band inventory monitoring with reorder notifications |
| Safety checks | Pre-canning safety verification ensuring recipe, equipment, and procedure compliance |
| Label generation | Printable label generation with contents, date, batch number, and processing details |
| Botulism risk assessment | Risk assessment for botulism based on pH, acidity, processing method, and altitude |
| USDA/NCHFP compliance | All recipes and processing times validated against USDA and NCHFP food safety guidelines |
19.3 Freezing#
| Capability | Description |
|---|---|
| Blanching guides | Produce-specific blanching instructions with timing, method (water, steam), and cooling steps |
| Packing methods | Packing method selection (tray pack, dry pack, syrup pack, sugar pack) per produce type |
| Freezer item management | Frozen item inventory with location, date, quantity, and expected quality duration |
| FIFO prioritization | First In, First Out inventory management that prioritizes oldest items for use |
| Expiration alerting | Configurable alerts for frozen items approaching quality expiration dates |
| Freezer unit management | Multi-freezer tracking with zone mapping for organized storage |
| Energy cost estimation | Freezer electricity cost estimation based on unit type, capacity, and usage patterns |
19.4 Dehydrating#
| Capability | Description |
|---|---|
| Temperature guides | Dehydrating temperature and time guides for produce, herbs, and specialty items |
| Reconstitution ratios | Dried-to-fresh reconstitution ratios for cooking with dehydrated ingredients |
| Dried weight calculation | Expected dried weight calculation from fresh weight based on moisture content |
| Tray rotation management | Multi-tray dehydrator rotation schedules for even drying |
| Drying logs | Detailed drying logs with temperature, time, and quality observations |
| Shelf life estimation | Expected shelf life estimates based on drying completeness and storage conditions |
| Fruit leather recipes | Fruit leather recipe database with blending ratios and drying instructions |
| Jerky recipes | Jerky recipe database organized by meat type with marinade and drying parameters |
19.5 Fermentation#
| Capability | Description |
|---|---|
| Recipe database | Fermentation recipe collection covering lacto-fermentation, kombucha, and other styles |
| Batch tracking | Fermentation batch management with day-by-day progress tracking |
| Tasting notes | Tasting note recording with flavor descriptors for tracking fermentation development |
| Temperature monitoring | Temperature recording with alerts when batches drift outside safe fermentation ranges |
| pH tracking | pH measurement logging with safety assessment against food safety thresholds |
| Milestone tracking | Pre-defined milestones for lacto-fermentation and kombucha processes |
| Salt-for-brine calculation | Precise salt concentration calculations for brine preparation by weight percentage |
| Taste reminders | Scheduled taste reminder notifications for active fermentation batches |
| Safety assessment | Ferment safety evaluation based on pH readings, visual inspection, and process adherence |
19.6 Root Cellar and Produce Storage#
| Capability | Description |
|---|---|
| Storage location management | Named storage locations with temperature and humidity condition monitoring |
| Condition compliance | Compliance checking of actual storage conditions against produce-specific requirements |
| Spoilage inspection | Spoilage indicator tracking with inspection scheduling for early detection |
| Rotation scheduling | Storage rotation schedules ensuring older produce is used before newer stock |
| Storage loss tracking | Spoilage and waste tracking with loss percentage calculations per crop |
| Compatibility checking | Storage compatibility verification to prevent ethylene-producing items from damaging neighbors |
| Location recommendations | Optimal storage location suggestions based on produce type and available locations |
19.7 Preservation Recipes#
| Capability | Description |
|---|---|
| Preservation recipe database | Recipe collection for preserved food applications (jams, pickles, sauces, soups, etc.) |
| Harvest-to-recipe matching | Automatic recipe suggestions based on what is currently being harvested |
| Batch calculation | Recipe scaling for batch production with ingredient quantity adjustments |
| Shopping list generation | Ingredient shopping lists for planned preservation recipes |
| Recipe import from text | Natural text parsing to extract structured recipes from unformatted sources |
| Success rate tracking | Recipe attempt tracking with success rate calculations and notes |
| Seasonal recipes | Season-appropriate recipe suggestions based on what is available to preserve |
20. Task and Schedule Management#
| Capability | Description |
|---|---|
| Task scheduling | Garden task creation with due dates, recurrence patterns, and priority levels |
| Automated task generation | Automatic task creation from garden plans based on planting dates, care needs, and harvest windows |
| Smart prioritization | Dynamic task prioritization considering weather forecasts, plant conditions, and seasonal urgency |
| iCal calendar integration | Export garden tasks to standard iCal format for integration with calendar applications |
| Notifications | Configurable task reminder notifications via multiple channels |
| Task analytics | Task completion analytics showing on-time rates, time spent, and seasonal workload patterns |
21. Community Gardening Platform#
21.1 Gardener Profiles#
| Capability | Description |
|---|---|
| Rich profiles | Gardener profiles with experience level, gardening interests, growing zone, and social links |
| Privacy controls | Granular privacy settings controlling profile visibility, location precision, and activity sharing |
| Badge and achievement system | Tiered badge system (bronze, silver, gold, platinum) with criteria-based automatic awarding |
| Garden statistics | Aggregated gardening statistics (plants grown, harvests, gardens, seasons active) |
| Follow/block/mute | Social relationship management with follow, block, and mute capabilities |
| Activity feeds | Personalized activity feeds showing followed gardeners' posts, harvests, and achievements |
| Milestone tracking | Gardening milestone recognition for significant accomplishments |
| Location-based search | Find nearby gardeners using haversine distance calculation with configurable radius |
| Connection suggestions | Friend suggestions based on proximity, shared interests, and growing zone |
21.2 Seed and Plant Exchange#
| Capability | Description |
|---|---|
| Exchange marketplace | Marketplace for seed swaps, plant divisions, and produce sharing with listing management |
| Listing types | Seed swap, plant division, and produce share listing types with type-specific detail fields |
| Location-based search | Distance-based listing search to find exchanges within a reasonable geographic area |
| Messaging | Private messaging threads between exchange participants for coordination |
| Reputation scoring | Reputation scores calculated from exchange ratings and successful transaction history |
| Wishlist matching | Wishlist management with automatic notifications when matching listings appear |
| Exchange statistics | Community exchange volume analytics with seasonal trend reporting |
21.3 Groups and Community Gardens#
| Capability | Description |
|---|---|
| Group management | Community garden group creation with membership workflows, roles, and privacy settings |
| Discussion posts | Threaded discussion posts with replies, likes, pinning, and category organization |
| Events with RSVP | Group event creation with RSVP tracking, attendee limits, and upcoming event listings |
| Shared resources | Community tool and resource library with checkout/return tracking and availability status |
| Garden plot assignment | Community garden plot management with assignment, status tracking, and waitlist queuing |
| Polls | Group polls with multiple poll types and result tabulation |
| Photo albums | Shared photo albums with per-photo commenting and liking |
| Announcements | Group announcements with read tracking and unread count notifications |
21.4 Expert Network#
| Capability | Description |
|---|---|
| Expert profiles | Verified expert profiles with certifications, specialties, and verification status |
| Q&A platform | Question and answer system with voting, answer acceptance, and tag-based search |
| Consultation booking | Expert consultation scheduling with time slot management and booking workflows |
| Workshops | Workshop event creation with registration, capacity limits, and instructor attribution |
| Article publishing | Expert article publishing with draft, review, publish, and archive lifecycle |
| Expert ratings | Expert rating system with aggregate scores and individual review access |
| Question-to-expert matching | Automatic matching of unanswered questions to experts based on specialty tags |
21.5 Content Sharing#
| Capability | Description |
|---|---|
| Before/after posts | Before and after photo comparison posts for showcasing garden transformations |
| Growth timelines | Chronological growth timeline posts documenting plant development over time |
| Garden plan sharing | Garden plan sharing with the ability for others to fork and adapt plans |
| Garden tours | Virtual garden tour creation with multiple stops and descriptive narration |
| Tips with ratings | Community tip sharing with quality ratings and category organization |
| Challenges | Community gardening challenges with entry submission, voting, and result tracking |
| Content moderation | Reporting, review, and appeals process for community content moderation |
| Trending content | Trending content feeds based on engagement scoring algorithms |
21.6 Local Resources#
| Capability | Description |
|---|---|
| Business directory | Searchable directory of nurseries, farmers markets, and extension offices |
| Reviews and ratings | Business review system with helpful voting and owner response capability |
| Inventory listings | Business inventory listings with availability status and search |
| Promotions | Business promotion and sale listings with featured promotion support |
| Business claiming | Business owner verification and claiming workflow |
| Event listings | Local gardening event listings from businesses and organizations |
22. Agricultural Analytics#
| Capability | Description |
|---|---|
| Yield analytics | Harvest yield tracking and analysis per crop, bed, and season with trend visualization |
| Cost analysis | Garden cost tracking covering seeds, supplies, water, and labor with ROI calculations |
| Resource optimization | Water, fertilizer, and labor resource usage analysis with efficiency recommendations |
| Environmental impact | Environmental impact assessment including carbon offset, water conservation, and biodiversity metrics |
| Time management | Time spent analysis by garden area and activity type with seasonal workload projections |
| Success metrics | Garden success scoring based on yield, plant health, completion rates, and cost efficiency |
| Dashboard reporting | Aggregated analytics dashboards combining key metrics from all other analytics modules |
23. AI-Powered Agricultural Intelligence#
| Capability | Description |
|---|---|
| Plant identification | Image-based plant species identification from photographs using machine learning |
| Disease detection | Visual disease detection and diagnosis from plant symptom photographs |
| Pest identification | Image and symptom-based pest identification with confidence scoring |
| Growth prediction | ML-based growth stage and harvest date prediction from sensor data and weather patterns |
| Personalized recommendations | Personalized planting, care, and harvesting recommendations based on garden history and conditions |
| Anomaly detection | Anomaly detection in sensor data streams to identify equipment issues or unusual environmental conditions |
| Natural language interface | Conversational natural language interface for garden queries and advice |
| Model management | ML model versioning, deployment, and performance tracking for all intelligence features |
24. Data Foundation#
24.1 Schema and Validation#
| Capability | Description |
|---|---|
| 30 Zod schemas | Comprehensive validation schema library covering plants, gardens, beds, plantings, soil tests, weather, pests, sensors, and more |
| Type inference | TypeScript type inference from Zod schemas for compile-time type safety without duplication |
| Plant type classification | Enumerated plant types: vegetable, fruit, herb, flower, tree, shrub, vine, grass, succulent, fern |
| Plant lifecycle classification | Annual, biennial, and perennial lifecycle categorization |
24.2 Database and Persistence#
| Capability | Description |
|---|---|
| Drizzle ORM schema | Full relational database schema defined in Drizzle ORM covering all domain entities |
| Seed data | Initial seed data for bootstrapping the platform with essential reference information |
| Migration support | Database migration support through Drizzle ORM's migration tooling |
Library Summary#
| Library | Package | Capability Area |
|---|---|---|
| Core | @demeter/core |
Schemas, database, types, seed data |
| Plants | @demeter/plants |
Encyclopedia, companion planting, pests, climate zones, calendars, search |
| Weather | @demeter/weather |
Data sources, conditions, forecasts, alerts, GDD tracking |
| Sensors | @demeter/sensors |
IoT devices, MQTT/Zigbee/BLE/LoRa protocols, time-series analytics |
| Automation | @demeter/automation |
Rules engine, irrigation, climate control, alerts, scenes |
| Planner | @demeter/planner |
Layout design, plant placement, sun analysis, rotation, succession, templates |
| Hydroponics | @demeter/hydroponics |
Hydroponic systems, nutrients, reservoirs, aquaponics, indoor growing, microgreens, mushrooms |
| Inventory | @demeter/inventory |
Seed lots, suppliers, seed saving, plant inventory, tools and supplies |
| Journal | @demeter/journal |
Observations, photos, growth tracking, harvest logs, insights |
| Preservation | @demeter/preservation |
Canning, freezing, dehydrating, fermentation, storage, preservation recipes |
| Tasks | @demeter/tasks |
Scheduling, auto-generation, prioritization, iCal, notifications |
| Community | @demeter/community |
Profiles, exchanges, groups, experts, content sharing, local resources |
| Analytics | @demeter/analytics |
Yield, cost, resource, environmental, time, success metrics, dashboards |
| Intelligence | @demeter/intelligence |
Plant ID, disease detection, pest ID, predictions, NLP, anomaly detection |