Что такое спецификация
dagstack/config-spec — нормативный источник истины для конфигурации dagstack-экосистемы. Он фиксирует что должно быть в любой реализации (dagstack/config-python, dagstack/config-typescript, планируемый dagstack/config-go) — и почему именно так.
Чем раздел «Спецификация» отличается от руководств
| Раздел | Для кого | Что даёт |
|---|---|---|
| Понятия | Разработчик приложения | Объясняет, как работает конфиг сегодня, в применении к конкретному языку. |
| Руководства | Разработчик приложения | Пошагово решает задачу. |
| Спецификация (этот раздел) | Автор реализации / ревьюер | Объясняет почему принято решение; фиксирует нормативные гарантии. |
ADR
На момент v1.0 зафиксирован один ADR:
- ADR-0001: YAML configuration with env interpolation — формат передачи, слои, env-интерполяция, абстракция ConfigSource, модель ошибок, подписки, канонический JSON, артефакты спецификации.
Дополнительные ADR появятся по мере развития экосистемы (например, составные профили, параметризованные переопределения, validation webhooks).
Нормативный источник
Страницы этого раздела — описательная русскоязычная выжимка ADR. Формальный нормативный текст — в dagstack/config-spec. Если вы готовите изменения в реализации — читайте нормативную версию: там все пограничные случаи, правила сериализации, требования к error-сообщениям.
Процесс изменения спецификации
- Issue в
dagstack/config-spec. - PR с новым ADR или ревизией существующего.
- Architect review + подтверждение мейнтейнеров реализаций (все реализации должны подтвердить, что смогут реализовать).
- После merge — обновление реализаций и выжимки в этом разделе.
Связанные спецификации
dagstack/plugin-system-spec— плагин-система читает секции плагинов через config-stack.dagstack/logger-spec— логгер читает свою секцию через config.dagstack/tenancy-spec— модель тенантов конфигурируется через config.