docs: IoT telemetry storage architecture decisions and thinking log

doc/architecture/overview.md

@@ -1,32 +1,74 @@
 # Архитектура системы
 
-Последнее обновление: 2026-03-18 (v0.1.34 + funcs-service v0.2.0)
+Последнее обновление: 2026-04-04 (IoT telemetry storage architecture decision)
 
 ## Общее описание
 
-Managed Serverless Functions Service для облачного провайдера nubes.ru.
+Managed Serverless Functions Service + IoT Platform для облачного провайдера nubes.ru.
+Два независимых компонента: sless (serverless) и iot (IoT), каждый со своим оператором.
 Пользователь загружает код через Terraform, сервис его собирает (kaniko) и запускает
-по HTTP-триггеру, расписанию (cron) или вручную через one-shot Job.
+по HTTP-триггеру, расписанию (cron), вручную или по событию от IoT устройства.
+
+## Namespace Layout
+
+```
+namespace: sless          — платформа serverless
+                            (sless-operator, event-dispatcher, RabbitMQ, Postgres invocations)
+namespace: sless-{hash}   — tenant функции (function pods каждого клиента)
+namespace: iot            — платформа IoT
+                            (iot-operator, EMQX, Postgres telemetry)
+namespace: iot-{hash}     — tenant IoT ресурсы (IoTDevice CRDs)
+```
 
 ## Стек
 
 | Компонент | Технология | Где запущен |
 |-----------|-----------|-------------|
-| Operator (API + Controllers) | Go (controller-runtime) | Kubernetes, namespace `sless` |
-| funcs-service (глобальная консоль) | Go (net/http) | Kubernetes, namespace `sless` |
-| PostgreSQL | PostgreSQL 16 | Kubernetes, namespace `sless` |
+| sless-operator (API + Controllers) | Go (controller-runtime) | namespace `sless` |
+| iot-operator (API + Controllers) | Go (controller-runtime) | namespace `iot` |
+| PostgreSQL (invocations) | PostgreSQL 16 | namespace `sless` |
+| PostgreSQL (telemetry) | PostgreSQL 16 | namespace `iot` |
+| EMQX | EMQX 5.5.1 | namespace `iot` |
+| RabbitMQ | RabbitMQ 3 | namespace `sless` |
+| event-dispatcher | Go | namespace `sless` |
+| iot-mqtt-bridge | Go | namespace `iot` |
 | S3 | Ceph (облачный) | `s3.msk-1.ngcloud.ru` |
-| Container Registry | DockerHub (`naeel/`) | внешний |
+| Container Registry | PearlHarbor (Nubes) | внешний |
 | Builder | kaniko (k8s Job) | namespace пользователя |
-| Функции (HTTP) | k8s Deployment + Service | namespace пользователя |
-| Функции (one-shot) | k8s Job | namespace пользователя |
-| Функции (cron) | k8s CronJob | namespace пользователя |
+| Функции (HTTP) | k8s Deployment + Service | namespace sless-{hash} |
+| Функции (one-shot) | k8s Job | namespace sless-{hash} |
+| Функции (cron) | k8s CronJob | namespace sless-{hash} |
 | Terraform Provider | Go (plugin framework v6) | localhost/CI |
 | nubes API | REST (облако) | `deck-api.ngcloud.ru` |
 
-> Redis и RabbitMQ — отложены до v2.
+## IoT Data Flow
 
-## Компонент: funcs-service
+```
+IoT устройство
+    ↓ ws://iot.kube5s.ru:80/mqtt (WebSocket, пока 1883 закрыт)
+EMQX (namespace iot)
+    ↓ ACL: каждое устройство видит только свои топики {ns}/{deviceId}/#
+iot-mqtt-bridge
+    ↓
+RabbitMQ (namespace sless)
+    ↓
+event-dispatcher
+    ↓ параллельно:
+    1. INSERT INTO tenant_{ns}.iot_telemetry  ← автоматически
+    2. Вызов serverless function (если настроена)
+```
+
+## Изоляция данных
+
+- MQTT: ACL по username → топики только своего устройства
+- Postgres: отдельная DATABASE per tenant, разные credentials
+- k8s: отдельный namespace per tenant
+
+## Связь sless ↔ iot
+
+- Общий идентификатор tenant: `{hash}` в именах namespace
+- Коммуникация через RabbitMQ endpoint (не через Go пакеты)
+- Loose coupling — могут быть в разных кластерах
 
 Глобальный HTTP сервис — **одна копия** на весь кластер, для всех пользователей.