# Demeter Domain -- Features and Capabilities

> **Canonical source:** the canonical features document for this domain is
> [`deep-dive/features.md`](./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

1. [Plant Encyclopedia and Knowledge Base](#1-plant-encyclopedia-and-knowledge-base)
2. [Companion Planting Intelligence](#2-companion-planting-intelligence)
3. [Pest and Disease Management](#3-pest-and-disease-management)
4. [Climate Zone System](#4-climate-zone-system)
5. [Seasonal Calendar and Planning](#5-seasonal-calendar-and-planning)
6. [Plant Search and Discovery](#6-plant-search-and-discovery)
7. [Weather Integration](#7-weather-integration)
8. [IoT Sensor Network](#8-iot-sensor-network)
9. [Garden Automation](#9-garden-automation)
10. [Garden Planning and Design](#10-garden-planning-and-design)
11. [Crop Rotation and Succession Planting](#11-crop-rotation-and-succession-planting)
12. [Hydroponic Systems](#12-hydroponic-systems)
13. [Aquaponics](#13-aquaponics)
14. [Indoor Growing and Controlled Environment](#14-indoor-growing-and-controlled-environment)
15. [Microgreens Production](#15-microgreens-production)
16. [Mushroom Cultivation](#16-mushroom-cultivation)
17. [Seed and Supply Inventory](#17-seed-and-supply-inventory)
18. [Garden Journaling](#18-garden-journaling)
19. [Post-Harvest Preservation](#19-post-harvest-preservation)
20. [Task and Schedule Management](#20-task-and-schedule-management)
21. [Community Gardening Platform](#21-community-gardening-platform)
22. [Agricultural Analytics](#22-agricultural-analytics)
23. [AI-Powered Agricultural Intelligence](#23-ai-powered-agricultural-intelligence)
24. [Data Foundation](#24-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                     |
