Johgee Open Irrigation

Open-Source, KI-native Bewässerungsempfehlung für britische Hausgärten.

v1 verwandelt das, was Sie bereits wissen – Gartentyp, Boden, Sonne, Bewässerungsweise, letzter Regen und wie sich der Boden anfühlt – in einen erklärbaren Plan: Millimeteter, Liter und Laufwert. Es steuert keine Wasserhähne, Zeitschaltuhren oder Bewässerungshardware. Es bestätigt kein Gartensprengverbot für Ihre Straße.

Zahlen Empfehlungen stammen aus einem versionierten deterministischen Kern. Ein Sprachmodell darf diese Fakten erläutern. Es darf Millimeter, Liter, Laufzeit, Einschränkungsstatus, Varianten-IDs oder Quellen nicht verändern.

Status

Der öffentliche Datenmodus ist nach D-01 (2026-08-23) dynamisch: Eine Postleitzahl darf den Met Office DataHub kostenlosen Global-Spot-Feed verwenden, wenn im Großen Raster von caches. Wenn das Wetter nicht abgerufen werden kann, fällt die API auf einen manual-Selbstbericht zurück und erfinden niemals Millimeter. Der Einschränkungsstatus bleibt unknown. Hinweise zu Gartenschläuchen und Sprinklern bis V- fail-closed v3 bleiben. fixture ist nur für tests.

Related MCP server: UK Weather & Travel Outfit Recommender MCP Server

Was sie heute tun können

• POST /v1/recommendations mit einem manual_context nennen (keine PLZ erforderlich).

• optional eine britische Postleitzahl senden; Wetter wird nur on-demand der Freiestufe " free-tier" nutzen.

• Die gleiche Berechnung über die MCP-Tools calculate_watering durchführen (manuell, ohne Netzwerk) und get_watering_advice (optionale PLZ, Wetter, wenn der Server einen Free-Tier-Schlüssel hat).

• B Mount Theme-Abschnitt auf einer Shopify-Seite oder die lokale Demo-Seite öffnen.

• Die ersten britischen Knowledge-Seiten lesen (HTML, JSON und JSON-LD).

Anforderungen

• Node.js 22.23.2

• pnpm 11.5.2 über Corepack

Die exakte Laufzeitumgebung ist in .node-version und package.json vermerkt.

Schnellstart

corepack enable
pnpm install --frozen-lockfile
pnpm check
pnpm dev:api

Die API Lauscht auf http://localhost:8787. Ausprobieren:

curl -sS http://localhost:8787/v1/recommendations \
  -H 'Content-Type: application/json' \
  -d '{
    "garden_type": "borders",
    "area_m2": 12,
    "soil_class": "loamy",
    "establishment": "established",
    "irrigation_method": "watering_can",
    "manual_context": { "recent_rainfall": "light", "soil_feel": "moist" }
  }'

Der Antwort-Header muss X-Johgee-Data-Mode: manual lauten. Ein fixture-Header ist ausschließlich für Testzwecke.

Lokale Planungsseite: apps/public-web/watering-plan.html (zeigt auf die lokale API).

MCP

Den Stdio-Server bauen und dann Cursor oder Claude Desktop darauf ausrichten. Kein API-Schlüssel nötig.

pnpm --filter @johgee/contracts build
pnpm --filter @johgee/irrigation-core build
pnpm --filter @johgee/ai-tools build

{
  "mcpServers": {
    "johgee": {
      "command": "node",
      "args": ["packages/ai-tools/dist/stdio.js"]
    }
  }
}

Tools: calculate_watering (manuelle Selbstauskunft) und get_watering_advice (britische Postleitzahl; Wetter bei Bedarf, sonst dieselbe Selbstauskunft). Ungültige Eingaben liefern ein strukturiertes Problem; die Tools raten keine Zahlen.

Skill draft datei: packages/ai-tools/SKILL.md.

Eine unbeteiligte Person sollte das MCP-Tool in ungefähr fünf Minuten aus einem frischen Klon starten können: installieren, die drei obigen Pakète, Stdio-Server starten.

Architektur

Shopify page / MCP client
        │
        ▼
  Public API (Hono)  ──  MCP stdio (@johgee/ai-tools)
        │                         │
        └────────────┬────────────┘
                     ▼
           irrigation-core
           (pure functions)

• Storefront: Theme-Abschnitt + Shopify-Seite (extensions/watering-planner).

• Öffentliche API: https://api.johjeeirrig.co.uk/v1 (CORS: Johgee Storefront).

• Kern: @johgee/irrigation-core – kein Netz, keine Datenbank, kein Modell.

• Anonyme Teilnahme-Seiten links laufen nach 30 Tagen ab. Tokens sind als Hashes gespeichert.

• Wissen: apps/public-web/knowledge, llms.txt, sitemap, robots.

• Exakte UK-Postleitzahlen dürfen nie in Datenbanken, Logs, Traces, Local Storage oder Git.

Repository-Karte

apps/                     Local public-web demo
extensions/               Shopify Theme section
services/                 API
packages/                 Core, contracts, planner-ui, ai-tools, content
api/                      OpenAPI 3.1
schemas/                  JSON Schema
docs/                     Product, architecture, ADRs

Mitwirken

Siehe CONTRIBUTING.md. Ebenso SECURITY.md und GOVERNANCE.md.

Lizenz

Der von Johgee stammende Code ist unter MIT lizenziert. Informationen und Inhalt von Dritten unterliegt stillen eigenen Bedingungen und müssen vor Weitergabe oder Verbreitung registriert werden.

Öffentlicher Quelle: github.com/hongzhizuo/johgee-open-irrigation.