diff --git a/ops/STATUS.md b/ops/STATUS.md index e0ca74c..14da7e9 100644 --- a/ops/STATUS.md +++ b/ops/STATUS.md @@ -50,6 +50,7 @@ | S-10 | Настроить 2FA заново (TOTP или код в Matrix) | ⏳ | следующий спринт; сейчас отключена (`ops/auth/2FA-TEMP-OFF.md`) | | S-11 | Vikunja: задачи и дела | ✅ | CT110:9285, OIDC Authentik, бэкап `ct/vikunja-db.tgz` | | S-12 | Mealie → Grocy: рецепт в покупки | ✅ | `!рецепт`, `ops/home/MEALIE-GROCY.md` | +| S-13 | Paperless → Firefly: чек в расход | ⏳ | план в `ops/money/PAPERLESS-FIREFLY.md`; нужны документы | ## X. Инфраструктура | # | Задача | Статус | Артефакт | diff --git a/ops/money/PAPERLESS-FIREFLY.md b/ops/money/PAPERLESS-FIREFLY.md new file mode 100644 index 0000000..c92d2f9 --- /dev/null +++ b/ops/money/PAPERLESS-FIREFLY.md @@ -0,0 +1,38 @@ +# 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`.