Initial commit: VoIdeaAI - voice-first AI idea assistant

2026-05-13 12:51:42 +03:00
commit 688d043dad
421 changed files with 47915 additions and 0 deletions
@@ -0,0 +1,57 @@
+# 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 + доступность)
+- Кто заполняет? (тот, кто принял решение, сразу)