Koillection: Організація фізичних медіаколекцій з Docker

Вступ до Koillection

Koillection — це відкрита утиліта, призначена для відстеження фізичних медіаколекцій. Вона дозволяє користувачам, які захоплюються збиранням, таким як CD-диски, комікси та ретро-ігри, організувати свої предмети. Додаток є самостійно розміщуваним (self-hosted) і працює як Docker-додаток.

Встановлення та налаштування за допомогою Docker

Для запуску Koillection використовується Docker, що забезпечує ізоляцію, налаштування та контроль. Автор матеріалу застосував Docker Compose, оскільки це зручний метод, рекомендований розробником. Встановлення вимагає файлу Docker Compose, детальні інструкції для якого доступні на GitHub. Також потрібен файл середовища (ENV), який слід назвати .env, інакше Koillection не завантажиться належним чином. Після налаштування файлів YAML та ENV, Koillection запускається командою docker compose up -d і стає доступним через браузер за вказаним портом localhost.

Ведення колекції

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

Автор почав каталогізацію зі своєї колекції коміксів, створивши колекцію під назвою «Totally Rad Comics & Graphic Novels». Він ввів назви предметів, скопіювавши їх з текстового файлу, що зайняло менше семи хвилин.

Імпорт зображень та обмеження

Одним із значних недоліків Koillection є відсутність функції імпорту (HTML, TXT, CSV), що підтверджено розробником на GitHub. Проте, експорт CSV-файлів доступний через налаштування інструментів. Для імпорту зображень автор використав скрепер Amazon, завантаживши JSON-файл скрепера та потім зібравши зображення для кожного елемента. Альтернативний варіант — завантажувати та додавати зображення вручну. Автор також експериментував з реалізаціями API Koillection, але вони не працювали належним чином на його машині.

Цінність Koillection

Koillection пропонує всі необхідні функції, постійний онлайн/офлайн дім для списків та інтерактивний інтерфейс відстеження. Його цінність полягає в тому, як він перетворює просту полицю з CD-дисками, книгами чи DVD-дисками на інтерактивний архів. Це самостійно розміщений, приватний простір для справжньої оцінки колекцій, призначений для вдумливої та цілеспрямованої роботи, а не для швидкого вирішення.

Що це означає для розробників

Розробники можуть знайти Koillection цікавим як приклад відкритого Docker-додатку, що використовує Docker Compose для розгортання. Важливо врахувати, що додаток перебуває в активній розробці, і деякі функції, такі як імпорт даних, ще не реалізовані, що може вплинути на інтеграцію з іншими системами. Також згадуються API-інтерфейси, які можуть бути предметом подальшого вивчення для розробників.

Ключові факти

Koillection — це відкрита утиліта для відстеження фізичних медіаколекцій.
Додаток є самостійно розміщуваним (self-hosted) і працює як Docker-додаток.
Встановлення здійснюється за допомогою Docker Compose, використовуючи файли YAML та ENV (останній має бути названий .env).
Дозволяє створювати колекції, списки бажань, додавати теги та відстежувати позичені предмети.
Не має функції імпорту даних (HTML, TXT, CSV), але підтримує експорт CSV.