nifodea/.agent/context/project-state.md

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).