add comprehensive documentation for Stands Engine, including application manifests, stand configuration, operations guide, and example scenarios

Author: AVRybin

README.md

@@ -4,6 +4,15 @@ Stands Engine разворачивает инфраструктурный сте
 
 Главная идея Stands Engine - управлять инфраструктурой через модель стенда, а не через набор разрозненных слоев.
 
+## Документация
+
+Этот README даёт общий обзор проекта и быстрый старт. Исчерпывающие руководства
+собраны в [разделе документации](docs/README.md):
+
+- [описание переиспользуемых приложений](docs/application-manifest.md);
+- [полный контракт манифеста стенда](docs/stand-manifest.md);
+- [настройка и эксплуатация движка](docs/operations.md).
+
 В классической схеме один запуск обычно распадается на несколько инструментов: Terraform/Pulumi создает ресурсы, Ansible или shell-скрипты доводят серверы до нужного состояния, Docker/Kubernetes-манифесты запускают приложения. Связи между этими слоями часто живут в CI, документации или договоренностях команды.
 
 Stands Engine делает стенд основной единицей описания. В одном YAML-манифесте фиксируются серверы, профили железа, пользователи, приложения, роли, порты, шаблоны конфигурации, хуки и размещение инстансов по узлам. Дальше движок сам раскладывает эту модель на provision, post-provision и application layer.

docs/README.md

@@ -0,0 +1,39 @@
+# Документация Stands Engine
+
+Stands Engine разделяет инфраструктуру на три уровня:
+
+1. **Приложение** — переиспользуемое описание образа, ролей и шаблонов запуска.
+2. **Стенд** — конкретный набор серверов, инстансов приложений и их размещение.
+3. **Выполнение** — настройка провайдера, создание серверов, запуск и удаление стенда.
+
+Для каждого уровня есть отдельное руководство:
+
+| Задача | Руководство |
+|---|---|
+| Добавить новое приложение в app registry | [Описание приложений](application-manifest.md) |
+| Собрать или изменить `stand.yml` | [Манифест стенда](stand-manifest.md) |
+| Настроить окружение и выполнить `create`/`destroy` | [Настройка и эксплуатация](operations.md) |
+
+## Рекомендуемый порядок чтения
+
+Если вы впервые работаете с проектом:
+
+1. Прочитайте общий обзор и быстрый старт в [README проекта](../README.md).
+2. Изучите [манифест стенда](stand-manifest.md), чтобы понять связи между
+   серверами, приложениями и инстансами.
+3. Если нужно добавить новый тип приложения, перейдите к
+   [описанию приложений](application-manifest.md).
+4. Перед реальным запуском проверьте требования в
+   [руководстве по эксплуатации](operations.md).
+
+## Примеры
+
+- [`demo/stand.yml`](../demo/stand.yml) — полный стенд с несколькими приложениями
+  и нодами.
+- [`demo/app-registry`](../demo/app-registry) — готовые описания Redis, MongoDB,
+  Redpanda, Kafka UI и Dozzle.
+- [`demo/cloud-init.yaml.mako`](../demo/cloud-init.yaml.mako) — cloud-init для
+  поддерживаемого Podman runtime.
+
+> `create` создаёт реальные облачные ресурсы. Перед запуском проверьте provider
+> credentials, типы серверов, сеть и стоимость ресурсов.