Шаблон ADR

Когда использовать

Для архитектурных решений в decisions/adr/NNN-<slug>.md. Один ADR — одно решение.

Frontmatter

---
title: ADR-NNN <название>
sidebar_label: ADR-NNN
sidebar_position: <NNN>
status: proposed | accepted | superseded | deprecated
version: v1.0
date: 2026-04-30
owners:
  - architecture
supersedes: ADR-... | null
superseded_by: ADR-... | null
domains:
  - identity | storefront | crm | lms | task-bank | competitions | management | platform
---

Структура

# ADR-NNN. <Название>

## Контекст

Какая ситуация и какие силы (требования, ограничения) её формируют. Что делает решение нужным.

## Решение

Что именно решено. Формулировка должна быть однозначной.

## Альтернативы

| Альтернатива | Почему отвергнута |
|---|---|

## Последствия

- положительные;
- отрицательные;
- что становится обязательным;
- что становится запрещённым.

## Затрагиваемые области

- какие домены меняются;
- какие платформенные документы меняются;
- какие интеграции переписываются.

## Связи

- предыдущие ADR;
- последующие ADR;
- документы, на которые влияет решение.

Правила

• Принятый ADR не редактируется по сути; уточнения — комментарием или новым ADR со ссылкой supersedes.
• ADR не описывает реализацию; реализация уходит в доменные/платформенные документы.
• Каждый ADR ссылается на соответствующие места в документации.