Files
buryan-infra/ops/money/PAPERLESS-FIREFLY.md
T

39 lines
2.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Paperless → Firefly: чек в расход
## Статус: подготовлено, ждёт документов
| Часть | Состояние |
|---|---|
| Токен Paperless | ✅ создан (`/root/.paperless-token`) |
| Firefly | ✅ работает (`http://192.168.1.110:8080`) |
| Пользователь Firefly | `maloyakapg@gmail.com` (id 1) |
| Документы в Paperless | **0** — обрабатывать нечего |
## Почему остановились
Paperless пуст: ни одного чека/документа. Интеграция «чек → расход» имеет
смысл только когда есть что разбирать. Создавать фиктивные документы ради
теста — шум в архиве.
## План, когда появятся чеки
1. Скрипт читает `/api/documents/?tags=чек` из Paperless.
2. Из OCR-текста извлекается итоговая сумма (regex по «ИТОГО», «К оплате»).
3. Создаётся withdrawal в Firefly:
`POST /api/v1/transactions` с типом `withdrawal`, суммой и описанием.
4. Отметка в Paperless (tag `в бюджете`), чтобы не задваивать.
## Что понадобится
- Firefly personal access token (Profile → OAuth → Create token).
- Счёт-источник и категория расходов (id из `/api/v1/accounts`).
- Правило в Paperless: тег или correspondent для чеков.
## Ловушки
1. `pg_dumpall`-дампы не годятся для черновой базы — нужен дамп одной БД
(уже знаем по учениям восстановления).
2. Firefly не имеет `artisan tinker` — пользователей смотрим в БД
(`firefly_db.users`).
3. Paperless-контейнер называется `paperless`, не `paperless-ngx`.