metaagent update to v1.1.0
This commit is contained in:
+41
-38
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user