# Task Manifest

**Session:** metaagent-001
**Goal:** Спроектируй и реализуй MVP по README
**Date:** 2026-07-12T12:00:00Z

---

## Task Overview

| ID | Title | Type | Depends On | Status |
|---|---|---|---|---|
| T1 | Инициализация проекта и зависимостей | config | — | pending |
| T2 | Модель данных (dataclass + JSON serialization) | feature | T1 | pending |
| T3 | Forecast Engine (базовый прогноз) | feature | T2 | pending |
| T4 | Scenario Analysis | feature | T3 | pending |
| T5 | Excel Sync (import/export) | feature | T2 | pending |
| T6 | CLI (Typer) — все команды | feature | T2, T3, T4, T5, T7 | pending |
| T7 | AI Assistant (промпты + интерфейс) | feature | T3 | pending |
| T8 | Тесты на все модули | test | T2, T3, T4, T5, T6, T7 | pending |

**Total tasks:** 8

---

## Task Details

### T1: Инициализация проекта и зависимостей

**Type:** config
**Description:** Создать структуру директорий, pyproject.toml, venv, установить зависимости (openpyxl, typer, pytest, ruff), настроить ruff

**Files:**
- `pyproject.toml`
- `cashflow_model/__init__.py`
- `sync/__init__.py`
- `engine/__init__.py`
- `ai/__init__.py`
- `cli/__init__.py`
- `data/.gitkeep`
- `exports/.gitkeep`

**Depends on:** —

**Acceptance Criteria:**
- [ ] pyproject.toml создан с правильными зависимостями
- [ ] Все директории модулей созданы с __init__.py
- [ ] ruff lint проходит без ошибок на пустых модулях
- [ ] pytest запускается (0 tests, exit code 0)

**Context:** Стек: Python 3.11+, openpyxl, typer, pytest, ruff. Структура из design-report.md раздел 3.

---

### T2: Модель данных (dataclass + JSON serialization)

**Type:** feature
**Description:** Реализовать все сущности: Account, Transaction, RecurringCashflow, Asset, Liability, ForecastScenario, FinancialModel. Каждая — dataclass с методами to_dict/from_dict. FinancialModel — корневой объект с методами save/load JSON.

**Files:**
- `cashflow_model/__init__.py`
- `cashflow_model/account.py`
- `cashflow_model/transaction.py`
- `cashflow_model/recurring.py`
- `cashflow_model/asset.py`
- `cashflow_model/liability.py`
- `cashflow_model/scenario.py`
- `cashflow_model/model.py`

**Depends on:** T1

**Acceptance Criteria:**
- [ ] Все сущности — dataclass с правильными полями и типами
- [ ] FinancialModel корректно сохраняется и загружается из JSON
- [ ] Создание Account, Transaction, Asset, Liability через конструктор работает
- [ ] demo-скрипт создаёт модель с тестовыми данными

**Context:** Модели определены в design-report.md раздел 4. Использовать uuid4 для id.

---

### T3: Forecast Engine (базовый прогноз)

**Type:** feature
**Description:** Реализовать ForecastService с методами: forecast_cashflow (на N месяцев), apply_recurring (генерация recurring-транзакций), project_balance. Алгоритм: начальный баланс + доходы - расходы + изменения по активам/обязательствам.

**Files:**
- `engine/__init__.py`
- `engine/forecast.py`

**Depends on:** T2

**Acceptance Criteria:**
- [ ] forecast_cashflow(months=12) возвращает список помесячных балансов
- [ ] Регулярные платежи корректно проецируются на будущие периоды
- [ ] Активы учитываются с ростом (growth_rate)
- [ ] Обязательства учитываются с процентами и платежами

**Context:** Расчёт: balance_{t+1} = balance_t + income_t - expense_t + asset_growth_t - liability_change_t.

---

### T4: Scenario Analysis

