Dmitry
220f027652
AGENTS.md — индекс, команды и обязательные ограничения (Decimal для денег, не конвертировать валюту на записи, SDK T-Invest ровно в одном модуле, аналитика читает только confirmed). docs/ai/ — архитектура, соглашения, эксплуатация и полный план на шесть фаз с проверками для каждой.
2.3 KiB
2.3 KiB
Соглашения
Деньги и валюты
- Все суммы и количества —
Decimal; в БДNUMERIC(24,10); в JSON — строки. - Рядом с суммой всегда колонка валюты (
amount+currency,fee+fee_currency). - Хранить в нативной валюте, не конвертировать на записи.
- Конвертация — в аналитике по
fx_rate_dailyна дату операции; курсы ЦБ протянуты через выходные (is_carried = true); RUB→RUB = 1.0 на любую дату; нет курса → NULL + запись вmetric_data_quality. - Float допустим только внутри расчётов, результат которых — коэффициент (XIRR, TWR, beta).
Идемпотентность и источники
raw_*— append-only, upsert по стабильному id источника; повторный синк ничего не дублирует.- Каждая core-строка знает
sourceиsource_id. event.dedupe_keyUNIQUE: номер сделки, если брокер его даёт, иначе fingerprint.- У счёта один
primary_event_source; события других источников —status = shadow.
Время
- Торговые даты (
trade_date) — в MSK; T-Invest отдаёт UTC, конвертируем до вывода даты. - Все
timestamp—timestamptz.
Код
- Python 3.12, типизация обязательна (pyright
standard), ruff (E F I UP B SIM RUF). - Async везде, где есть I/O; SQLAlchemy 2.0 style (
Mapped,select()). - Один модуль импортирует SDK T-Invest:
sources/tinvest/client.py. - Парсеры отчётов — чистые функции
bytes -> ParsedReport, без БД. - Тесты: pytest + pytest-asyncio, Postgres поднимается фикстурой; golden-числа для финансовой математики.
- Комментарии и docstrings — по-английски (кириллица допустима в пользовательских строках), документация для людей и агентов — по-русски.