Architecture Decision Records (ADR)
ADR — это короткие документы, фиксирующие архитектурные решения, принятые в ходе разработки проекта.
Формат: MADR (Markdown Architectural Decision Records)
Индекс решений
| # |
Название |
Статус |
Дата |
| ADR-001 |
SQLite как основной backend персистенции |
✅ Принято |
2025-04 |
| ADR-002 |
threading.RLock для thread safety памяти |
✅ Принято |
2025-05 |
| ADR-003 |
typing.Protocol для dependency injection |
✅ Принято |
2025-05 |
| ADR-004 |
BM25 + Vector Hybrid Retrieval с RRF |
✅ Принято |
2025-06 |
| ADR-005 |
Шаблонные ответы без LLM на MVP-этапе |
✅ Принято |
2025-06 |
| ADR-006 |
Синхронный EventBus со snapshot pattern |
✅ Принято |
2025-06 |
| ADR-007 |
CPU-only платформа (без GPU) |
✅ Принято |
2025-03 |
Статусы
| Статус |
Описание |
| 🔵 Предложено |
Решение предложено, обсуждается |
| ✅ Принято |
Решение принято и реализовано |
| ⚠️ Устарело |
Решение заменено другим ADR |
| ❌ Отклонено |
Решение отклонено с обоснованием |
Как добавить новый ADR
- Скопировать шаблон
ADR-000-template.md
- Присвоить следующий номер
- Заполнить все секции
- Добавить в индекс выше
- Обновить статус при изменении решения