docs: initial project documentation

- architecture overview and stack
- project structure and development order
- API design (endpoints, models, runtimes)
- infrastructure overview (k8s cluster, S3, registry)
- decisions log with rationale
- progress tracker v1/v2

doc/decisions/log.md

@@ -0,0 +1,47 @@
+# Решения и обоснования
+
+## 2026-03-06 — Отдельная репа для сервиса
+
+**Решение:** Serverless service в отдельной репе, не вместе с Terraform provider.
+
+**Причина:** Разные зоны ответственности, разные релизы, потенциально разные команды.
+
+---
+
+## 2026-03-06 — Один бинарник для v1
+
+**Решение:** Один Go бинарник вместо микросервисов.
+
+**Причина:** Нагрузки изначально нет. Проще деплоить, проще отлаживать. Разделим при необходимости.
+
+---
+
+## 2026-03-06 — Аутентификация через облачный токен
+
+**Решение:** Использовать Bearer token облака, без Keycloak.
+
+**Причина:** Terraform provider уже работает с токенами облака. Keycloak — лишняя зависимость для v1.
+
+---
+
+## 2026-03-06 — S3 облачный, остальное в кубере
+
+**Решение:** S3 (Ceph) использовать облачный (`ceph.tst.nubes.ru`), PostgreSQL/Redis — в кластере.
+
+**Причина:** S3 имеет внешний доступ и уже готов. Для PostgreSQL/Redis сетевого связывания с облаком пока нет — настраивается через devops облака.
+
+---
+
+## 2026-03-06 — Текущий кластер для разработки
+
+**Решение:** Использовать существующий k8s кластер (namespace `sless`), потом перенести на новый.
+
+**Причина:** Новый кластер ещё не готов. Изоляция через namespace — безопасно для существующих сервисов.
+
+---
+
+## 2026-03-06 — RabbitMQ откладываем
+
+**Решение:** В v1 только HTTP и Cron триггеры. RabbitMQ/event triggers — в v2.
+
+**Причина:** Упрощение первой итерации.