add: documentation

2026-06-30 15:45:24 +04:00
parent 540c1f7293
commit ca276d200f
1055 changed files with 47294 additions and 0 deletions
@@ -0,0 +1,51 @@
+# Шаблон акта (март 2026)
+
+Цель: сохранить готовые формулировки и раскладку сумм, чтобы далее быстро готовить акты.
+
+Сумма акта: **229 885,06 руб.**
+Период оценки трудозатрат: **примерно 160 часов** (40 часов/неделя × 4 недели).
+
+---
+
+## Вариант 1 (более технический)
+
+| № п/п | Наименование оказанных услуг | Стоимость, руб. |
+|---:|---|---:|
+| 1 | Доработка lifecycle-логики провайдера для instance-ресурсов: канон `adopt_existing_on_create` / `suspend_on_destroy`, корректные ветки `running/suspended`, синхронизация поведения plan/apply/destroy | 62 000,00 |
+| 2 | Оптимизация update-поведения провайдера: исключение лишних API modify-вызовов при изменении только provider-level флагов (state-only update) | 41 500,00 |
+| 3 | Переработка диагностик и UX: устранение дублей предупреждений, унификация сообщений, многострочный формат и повышение читаемости для пользователей | 28 385,06 |
+| 4 | Восстановление и стандартизация контура генерации документации: возврат к шаблонному pipeline, правки guide-разделов, выравнивание create/output страниц | 52 000,00 |
+| 5 | Инвентаризация реальных output-полей из облака (running/suspended), формирование snapshot-baseline в docs и внедрение в Output params, публикация актуальной документации | 46 000,00 |
+|  | **Итого** | **229 885,06** |
+
+---
+
+## Вариант 2 (упрощённый для бухгалтерии, с часами)
+
+| № п/п | Наименование оказанных услуг | Кол-во часов (≈) | Стоимость, руб. |
+|---:|---|---:|---:|
+| 1 | Сопровождение и доработка Terraform-провайдера (логика жизненного цикла ресурсов, стабильность работы) | 44 | 63 250,00 |
+| 2 | Развитие генераторов ресурсов и схем, автоматизация формирования конфигураций | 34 | 48 875,00 |
+| 3 | Улучшение качества диагностики и обработки сценариев применения/изменения ресурсов | 22 | 31 625,00 |
+| 4 | Подготовка и обновление пользовательской и технической документации, публикация релизных материалов | 40 | 57 500,00 |
+| 5 | Сопровождение инфраструктуры публикации (registry, S3, CI/CD), релизные операции и контроль доступности | 20 | 28 635,06 |
+|  | **Итого** | **160** | **229 885,06** |
+
+---
+
+## Короткие формулировки для будущих актов (reuse)
+
+- Развитие и сопровождение Terraform-провайдера.
+- Автоматизация генерации ресурсов и схем.
+- Улучшение стабильности и диагностик.
+- Подготовка и публикация документации.
+- Сопровождение инфраструктуры публикации и релизного контура.
+
+---
+
+## Примечание
+
+Для следующего акта можно:
+1. Скопировать «Вариант 2» как базу.
+2. Подставить новый период и новую сумму.
+3. Перераспределить часы/стоимость по фактическим трудозатратам.