Stage 01 - bootstrap v2 stable start

docs/architecture/overview.md

@@ -0,0 +1,11 @@
+# Architecture Overview
+
+Проект строится как modular monolith с разделением по слоям:
+
+- `telegram` — меню, handlers, routers
+- `bootstrap` — сборка приложения
+- `core` — конфигурация и базовые сущности
+- `trading` — бизнес-логика торговли
+- `storage` — доступ к данным
+- `integrations` — внешние API
+- `shared` — общие утилиты

docs/architecture/project_structure.md

@@ -0,0 +1,15 @@
+# Project Structure
+
+## Корневые папки
+- `app/` — код приложения
+- `docs/` — документация
+- `infra/` — Docker и compose
+
+## Внутри `app/src`
+- `bootstrap/`
+- `core/`
+- `telegram/`
+- `trading/`
+- `storage/`
+- `integrations/`
+- `shared/`

docs/architecture/telegram_menu.md

@@ -0,0 +1,13 @@
+# Telegram Menu
+
+Верхнее меню bootstrap v2:
+
+1. `🏠 Главная` `📈 Рынок` `💼 Портфель`
+2. `⚡ Торговля` `🤖 Авто` `📒 Журнал`
+3. `⚙️ Система`
+
+На старте реально работают:
+- `/start`
+- `/menu`
+- `/help`
+- все кнопки верхнего меню

docs/changelog.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## v2.0.0
+- создан стабильный bootstrap v2
+- добавлена чистая структура проекта
+- добавлено компактное верхнее меню 3 / 3 / 1
+- добавлены базовые handlers
+- help перенесен в раздел `Система`
+- добавлены Docker-файлы
+- добавлена стартовая документация

docs/decisions/0001-project-structure.md

@@ -0,0 +1,5 @@
+# 0001 — Project Structure
+
+Решение:
+использовать modular monolith с разбиением на `core`, `bootstrap`, `telegram`,
+`trading`, `storage`, `integrations`, `shared`.

docs/decisions/0002-menu-design.md

@@ -0,0 +1,9 @@
+# 0002 — Menu Design
+
+Решение:
+использовать компактное верхнее меню 3 / 3 / 1:
+- Главная / Рынок / Портфель
+- Торговля / Авто / Журнал
+- Система
+
+Справка перенесена в раздел `Система`.

docs/decisions/0003-python-workflow.md

@@ -0,0 +1,7 @@
+# 0003 — Python Workflow
+
+Решение:
+- использовать Python 3.12
+- создавать `.venv` внутри `app/`
+- не использовать conda/base для этого проекта
+- в VS Code выбирать `app/.venv/bin/python`

docs/stages/stage-01-bootstrap.md

@@ -0,0 +1,14 @@
+# Stage 01 — Bootstrap
+
+## Цель
+Получить стабильный стартовый каркас проекта без архитектурной каши.
+
+## Что есть
+- структура каталогов
+- env
+- зависимости
+- базовый aiogram-бот
+- reply-меню
+- handlers
+- docs
+- Docker