# Project State

**Снимок на момент:** 2026-10-08T17:05 (после METASTATE)
**Project type:** `existing`
**MetaAgent version:** 3.0.0

---

## Что произошло в сессии 2026-10-08

**Goal:** «Обсуждение архитектуры и серьёзный refactor»

Выполнен полный архитектурный рефактор по 5 направлениям:

1. **A1+A10: Слои + version** — `domain/`, `application/`, `infrastructure/`; `FinancialModel.SCHEMA_VERSION=1` с миграционным хуком.
2. **A2+A3: Pydantic v2** — все модели на `BaseModel`, валидаторы, `model_dump`/`model_validate`.
3. **A4: Decimal для денег** — все monetary поля, `CurrencyConverter`, `ForecastService`, `ScenarioService` работают с `Decimal`.
4. **A7+A8+A9: DI + Repository** — `ModelRepository` Protocol, `JsonFileRepository`, `ExcelRepository`; `AssistantService` получает `ForecastService` через DI; `build_services()` — composition root в CLI.
5. **A5: Декомпозиция CLI** — `main.py` (330 LOC) → 9 файлов в `commands/`, `config.py` (428 LOC) → `config_cmd.py` (15 sub-команд).

**Результат:** 67/67 тестов проходят, CLI работает, Excel round-trip сохраняет данные.

## Архитектура (после рефактора)

**Модульный монолит на Python 3.11+** для личного финансового планирования. Три слоя:

```
┌─────────────────────────────────────────────┐
│          domain/ — бизнес-модели             │
│  Account, Transaction, Asset, Liability,   │
│  Recurring, Scenario, FinancialModel,      │
│  ExchangeRate, CurrencyConverter            │
│  (pydantic.BaseModel, Decimal)              │
└──────────────────┬──────────────────────────┘
                   │
┌──────────────────▼──────────────────────────┐
│   application/ — прикладные сервисы         │
│  ForecastService, ScenarioService,         │
│  ModelRepository (Protocol)                 │
└──────────────────┬──────────────────────────┘
                   │
┌──────────────────▼──────────────────────────┐
│  infrastructure/ — внешний мир              │
│  cli/ (Typer), ai/ (Assistant),             │
│  repositories/ (JsonFile, Excel)            │
└─────────────────────────────────────────────┘
```

## Tech stack

| Слой | Технология | Версия |
|---|---|---|
| Язык | Python | 3.11+ (тест на 3.14) |
| CLI | Typer | 0.27 |
| Excel | openpyxl | 3.1 |
| Терминал | rich | 15.0 |
| Валидация | pydantic | 2.13 |
| Деньги | Decimal | stdlib |
| Тесты | pytest | 9.1 |
| Линтер | ruff | 0.16 |

## Ключевые модули

| Слой | Модуль | Ответственность |
|---|---|---|
| domain | `account.py` (18 LOC), `transaction.py` (20), `asset.py` (11), `liability.py` (19), `recurring.py` (27), `scenario.py` (20) | pydantic.BaseModel + Decimal + валидаторы |
| domain | `currency.py` (83) | ExchangeRate + CurrencyConverter (Decimal, ROUND_HALF_UP) |
| domain | `model.py` (71) | FinancialModel — корневой агрегатор с SCHEMA_VERSION=1 |
| application | `forecast.py` (115) | ForecastService — Decimal-арифметика, помесячный прогноз |
| application | `scenarios.py` (91) | ScenarioService — baseline/optimistic/pessimistic + what-if |
| application | `repositories/model_repository.py` (20) | Protocol с load()/save() |
| infrastructure | `cli/app.py` (45) | Entry point, регистрирует все команды |
| infrastructure | `cli/commands/*.py` | 9 файлов (init/forecast/scenario/whatif/compare/import_xlsx/export_xlsx/analyze/info) + config_cmd.py |
| infrastructure | `cli/paths.py` (5) | MODEL_PATH, DATA_DIR |
| infrastructure | `cli/services.py` (60) | build_services() — composition root + helpers |
| infrastructure | `cli/i18n.py` (350) | ru/en словари |
| infrastructure | `ai/assistant.py` (79) | AssistantService (заглушка, DI ForecastService) |
| infrastructure | `repositories/json_file_repository.py` (20) | .json storage |
| infrastructure | `repositories/excel_repository.py` (138) | .xlsx storage |

## Статус тестов

| Параметр | Значение |
|---|---|
| Всего тестов | 67 |
| Пройдено | 67 ✅ |
| Упало | 0 |
| Время | 2.4s |
| Тестовых модулей | 10 |

## Что было сделано в сессии

- ✅ Pydantic v2 во всех моделях
- ✅ Decimal для всех денежных полей
- ✅ Слои domain/application/infrastructure
- ✅ Schema versioning (version=1 + legacy v0 support)
- ✅ ModelRepository Protocol + JsonFile + Excel
- ✅ DI через composition root
- ✅ CLI decomposition (main.py 330 LOC → 9 файлов, config.py 428 LOC → config_cmd.py)
- ✅ 67/67 тестов проходят
- ✅ CLI команды работают, Excel round-trip OK
- ✅ README обновлён

## Что отсутствует / TODO

- ❌ **AI-интеграция** — `AssistantService` не вызывает LLM API (отклонено пользователем)
- ❌ **Лицензия** — файл есть, но содержимое — шаблон
- ❌ **CI/CD** — нет `.github/`, нет pre-commit hooks
- ❌ **FUTURE/** — нет директории с долгосрочными планами
- ❌ **mypy** — не настроен
- ❌ **Логирование** — только `rich.print`

## Известные ADR-кандидаты (для следующей сессии)

| ID | Тема |
|---|---|
| ADR-001 | Repository pattern (T4) — формализовать контракт |
| ADR-002 | Слоистая архитектура (T1) — границы domain/application/infrastructure |
| ADR-003 | Schema versioning — политика миграций модели |

## Следующая сессия — что делать

1. **Зафиксировать ADR-001, ADR-002, ADR-003** через `/adr` — закрепить архитектурные решения.
2. **CI/CD** (P1) — добавить `.github/workflows/ci.yml` (pytest + ruff).
3. **Лицензия** (P2) — выбрать MIT/Apache-2.0/BSD-3, обновить `LICENSE`.
4. **mypy** (P1) — добавить `[tool.mypy]` в `pyproject.toml` для strict-проверки.
5. **Новые фичи** (P3) — Monte-Carlo, FIRE, REST API, Web UI, импорт банковских выписок (из `README.arch.md`).