Вернуться к курсуСкачать Markdown

Пошаговое руководство по курсу

Аудитория: разработчики и операторы, подключающие датчики физического мира к GAIA / ATLAS до выставления платных Hub SKU.
Языки: COURSE_LANG=en|ru|es|fr|zh · строки UI в i18n/ · это руководство на русском. English · Español · Français · 中文

Сверка с текущей экосистемой

Сначала выполните воспроизводимую лабораторную, затем сравните её проверку источника и свежести с руководством ATLAS. В текущем коде gaia.groundwater.read@v1 покрывает три пилотные скважины USGS: глубина измеряется в метрах ниже местной поверхности, положительное направление вниз, показания старше 24 часов отбрасываются. USGS Real-Time Flood Impacts сопоставляет пороги объектов со свежими показаниями постов. Пустая выдача относится к покрываемым объектам и подходящим наблюдениям. В экспорте сохраняйте источник, время и покрытие.

Зачем этот курс

GAIA отдаёт аттестованные IoT-показания как capability (gaia.weather.read@v1, gaia.fleet.status@v1, …). ATLAS превращает тот же флот в операторскую карту (atlas.nearest.read@v1). Сложность не в HTTP, а в честности (Open-Meteo ≠ полевая станция; SIM ≠ LIVE) и лицензии (на коммерческой рельсе только CC0 / CC BY / OGL / NLOD / U.S. PD / Copernicus CC BY). Курс учит обоим через лаборатории на живой песочнице:

Сервис URL
GAIA https://iot.modelmarket.dev
ATLAS https://atlas.modelmarket.dev

Лаборатории вызывают live API при доступности; офлайн печатают [offline] и никогда не выдумывают показания.

Канон: LIVE-RELAYS.md · add-gaia-atlas-sensor.md

Содержание

  1. Выбор трека
  2. Установка (10 минут)
  3. Модуль M1 — Что такое LIVE-реле
  4. Модуль M2 — Лицензия и коммерческая рельса
  5. Модуль M3 — Флот и честность пинов
  6. Модуль M4 — Операторская карта ATLAS
  7. Модуль M5 — Капстоун: добавить датчик
  8. Упражнения и сертификат
  9. Чеклист самопроверки
  10. Устранение неполадок

Выбор трека

Трек Модули Время Сеть
Базовый M1 → M2 → M3 → M4 ~2 ч Опционально
Продвинутый Базовый + M5 +30 мин Опциональный live-счётчик флота
Ops-мост После M5 +30 мин Live GAIA + ATLAS + Recipe A в монорепо

Установка (10 минут)

Шаг 1 — Клон и установка

git clone https://github.com/alexar76/aimarket-courses.git
cd aimarket-courses/gaia-atlas-sensors-course
pip install -e ".[dev]"

Из монорепозитория aicom:

cd courses/gaia-atlas-sensors-course
pip install -e ".[dev]"

Шаг 2 — Проверка тестов

pytest -q

Ожидание: паритет i18n (5 языков), unit-тесты licence/honesty, solutions упражнений, smoke импортов. Сетевые тесты пропускаются, если GAIA недоступен или COURSE_SKIP_NETWORK=1.

Шаг 3 — Язык (опционально)

export COURSE_LANG=ru
python labs/lab01_live_vs_sim.py

Шаг 4 — Live-эндпоинты

export COURSE_GAIA_URL=https://iot.modelmarket.dev
export COURSE_ATLAS_URL=https://atlas.modelmarket.dev
export COURSE_HUB_URL=https://modelmarket.dev

Платные чтения GAIA (gaia.weather.read@v1, $0.001) идут через бесплатный sandbox-триал хаба COURSE_HUB_URL: 5 вызовов в час на visitor id, без кошелька и аккаунта. С включённым price gate GAIA отвечает на прямой вызов платной capability кодом 402 и называет хаб; gaia.fleet.status@v1 бесплатен и читается из GAIA напрямую.

Модуль M1 — Что такое LIVE-реле

Концепт: HTTPS-allowlist, offline при сбое, не выдумывать показания.
Лаборатория: labs/lab01_live_vs_sim.py · Время: ~20 мин

Шаги

  1. Прочитайте docstring — пара om-wx-01 (LIVE) vs ws-01 (SIM).
  2. Запустите python labs/lab01_live_vs_sim.py.
  3. Убедитесь, что офлайн-assert classify_mode проходит без сети.
  4. Онлайн: смотрите /health и weather invoke для обоих устройств.
  5. Просмотрите courselib/sensors.py.

Самопроверка

Модуль M2 — Лицензия и коммерческая рельса

Концепт: только CC0 / CC BY / OGL / PD.
Лаборатория: labs/lab02_licence_gate.py · Время: ~20 мин

Шаги

  1. Запустите лабораторию и разберите таблицу pass/fail.
  2. Pass: OpenAQ, USGS/NWS PD, Safecast CC0, FIRMS, UK OGL.
  3. Fail: AirNow (нужен assent), OpenSky, ADSBx, PurpleAir, BY-NC.

Самопроверка

Модуль M3 — Флот и честность пинов

Концепт: Open-Meteo ≠ станция; публичный AIS ≠ свой edge.
Лаборатория: labs/lab03_honesty_claims.py · Время: ~20 мин

Самопроверка

Модуль M4 — Операторская карта ATLAS

Концепт: nearest, distance, mode/source.
Лаборатория: labs/lab04_atlas_map_read.py · Время: ~20 мин

Шаги

  1. Офлайн-assert формы payload.
  2. Онлайн: atlas.nearest.read@v1 около Берлина (52.52, 13.41).
  3. Смотрите stations в /health.

Модуль M5 — Капстоун: добавить датчик

Концепт: Recipe A — licence → kind → YAML → redeploy GAIA→ATLAS → honesty.
Лаборатория: labs/lab05_add_sensor_capstone.py · Время: ~25 мин

Самопроверка

Упражнения и сертификат

Заготовки: courselib/exercises.py (# YOUR CODE HERE).
Эталон: courselib/exercise_solutions.py.

python labs/run_exercises.py
python labs/run_exercises.py --certificate "Иван Петров" --lang ru

Галочки в браузере сертификат не выдают.

Чеклист самопроверки

Устранение неполадок

Симптом Что делать
[offline] … unreachable Сеть или продолжайте офлайн — unit-часть всё равно учит
SensorsError: HTTP … Проверьте capability_id и device_id
HTTP 429 … trial_quota_exhausted Бесплатный триал хаба (5 вызовов в час) исчерпан; он обновится в следующий час, ничего не списано
Сетевые pytest skip Норма офлайн; уберите COURSE_SKIP_NETWORK для live
Все exercises fail Заполните stubs — так и задумано
Неверный язык COURSE_LANG ∈ en,ru,es,fr,zh

Переменные: COURSE_GAIA_URL, COURSE_ATLAS_URL, COURSE_HUB_URL, COURSE_SANDBOX_VISITOR, COURSE_LANG, COURSE_SKIP_NETWORK=1.