metaagent updated

This commit is contained in:
2026-07-22 01:37:07 +03:00
parent 5afea8238c
commit 3cc8e94863
33 changed files with 2870 additions and 493 deletions
+57 -35
View File
@@ -2,55 +2,77 @@
## Session
- **Session ID:** `metaagent-001`
- **Session ID:** `metaagent-002`
- **Target repo:** `S:\Git\nifodea`
- **Date:** 2026-07-12
- **Project type:** `greenfield`
- **Date:** 2026-07-22
- **Project type:** `existing`
## 1. Общая информация
- **README:** CashFlow Forecast — open-source проект для построения и анализа личной финансовой модели с использованием Spreadsheet, Python и AI.
- **Лицензия:** не указана
- **README:** Личная финансовая модель с прогнозом денежных потоков, сценарным анализом и AI-ассистентом. Python + JSON + Excel + AI.
- **Лицензия:** не выбрана
- **CI/CD:** отсутствует
- **Точка входа:** не определена
- **Система сборки:** отсутствует
- **Точка входа:** `cli/main.py` (команда `cf`)
- **Система сборки:** `pyproject.toml` (setuptools)
## 7. Требования (из README)
## 2. Стек технологий
### Функциональные требования
| Компонент | Значение |
|---|---|
| Язык | Python >= 3.11 |
| Фреймворк | Typer (CLI) |
| База данных | JSON-файлы |
| Тестовый раннер | pytest |
| Пакетный менеджер | pip (setuptools) |
| Линтер/форматтер | ruff |
- Прогноз денежных потоков (Cash Flow Forecasting)
- Моделирование бюджета
- Сценарный анализ (What-if Analysis)
- Учет активов и обязательств
- Прогноз ликвидности
- Анализ финансовой устойчивости
- Моделирование достижения финансовых целей
- Импорт/экспорт данных через Spreadsheet (Excel)
## 3. Архитектура
### Нефункциональные требования
```
cashflow_model/ # Модели данных (dataclass + JSON)
engine/ # Вычислительное ядро (forecast + scenarios)
sync/ # Excel import/export
ai/ # AI-ассистент (заглушка)
cli/ # CLI (Typer)
tests/ # pytest
data/ # JSON-модели
exports/ # Экспортированные .xlsx
```
- **Spreadsheet** — визуальный редактор и UI
- **Python** — вычислительное ядро
- **JSON** — внутреннее представление модели данных
- **AI** — инструмент анализа и взаимодействия
- Все компоненты должны быть взаимозаменяемыми
- Open-source
**Паттерн:** Модульный монолит
### Бизнес-контекст
**Ключевые модули:**
- **Цель:** отвечать на вопрос "Что произойдет дальше?" (forecast), а не "Что произошло?" (accounting)
- **Аудитория:** частные лица для персонального финансового планирования
- **Успех:** работающая прогнозная модель денежных потоков с возможностью сценарного анализа
| Модуль | Описание |
|---|---|
| cashflow_model | Модели данных: Account, Transaction, RecurringCashflow, Asset, Liability, ForecastScenario, FinancialModel |
| engine | Вычислительное ядро: ForecastService (прогноз), ScenarioService (сценарии + what-if) |
| sync | ExcelSync — импорт/экспорт .xlsx |
| ai | AssistantService — генерация промптов (заглушка) |
| cli | Typer CLI — 8 команд |
### Неясные моменты / Вопросы
## 4. Конвенции
- Не указана лицензия — требуется уточнить
- Не указана конкретная версия Python
- Какой формат Spreadsheet (Excel .xlsx, Google Sheets, оба)?
- Какие AI-провайдеры предполагаются (OpenAI, локальные модели)?
- Требуется ли веб-интерфейс или только CLI + Spreadsheet?
- **Стиль:** snake_case для функций/переменных, PascalCase для классов
- **Импорты:** стандартные, сгруппированные
- **Типизация:** используется (dataclass, type hints)
- **Обработка ошибок:** через исключения
- **Логирование:** не используется
## 5. Тесты
- **Команда запуска:** `pytest`
- **Всего тестов:** 26
- **Пройдено:** 26
- **Упало:** 0
- **Пропущено:** 0
## 6. Базовая проверка
- **Сборка:** OK (pip install -e .)
- **Линтер:** OK (ruff check . — all checks passed)
- **Git status:** есть незакоммиченные изменения (checkpoints.json, metaagent-request.md, AGENTS.md, data/model.json, .agent/rules/)
## 8. Примечания
Проект greenfield. MVP должен включать: модель данных (JSON), ядро forecast engine, базовый sync с Excel, интерфейс для AI-ассистента. Все модули — Python.
Проект полностью функционален: 26 тестов проходят, линтер чист. Требуется только обновление MetaAgent-артефактов до v1.1.0.