metaagent update to v1.1.0

This commit is contained in:
2026-07-22 01:27:30 +03:00
parent 685d3262d8
commit 7aec35b8df
6 changed files with 174 additions and 262 deletions
+41 -38
View File
@@ -4,72 +4,75 @@
- **Session ID:** `metaagent-002`
- **Target repo:** `S:\Git\nifodea`
- **Date:** 2026-07-12
- **Date:** 2026-07-22
- **Project type:** `existing`
## 1. Общая информация
- **README:** CashFlow Forecast — личная финансовая модель с прогнозом денежных потоков, сценарным анализом и AI-ассистентом
- **Лицензия:** не указана
- **README:** Личная финансовая модель с прогнозом денежных потоков, сценарным анализом и AI-ассистентом. Python + JSON + Excel + AI.
- **Лицензия:** не выбрана
- **CI/CD:** отсутствует
- **Точка входа:** `cli/main.py:app` (команда `cf`)
- **Точка входа:** `cli/main.py` (команда `cf`)
- **Система сборки:** `pyproject.toml` (setuptools)
## 2. Стек технологий
| Компонент | Значение |
|---|---|
| Язык | Python 3.11+ (фактически 3.13) |
| Фреймворк | Typer (CLI), openpyxl (Excel) |
| Язык | Python >= 3.11 |
| Фреймворк | Typer (CLI) |
| База данных | JSON-файлы |
| Тестовый раннер | pytest |
| Пакетный менеджер | pip + venv |
| Линтер | ruff |
| Пакетный менеджер | pip (setuptools) |
| Линтер/форматтер | ruff |
## 3. Архитектура
**Паттерн:** Модульный монолит (Layered)
```
cli/ → sync/ ⇒ cashflow_model/ ⇔ engine/ → ai/
(Excel) (Entity Model) (Forecast) (Prompts)
cashflow_model/ # Модели данных (dataclass + JSON)
engine/ # Вычислительное ядро (forecast + scenarios)
sync/ # Excel import/export
ai/ # AI-ассистент (заглушка)
cli/ # CLI (Typer)
tests/ # pytest
data/ # JSON-модели
exports/ # Экспортированные .xlsx
```
**Модули:**
- `cashflow_model/` — сущности dataclass + JSON сериализация (Account, Transaction, RecurringCashflow, Asset, Liability, ForecastScenario, FinancialModel)
- `engine/` — ForecastService (прогноз), ScenarioService (сценарии + what-if)
- `sync/` — ExcelSync (импорт/экспорт .xlsx через openpyxl)
- `ai/` — AssistantService (промпты, заглушка), PromptsTemplate
- `cli/` — Typer CLI (init, forecast, scenario, whatif, compare, import, export, analyze)
- `tests/` — pytest тесты (26 tests)
**Паттерн:** Модульный монолит
**Внешние зависимости:** openpyxl, typer, rich
**Ключевые модули:**
## 4. Конвенции кода
| Модуль | Описание |
|---|---|
| cashflow_model | Модели данных: Account, Transaction, RecurringCashflow, Asset, Liability, ForecastScenario, FinancialModel |
| engine | Вычислительное ядро: ForecastService (прогноз), ScenarioService (сценарии + what-if) |
| sync | ExcelSync — импорт/экспорт .xlsx |
| ai | AssistantService — генерация промптов (заглушка) |
| cli | Typer CLI — 8 команд |
- **Стиль:** ruff (E, F, I, N, W), line-length=100
- **Именование:** snake_case для функций/переменных, PascalCase для классов
- **Типизация:** аннотации типов
- **Обработка ошибок:** кастомные исключения (ModelError, SyncError, ForecastError)
## 4. Конвенции
- **Стиль:** snake_case для функций/переменных, PascalCase для классов
- **Импорты:** стандартные, сгруппированные
- **Типизация:** используется (dataclass, type hints)
- **Обработка ошибок:** через исключения
- **Логирование:** не используется
## 5. Тесты
- **Типы:** unit-тесты
- **Расположение:** `tests/`
- **Запуск:** `pytest`
- **Текущее состояние:** 26/26 passed (100%)
- **Покрытие:** не измеряется
- **Команда запуска:** `pytest`
- **Всего тестов:** 26
- **Пройдено:** 26
- **Упало:** 0
- **Пропущено:** 0
## 6. Базовая проверка
- **Сборка:** pip install -e . — success
- **Импорты:** все модули импортируются без ошибок
- **Линтер:** ruff check — All checks passed
- **Git status:** clean
- **Сборка:** OK (pip install -e .)
- **Линтер:** OK (ruff check . — all checks passed)
- **Git status:** есть незакоммиченные изменения (checkpoints.json, metaagent-request.md, AGENTS.md, data/model.json, .agent/rules/)
## 7. Примечания
## 8. Примечания
- Проект полностью реализован (MVP)
- AI-ассистент — заглушка, промпты готовы
- Лицензия не выбрана — требуется решение
Проект полностью функционален: 26 тестов проходят, линтер чист. Требуется только обновление MetaAgent-артефактов до v1.1.0.