# Decision Log

Лёгкий трекер каждодневных решений.
В отличие от ADR (фиксируют архитектуру), Decision Log фиксирует **контекст** — почему мы сделали тот или иной выбор.
Через 3 месяца никто не вспомнит "почему мы взяли SQLite", а Decision Log напомнит.

---

## Формат записи

```markdown
## {YYYY-MM-DD}: {Решение}

**Контекст:** {Почему встал вопрос, какие были ограничения}
**Решение:** {Что выбрали}
**Альтернативы:** {Что рассматривали, почему не взяли}
**Кто:** {Кто принял решение}
**Статус:** {действует | пересмотреть через N | заменено}
```

---

## Пример

```markdown
## 2026-05-10: Выбрали SQLite для разработки

**Контекст:** У команды Windows, PostgreSQL требует установки и настройки.
На старте важна скорость — поднять проект за 5 минут, а не за час.

**Решение:** SQLite + aiosqlite для локальной разработки.
PostgreSQL — только на production.

**Альтернативы:**
- PostgreSQL + Docker — работает, но Docker не у всех
- PostgreSQL native — адская установка на Windows

**Кто:** @owner
**Статус:** действует. Пересмотреть перед production.
```

---

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

- Выбрали технологию (БД, провайдер, фреймворк)
- Отложили функциональность (не делаем OAuth сейчас)
- Изменили подход (было sessions, стало JWT)
- Архитектурный компромисс (знаем что не идеально, но время поджимает)

---

## [ASK]

- Вести Decision Log в Markdown или в YAML? (Markdown — читаемость)
- Хранить в репозитории или в Notion/wiki? (в репозитории — git history + доступность)
- Кто заполняет? (тот, кто принял решение, сразу)