Paperless-ngx

Якщо ви ведете ваші Документи у Paperless-ngx, Kept може прив’язати річ до її документів там замість того, щоб ви завантажували їх двічі. Дриль показує свій чек та інструкцію; кухня показує інвойс холодильника.

Опціонально: лише якщо ви вже запустили Paperless-ngx. Kept працює так само і без нього.

Перед початком

Вам потрібно	Чому
Paperless-ngx 2.16 або новіше	Kept запитує API версії 9 Paperless, яку додали у 2.16 і 3.x все ще подає
API-токен	У Paperless: Мій профіль, потім кругла стрілочка біля API-токена. Kept бачить те, що бачить користувач Paperless, тому користувач, хто може лише переглядати ваші документи, достатній
Kept може досягнути Paperless	З машини, де працює Kept, а не з вашого телефону
`https`, або ваша власна мережа	Через простий `http` токен летить нешифрованим, тому Kept приймає `http` лише для адреси у вашій власній мережі. Така адреса потребує Адміністрування → Налаштування → Дозволити приватні адреси (вихідні запити)

Під’єднати

Власник або адміністратор локації:

Налаштування локації → Paperless.
Адреса Paperless: адреса, за якою ви відкриваєте Paperless, наприклад https://paperless.example.com (шлях, як /paperless, теж підходить).
API-токен, потім Під’єднати. Kept спочатку входить і каже, чому не може: відхилений токен, адреса, що не відповідає як Paperless, версія занадто стара.

Після підключення сторінка показує версію Paperless і скільки документів прив’язано. Перевірити з’єднання знову запитує Paperless. Щоб змінити токен, введіть новий і Зберегти; залиште порожнім, щоб зберегти збережений.

Прив’язати документи

На сторінці речі, під Документи, Прив’язане з Paperless сидить біля Додати файл (на сторінці місця, біля Додати документ). Це відкриває пошук вашого Paperless: слова з назви або тексту, кореспондент, тип або тег. Початок слова достатній: Camel знаходить “Camelot”. Власна синтаксис пошуку Paperless проходить крізь, як ви її вводите, наприклад title:manual або *amel* для середини слова. Позначте один або кілька і Прив’язати.

Прив’язані документи знаходяться в тому самому списку Документи, що й файли. Кожен показує свою мініатюру, назву, тип Paperless і кореспондента, і свою дату, з:

Різновид: Інструкція, Гарантія, Чек, Інвойс або Документ. Змініть, коли тип Paperless не каже, що це за документ.
Відкрити в Paperless: сторінка документа в Paperless, у новій вкладці.
Завантажити: документ, через Kept. Учасники і вище.
Скопіювати в Kept: дивіться нижче.
Відв’язати: він знімається з речі. Paperless його зберігає.

Різновид приходить з типу документа в Paperless, потім з його тегів: Чек, Інвойс, Інструкція та Гарантія (та ті самі слова іншими мовами Kept) розпізнаються, все інше — документ. Після цього різновид ваш, щоб змінювати, і Скопіювати в Kept копіює документ у цьому різновиді. Фільтр Різновид у Документах звужує файли і прив’язані документи разом.

З імпорту Homebox: посилання Homebox на один із ваших документів Paperless (…/documents/123, або API …/api/documents/123/download/) за адресою, до якої ця локація підключена, надходить як прив’язаний документ на річ або місце. Його назва приходить з Paperless, його різновид — з типу вкладення Homebox. Підключіть Paperless перед імпортом; будь-яке інше посилання залишається простим посиланням.

Kept запитує назви у Paperless, коли імпорт запускається, а не коли він перевіряє експорт. Якщо Paperless недосяжний, або не має документа, або не показує його своєму користувачу, імпорт все одно завершується, і це посилання зберігає назву Homebox, або його адресу, якщо Homebox не має назви. Звіт імпорту каже, скільки. Щоб отримати назву Paperless пізніше, Відв’язати документ і скористатися Прив’язане з Paperless, або Скопіювати в Kept.

Прив’язано чи скопійовано

	Прив’язано	Скопійовано в Kept
Що зберігає Kept	Номер документа в Paperless, його назва, різновид, тип, кореспондент і дата	Сам файл, як вкладення на речі
Якщо Paperless вниз	Назви все одно показуються, з нотаткою, що Paperless недосяжний	Нічого не змінюється
У резервних копіях та експортах Kept	Ні: посилання потребує цей сервер Paperless	Так, як будь-який інший файл
Якщо документ змінився в Paperless	Його назва оновлюється, коли ви його копіюєте	Копія залишається такою, яка була

Скопіювати в Kept — на документ і явне: використовуйте для того, що має вижити без Paperless, наприклад чек, який знадобиться для гарантійного претензійного заявлення. Копія — це файл, який Paperless видає на завантаження (його архівований PDF, коли він його зробив), перевірений і зрозмірений як завантаження.

Хто що може

	Переглядач	Учасник	Адмін, власник
Бачити прив’язані документи і мініатюри	✓	✓	✓
Шукати в Paperless, прив’язати, копіювати, завантажувати		✓	✓
Змінювати різновид, відв’язувати		Свої	Будь-які
Під’єднувати, змінювати, від’єднувати			✓

Чеки та інвойси — це гроші: де гроші приховані для вас у локації, прив’язані чеки та інвойси також приховані, і ви не можете зробити прив’язаний документ такими.

Персональний токен читає посилання речі чи місця (GET /api/v1/paperless-links?thingId=…), ніколи не з’єднання, пошук, мініатюру чи документ. Інструмент MCP get_thing перелічує прив’язані документи речі за назвою.

Приватність

Токен запечатаний секретним ключем Kept, як пароль поштової скриньки. Kept ніколи не показує його, не логує, не кладе в аудит чи експорт.
Ваш браузер ніколи не говорить з Paperless з токеном. Пошуки, мініатюри і завантаження йдуть через Kept, який перевіряє перше, чи можете ви бачити річ. Мініатюри перекодовуються Kept і зберігаються п’ять хвилин.
Відкрити в Paperless — звичайне посилання: ви входите в Paperless як ви самі.
Переміщення речі в іншу локацію знімає її посилання: вони називають документи в Paperless старої локації, які учасники нової локації можуть не бачити.

Від’єднати

Налаштування локації → Paperless → Від’єднати знімає з’єднання і кожне посилання на його документи. Документи, скопійовані в Kept, залишаються.

Ще не готове

Двостороння синхронізація: Kept нічого не змінює в Paperless.
Автоматичне співставлення чеків з речами.
Надсилання власних файлів Kept у Paperless.