docs: все TF файлы с детальными комментариями на каждую строку

TEST_STAND/IOT_KAFKA_DEMO/main.tf

@@ -1,29 +1,36 @@
+# =============================================================================
+# Terraform-конфиг: IoT Demo стенд
+# 6 сервисов Nubes Cloud: RabbitMQ, Redis, MongoDB, 3x Node.js
+# Пайплайн: Producer -> RabbitMQ -> Consumer -> Redis+MongoDB -> Dashboard
+# =============================================================================
+
 terraform {
   required_providers {
     nubes = {
-      source  = "registry.kube5s.ru/nubes-test/nubes"
-      version = "5.1.16"
+      source  = "registry.kube5s.ru/nubes-test/nubes"  # реестр провайдера (test)
+      version = "5.1.16"                                 # версия провайдера Nubes
     }
   }
 }
 
+# API-токен для доступа к Nubes (из secrets/test.token)
 variable "api_token" {
-  type        = string
-  sensitive   = true
-  description = "Nubes API token"
+  type      = string
+  sensitive = true  # не показывать в логах/плане
 }
 
+# Кластер Kubernetes для развёртывания (k8s-4-sandbox-nubes-ru)
 variable "realm" {
-  type        = string
-  description = "resource_realm parameter for all resources"
+  type = string
 }
 
+# S3-пользователь для бэкапов (не используется в этом демо)
 variable "s3_name" {
-  type        = string
-  description = "S3 user name for backups"
+  type = string
 }
 
+# Конфигурация провайдера Nubes
 provider "nubes" {
   api_token    = var.api_token
-  api_endpoint = "https://lk-api-gateway-test.ngcloud.ru/api/v1/svc"
+  api_endpoint = "https://lk-api-gateway-test.ngcloud.ru/api/v1/svc"  # тестовый API
 }