79 lines
3.1 KiB
Markdown
79 lines
3.1 KiB
Markdown
# Analysis Report
|
|
|
|
## Session
|
|
|
|
- **Session ID:** `metaagent-002`
|
|
- **Target repo:** `S:\Git\nifodea`
|
|
- **Date:** 2026-07-22
|
|
- **Project type:** `existing`
|
|
|
|
## 1. Общая информация
|
|
|
|
- **README:** Личная финансовая модель с прогнозом денежных потоков, сценарным анализом и AI-ассистентом. Python + JSON + Excel + AI.
|
|
- **Лицензия:** не выбрана
|
|
- **CI/CD:** отсутствует
|
|
- **Точка входа:** `cli/main.py` (команда `cf`)
|
|
- **Система сборки:** `pyproject.toml` (setuptools)
|
|
|
|
## 2. Стек технологий
|
|
|
|
| Компонент | Значение |
|
|
|---|---|
|
|
| Язык | Python >= 3.11 |
|
|
| Фреймворк | Typer (CLI) |
|
|
| База данных | JSON-файлы |
|
|
| Тестовый раннер | pytest |
|
|
| Пакетный менеджер | pip (setuptools) |
|
|
| Линтер/форматтер | ruff |
|
|
|
|
## 3. Архитектура
|
|
|
|
```
|
|
cashflow_model/ # Модели данных (dataclass + JSON)
|
|
engine/ # Вычислительное ядро (forecast + scenarios)
|
|
sync/ # Excel import/export
|
|
ai/ # AI-ассистент (заглушка)
|
|
cli/ # CLI (Typer)
|
|
tests/ # pytest
|
|
data/ # JSON-модели
|
|
exports/ # Экспортированные .xlsx
|
|
```
|
|
|
|
**Паттерн:** Модульный монолит
|
|
|
|
**Ключевые модули:**
|
|
|
|
| Модуль | Описание |
|
|
|---|---|
|
|
| cashflow_model | Модели данных: Account, Transaction, RecurringCashflow, Asset, Liability, ForecastScenario, FinancialModel |
|
|
| engine | Вычислительное ядро: ForecastService (прогноз), ScenarioService (сценарии + what-if) |
|
|
| sync | ExcelSync — импорт/экспорт .xlsx |
|
|
| ai | AssistantService — генерация промптов (заглушка) |
|
|
| cli | Typer CLI — 8 команд |
|
|
|
|
## 4. Конвенции
|
|
|
|
- **Стиль:** 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. Примечания
|
|
|
|
Проект полностью функционален: 26 тестов проходят, линтер чист. Требуется только обновление MetaAgent-артефактов до v1.1.0.
|