Сімейний документний хаб з толерантністю до помилок за допомогою FastAPI та Meilisearch

Кожна родина накопичує одну й ту саму розкидану купу: інструкцію до котла, рецепт, який хтось зробив скріншотом, посилання на шкільний портал, PDF з гарантією. start.khanoff.com — моя спроба розмістити все це за одним простим пошуковим вікном для всієї родини.

Стек технологій

• FastAPI + Jinja2/HTMX — сторінки, відрендерені на сервері з достатньою інтерактивністю, без SPA. Швидко завантажується на телефоні, просто розуміти.
• PostgreSQL для даних.
• Meilisearch для пошуку — і тут головне: він толерант до орфографічних помилок. Члени сім'ї не пам'ятають точні назви файлів; вони вводять приблизно те, що мають на увазі, і потрібний документ все одно виринає.
• Immich обробляє медіа (фото та відео) замість того, щоб винаходити сховище для медіа.
• Вхід за магічним посиланням через сімейний поштовий сервер (poste.io) — не треба запам'ятовувати паролі; ви просто клікаєте на посилання у своїй електронній пошті.
• Це PWA, тому його можна встановити на головний екран телефонів та комп'ютерів.

Створено для людей, а не для адміністраторів

Усе це зібрано власником і працює в кількох контейнерах Docker за проксі nginx. Але мета дизайну ніколи не була «чиста архітектура» заради краси — метою було те, щоб нетехнічний член сім'ї міг відкрити його, ввести частково пригадуване слово та знайти потрібну річ. Пошук, толерант до помилок, плюс теплий, простий інтерфейс робить більше для впровадження, ніж будь-яка кількість поліровки бекенду.

Та сама філософія, інша сфера застосування

Як і мої інші самохостингові інструменти, рухомі частини розташовані так, щоб повсякденний шлях був надзвичайно простим та стійким: пошук і перегляд завжди працюють, медіа зберігаються в системі, створеній для цього, а вхід займає один клік. Інтелект залишається поза увагою людини, яка просто намагається знайти пароль від WiFi.