**Type:** feature
**Description:** Реализовать ScenarioService с методами: сценарии (optimistic, pessimistic, baseline), what-if модификация параметров, сравнение результатов сценариев.

**Files:**
- `engine/__init__.py`
- `engine/scenarios.py`

**Depends on:** T3

**Acceptance Criteria:**
- [ ] Три предустановленных сценария (baseline, optimistic, pessimistic)
- [ ] What-if: изменение параметров (доход +10%, расход -5%)
- [ ] Сравнение сценариев возвращает сводку различий

**Context:** Сценарии меняют параметры модели перед прогнозом. Использовать copy модели для каждого сценария.

---

### T5: Excel Sync (import/export)

**Type:** feature
**Description:** Реализовать ExcelSync: чтение модели из .xlsx (листы: Accounts, Transactions, Assets, Liabilities, Recurring), запись результатов прогноза в новый .xlsx. Использовать openpyxl.

**Files:**
- `sync/__init__.py`
- `sync/excel_sync.py`

**Depends on:** T2

**Acceptance Criteria:**
- [ ] Импорт из Excel заполняет FinancialModel
- [ ] Экспорт FinancialModel в Excel создаёт корректный .xlsx
- [ ] Обработка ошибок при невалидном формате Excel

**Context:** Каждая сущность — отдельный лист. Заголовки колонок = поля dataclass.

---

### T6: CLI (Typer) — все команды

**Type:** feature
**Description:** Реализовать CLI через Typer с командами: init, import, export, forecast, scenario, analyze. Главный entry point — консольная команда 'cf'.

**Files:**
- `cli/__init__.py`
- `cli/main.py`
- `pyproject.toml`

**Depends on:** T2, T3, T4, T5, T7

**Acceptance Criteria:**
- [ ] Команда 'cf init' создаёт пустую модель и JSON
- [ ] Команда 'cf forecast --months 12' выводит таблицу прогноза
- [ ] Команда 'cf analyze' вызывает AI Assistant
- [ ] Команда 'cf import' и 'cf export' работают с Excel
- [ ] Команда 'cf scenario' применяет и выводит сценарий

**Context:** Typer entry point. Команды описаны в design-report раздел 5. rich для форматирования таблиц.

---

### T7: AI Assistant (промпты + интерфейс)

**Type:** feature
**Description:** Реализовать AssistantService: генерация промптов для AI на основе модели и прогноза, форматирование контекста (JSON-дамп модели + результаты forecast), заглушка для вызова AI API. Промпты на русском языке для анализа фин. состояния.

**Files:**
- `ai/__init__.py`
- `ai/prompts.py`
- `ai/assistant.py`

**Depends on:** T3

**Acceptance Criteria:**
- [ ] Промпт 'analyze' включает модель и прогноз в JSON
- [ ] Промпт 'advice' формирует запрос на финансовые рекомендации
- [ ] AssistantService возвращает структурированный ответ (заглушка)

**Context:** AI — заглушка для MVP. Промпты должны быть готовы для реального API.

---

### T8: Тесты на все модули

**Type:** test
**Description:** Написать pytest-тесты для cashflow_model (сериализация), engine (forecast + scenarios), sync (excel roundtrip), ai (prompts), cli (invocation).

**Files:**
- `tests/test_model.py`
- `tests/test_forecast.py`
- `tests/test_scenarios.py`
- `tests/test_excel_sync.py`
- `tests/test_cli.py`
- `tests/test_ai.py`
- `tests/conftest.py`

**Depends on:** T2, T3, T4, T5, T6, T7

**Acceptance Criteria:**
- [ ] pytest запускается и все тесты проходят
- [ ] Покрытие базовых сценариев для каждой сущности
- [ ] Roundtrip-тест Excel: export → import → compare
- [ ] Forecast-тест: известные входные данные → ожидаемый результат

**Context:** Использовать tmp_path для временных файлов. conftest.py с fixture для тестовой модели.