docs: refactor project docs and agents tasks

This commit is contained in:
vakabunga
2026-03-02 00:30:56 +03:00
parent 9551b93a09
commit 9d12702688
14 changed files with 1146 additions and 87 deletions

View File

@@ -24,7 +24,7 @@
## Задачи агента
1. Конвертация PDF → сырые строки
1 Конвертация PDF → сырые строки
- Использовать доступный инструмент (локальный ИИ/LLM API или библиотеку),
чтобы преобразовать PDF-выписку в структурированный текст/табличное представление:
@@ -32,7 +32,7 @@
- таблица операций (дата/время, сумма, комиссия, описание и т.п.).
- Корректно обрабатывать переносы строк в описании операции.
1. Маппинг полей в JSON 1.0
2 Маппинг полей в JSON 1.0
- Извлечь из заголовка:
- `accountNumber`,
@@ -45,19 +45,19 @@
- выделить `commission` (если в выписке отдельная колонка, иначе `0`);
- сформировать `description` как максимально близкое к тексту из выписки поле.
1. Нормализация сумм
3 Нормализация сумм
- Все суммы, которые приходят в формате `12345.67`, должны быть преобразованы в целое число копеек:
- `12345.67 → 1234567`.
- Важно избегать ошибок округления (использовать работу со строками, а не float).
1. Проверка целостности (по возможности)
4 Проверка целостности (по возможности)
- При наличии `openingBalance` и `closingBalance`:
- проверить, что `openingBalance + Σ(amountSigned) == closingBalance` (с допустимой погрешностью, если есть комиссии/особые операции);
- если проверка не проходит, вернуть предупреждение вместе с JSON (или отдельный отчёт).
1. Выходной результат
5 Выходной результат
- Агент должен возвращать один JSON-объект строго по схеме 1.0.
- Дополнительно может возвращаться диагностическая информация (лог), но она должна быть отделена от финального JSON.