metaagent updated
This commit is contained in:
+57
-35
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user