Johgee Open Irrigation

Открытый исходный код, AI-native советы по поливу для домашних садов Великобритании.

v1 превращает то, что вы уже знаете, — тип сада, почву, солнце, как вы поливаете, недавние дожди и состояние почвы — в понятный план: миллиметры, литры и время работы. Он не управляет кранами, таймерами или оборудованием для полива. Он не подтверждает запрет на использование шланга на вашей улице.

Числовые рекомендации берутся из версионированного детерминированного ядра. Языковая модель может объяснять эти факты. Она не должна изменять миллиметры, литры, время работы, статус ограничения, идентификаторы вариантов и нормы.

Статус

Режим публичных данных становится динамическим после D-01 (2026-08-23): почтовый индекс может использовать бесплатный канал Global Spot из Met Office DataHub, кэшированный по грубой сетке. Если погоду не удалось получить, API переключается в самостоятельный ввод manual и никогда не выдумывает миллиметры. Статус ограничений остаётся unknown; рекомендации по шлангам и спринклерам отключены до v3 (fail-closed). fixture предназначен только для тестов.

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

Что можно сделать сегодня

• Вызвать POST /v1/recommendations с полем manual_context (почтовый индекс не требуется).

• При желании отправить почтовые индексы Англии; погода запрашивается по требованию и только по бесплатному тарифу.

• Выполнить тот же расчёт через инструментальные средства MCP calculate_groundwater (ручной ввод, без сети) и get_watering_advice (необязательный почтововый индекс; погода — если на сервере есть бесплатный ключ).

• Подключить раздел Theme на странице Shopify или открыть локальную демонстрационную страницу.

• Прочитать первые страницы базы знаний (HTML, JSON и JSON-LD).

Требования

• Node.js 22.23.2

• pnpm 11.5.2 через Corepack

Точная версия среды выполнения записана в .node-version и package.json.

Быстрый старт

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

API прослушивает http://localhost:8787. Попробуйте:

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" }
  }'

Заголовок ответа должен быть X-Johgee-Data-Mode: manual. Заголовок foo только для тестов.

Локальная страница планировщика: apps/public-web/watering-plan.html (указан localhost API).

MCP

Соберите stdio-сервер и затем укажите на него Cursor или Claude Desktop. КлючAPI не нужен.

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"]
    }
  }
}

Инструменты: calculate_watering (ручной ввод данных) и get_watering_advice (почтовый индекс; погода по требованию, в противном случае — тот же ручной ввод). Некорректные данные вернут структурированную проблему; инструменты не угадывают числа. Черновик навыка: packages/ai-tools/SKILL.md.

Сторонниками должны быть в состоянии запустить MCP-инструмент approximately за десять minutes from clean clone: install, build the three packages above, run the stdio server.

Архитектура

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

• Витрина: страница Shopify + раздел Theme (extensions/watering-planner).

• Публичный API: https://api.johgeeirrig.co.uk/v1 (CORS: Johgee storefront).

• Ядро: @johgee/irrigation-core — без сети, базы данных и модели.

• Анонимные ссылки для sharing истекают через 30 дней. Токены хранятся в виде хэшей (hash).

• База знаний: apps/public-web/knowledge, llms.txt, sitemap, robots.

Точные почтовые индексы Великобритании не должны попадать в базы данных, журналы, трассы, локальные хранилища и Git.

Карта репозитория

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

Участие

См: CONTRIBUTING.md, SECURITY.md и GOVERNANCE.md.

Лицензия

Код, принадлежащий Johgee, распространяется по лицензии MIT. Данные и содержим третьих сторон сохраняют свои условия и должны быть зарегистрированы перед использованием или распространением.

Общедоступный исходный код: github.com/hongzhizuo/johgee-open-irrigation.#1Johgee Open Irrigation

Советы по поливу для домашних садов Великобритании с открытым исходным кодом и AI-native подходом.

v1 превращает то, что вы уже знаете — тип сада, почву, солнце, то, как вы поливаете, недавние дожди и состояние почвы — в понятный план: миллиметры, литры и время работы. Он не управляет кранами, таймерами или оборудованием для полива. Он не подтверждает запрет на использование садового шланга на вашей улице.

Числовые рекомендации происходят из детерминированного ядра с версионированием. Языковая модель может объяснять эти факты. Она не должна изменять миллиметры, литры, время работы, статус ограничений, идентификаторы вариантов или источники.

Статус

Режим публичных данных становится динамическим после D-01 (2026-08-23): почтовый индекс может использовать бесплатный канал Global Spot из Met Office DataHub, кэшируемый по грубой сетке. Если погоду получить не удалось, API переключается на самостоятельный ввод manual и никогда не выдумывает миллиметры. Статус ограничений остаётся unknown; рекомендации по шлангам и разбрызгивателям заблокированы (fail-closed) до v3. fixture — только для тестов.

Что вы можете сделать сегодня

• Вызовите POST /v1/recommendations с полем manual_context (почтовый индекс не требуется).

• При желании отправьте почтовый индекс Великобритании; погода получается по требованию и только на бесплатном тарифу.

• Выполните тот же расчёт через MCP-инструменты calculate_watering (ручной режим, без сети) и get_watering_advice (необязательный почтовый индекс; погода — если на сервере есть бесплатный ключ).

• Подключите блок Theme на страницу Shopify или откройте локальную демонстрационную страницу.

• Прочитайте первые страницы базы знаний Великобритании (HTML, JSON и JSON-LD).

Требования

• Node.js 22.23.2

• pnpm 11.5.2 through Corepack

Точная среда выполнения записана в .node-version и package.json.

Быстрый старт

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

API прослушивает адрес http://localhost:8787. Попробуйте:

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" }
  }'

В заголовке ответа должно быть X-Johgee-Data-Mode: manual. Заголовок fixtureТестовый.

Локальная страница планировщика: apps/public-web/watering-plan.html (указывает на локальный API).

MCP

Соберите stdio-сервер, затем укажите его в Cursor или Claude Desktop. Ключ API не нужен.

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"]
    }
  }
}

Инструменты: calculate_watering (ручной ввод данных) и get_watering_advice (почтовый индекс Великобритании; погода по требованию, в противном случае — тот же ручной ввод). Некорректный ввод возвращает структурированную проблему; инструменты не угадывают числа. Черновик навыка: skills/ai-tools/SKILL.md.

Любой человек должен суметь запустить MCP-инструмент примерно за десять минут из чистого клона: установить, собрать три перечисленных пакета, запустить stdio-сервер.

Архитектура

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

• Витрина: страница Shopify и блок Theme (extensions/watering-planner).

• Публичный API: https://api.johjeeirrig.co.uk/v1 (CORS: витрина Johgee).

• Ядро: @johgee/irrigation-core — без сети, баз данных и моделей.

• Анонимные ссылка для предоставления доступа истекают через 30 дней. Токены хранятся как хэши.

• База знаний: apps/public-web/knowledge, llms.txt, sitemap, robots.

Точные почтовые индексы Великобритании не должны попадать в базы данных, журналы, трассы, локальные хранилища и Git.

Карта репозитория

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

Участие в проекте

См. CONTRIBUTING.md, SECURITY.md и GOVERNANCE.md.

Лицензия

Код, принадлежащий Johgee, доступен по лицензии MIT. Данные и материалы третьих сторон сохраняют собственные условия и подлежат регистрации перед использованием или распространением.

Репозиторий: github.com/hongzhizhuo/johgee-open-irrigation.