IoT MVP: архитектура, план реализации, лог рассуждений

- Определена архитектура managed IoT service
- Согласовано решение: RabbitMQ (MVP), потом Kafka; EMQX + CRD контроллер
- Создан подробный план для Sonnet (doc/iot-mvp-plan.md)
- Добавлено правило в copilot-instructions: лог мышления в doc/thinking/ по датам
- Полный ход рассуждений в doc/thinking/2026-04-04.md

Ключевые решения:
- IoT код в iot/ (легко вынести потом)
- CRD IoTDevice + контроллер (как все остальное в sless)
- EMQX HTTP Auth Backend для динамической аутентификации устройств
- Архитектура broker-agnostic (легко переключить на Kafka)
- Terraform: расширяем текущий provider (sless_iot_device ресурс)

examples/README.md

@@ -1,75 +1,56 @@
-# Примеры использования sless
+# sless — примеры
 
-## Обзор платформы
+> ⚠️ **Тестовое окружение.** Все примеры работают с тестовым API Nubes и тестовым кластером sless. Не используйте в продакшне без предварительного согласования.
 
-**sless** — система управления serverless-функциями на базе Kubernetes. Разработчик загружает код функции, платформа собирает из него Docker-образ, разворачивает его в кластере и предоставляет HTTP-эндпоинт для вызова. Всё описывается декларативно через Terraform.
-
-### Основные ресурсы провайдера
-
-| Ресурс | Назначение |
-|---|---|
-| `sless_service` | Long-running HTTP-сервис: всегда активен, отвечает на запросы. Имеет свой URL после деплоя. |
-| `sless_job` | Одноразовый запуск функции: собирает образ, выполняет код, завершается. Используется для миграций БД, batch-обработки и т.д. |
-
-Namespace функций вычисляется автоматически из JWT-токена: `sless-{sha256[:8]}`.
+**sless** — платформа для запуска serverless-функций на базе Kubernetes.  
+Разработчик загружает код, платформа собирает Docker-образ и разворачивает его в кластере.  
+Всё описывается декларативно через Terraform.
 
 ---
 
-## Требования
+## Ресурсы Terraform-провайдера
 
-- Terraform >= 1.3
-- JWT-токен для аутентификации в sless API
-- JWT-токен для Nubes Cloud API (если используются managed-ресурсы: PostgreSQL и т.д.)
-- Доступ к `https://sless.kube5s.ru`
+| Ресурс | Что делает |
+|---|---|
+| `sless_job` | Разовый запуск: выполняет код один раз и завершается (установка ПО, миграции и т.д.) |
+| `sless_service` | HTTP-сервис: всегда запущен, отвечает на запросы, имеет постоянный URL — _примеры появятся позднее_ |
+
+---
 
 ## Конфигурация провайдера
 
 ```hcl
 provider "sless" {
   endpoint = "https://sless.kube5s.ru"
-  token    = var.sless_token
-}
-
-provider "nubes_cloud" {
-  base_url = "https://deck-api-test.ngcloud.ru/api/v1"
-  token    = var.nubes_token
+  token    = var.api_token
 }
 ```
 
-> Токены задаются в `terraform.tfvars` — этот файл добавлен в `.gitignore`.
+Токен задаётся в `terraform.tfvars` (файл в `.gitignore`, не попадает в git).
 
 ---
 
 ## Примеры
 
-### `POSTGRES` — Serverless-функции с Managed PostgreSQL
+### [`VM/`](VM/) — Виртуальная машина в Nubes vDC
 
-Полный пример: managed PostgreSQL + одноразовый init-job + 3 HTTP-сервиса (чтение/запись данных и информация о PG).
+Создаёт vApp + Ubuntu 22.04 VM в облаке Nubes. После создания — автоматически устанавливает ПО (nginx, Docker, пакеты) через serverless-джобы (`sless_job`) по SSH.
 
-Языки: Python 3.11, Node.js 20.
+> В этом примере используются только **разовые джобы** (`sless_job`). Примеры с HTTP-сервисами (`sless_service`) появятся позднее.
 
-```bash
-cd POSTGRES
-terraform init
-terraform apply
-```
-
-Подробности: [POSTGRES/README.md](POSTGRES/README.md)
+**→ [Начать здесь](VM/README.md)**
 
 ---
 
 ## Полезные команды
 
 ```bash
-# Посмотреть состояние задеплоенных ресурсов:
+# Посмотреть состояние ресурсов:
 terraform show
 
-# Принудительно пересобрать сервис (после изменения кода):
-terraform apply -replace=sless_service.<имя>
-
-# Повторно запустить job: увеличить run_id в .tf-файле, затем:
+# Повторно запустить установку ПО: увеличить install_run_id в terraform.tfvars, затем:
 terraform apply
 
-# Удалить все ресурсы примера:
+# Удалить все ресурсы:
 terraform destroy
 ```