Документація

Майстер запуску

Майстер запуску працює під час першого відкриття додатка. Він допоможе вам обрати режим використання, увімкнути функції ШІ, налаштувати шифрування та синхронізацію, а також переглянути наступні кроки — щоб додаток був налаштований саме під ваш спосіб використання.

Виберіть свій режим

Кроки налаштування

1. Виберіть мову та режим, який найкраще відповідає тому, як ви будете використовувати додаток — Personal Keeper, Inventory Pro або The Full Bleep.
2. На екрані AI Superpowers вирішіть, чи вмикати розпізнавання зображень (зробіть фото, і ШІ заповнить деталі елемента) та описи продажу (ШІ пише привабливі оголошення для маркетплейсу).
3. Налаштуйте зовнішній вигляд у розділі Make It Yours, увімкніть наскрізне шифрування в розділі Lock It Down? та активуйте синхронізацію між пристроями в розділі Your Data Lives Here.
4. Перегляньте підсумок You're all set! — швидкі посилання для додавання ключа API ШІ, налаштування Square та ввімкнення синхронізації — а потім натисніть Let's Go, щоб перейти на головну панель.

Примітка: Якщо ви увімкнете шифрування, майстер запустить коротку додаткову послідовність для створення пароля шифрування та збереження фрази для відновлення — зберігайте фразу для відновлення в безпечному місці, оскільки це єдиний спосіб відновити ваші дані, якщо ви забудете пароль. Будь-який вибір у майстрі можна змінити пізніше в розділі Налаштування.

Головна панель

Головний екран — ваш центральний хаб. Він показує всі ваші предмети, їхній статус прийняття/видачі та забезпечує швидкий доступ до всіх основних функцій через нижню панель навігації.

Нижня панель навігації

Додаток використовує нижню панель вкладок для навігації між основними розділами:

Управління предметами

Предмети — це основа Where The Bleep. Кожен предмет може мати фото, описи, категорії, метадані (серійні номери, ціна покупки, оціночна вартість, посилання на страхування) та призначене місцезнаходження.

Створення предмета

1. Натисніть кнопку + на головному екрані
2. Додайте назву та опис — або натисніть кнопку ШІ-камери, щоб зробити фото і дозволити ШІ згенерувати їх
3. Оберіть категорію зі списку
4. Призначте розташування, переглядаючи дерево локацій
5. За бажанням додайте фото, серійний номер, ціну покупки, оціночну вартість та інформацію про страхування
6. Увімкніть Облік запасів, якщо хочете відстежувати кількість
7. Натисніть Зберегти

Статуси предметів

Дії з предметами

Місцезнаходження

Локації організовані ієрархічно. Локації-контейнери (кімнати, будівлі, шафи) можуть містити інші контейнери або цільові місця. Цільові локації — це місця зберігання предметів: конкретна полиця, шухляда або коробка.

Функції місцезнаходжень

• Ланцюжки шляхів — наприклад, "Дім > Офіс > Стіл"
• Сонячна діаграма — інтерактивна візуалізація всього дерева місцезнаходжень
• QR-етикетки — створюйте налаштовувані етикетки з QR-кодами для будь-якого цільового розташування у двох форматах шаблонів Avery
• Кількість предметів — перегляньте, скільки предметів зберігається в кожному місці
• Друк у PDF — експортуйте аркуші з етикетками QR-кодів у PDF, який можна друкувати на стандартному папері для етикеток
• Вибірковий повторний друк — друкуйте лише ненадруковані етикетки, передруковуйте одну етикетку або друкуйте всі етикетки одразу
• Пошук — повнотекстовий та голосовий пошук для переходу до будь-якого розташування за назвою або за тим, що зберігається всередині

Управління місцезнаходженнями

QR-коди та мітки

Кожна цільова локація може мати QR-код. Сканування QR-мітки миттєво відкриває локацію, щоб ви могли повернути предмети. Мітки використовують URI-схему belongings://loc/{uuid}.

Процес роботи з QR-мітками

1. Перейдіть до цільової локації
2. Натисніть іконку QR-коду, щоб створити мітку
3. Друкуйте окремі мітки або використовуйте Масовий експорт у PDF, щоб надрукувати багато одразу
4. Прикріпіть мітку на фізичну локацію (полицю, коробку, шухляду)
5. Щоб зареєструвати предмет, скануйте QR-код камерою в додатку

Відстеження статусу QR

Параметри друку

• Формат етикетки — виберіть Avery 5160 (1 × 2-5/8") або більший шаблон 2 × 4", у вертикальному чи горизонтальному макеті
• Налаштування етикетки — незалежні повзунки розміру для назви місця та коду ідентифікатора, а також перемикач для показу або приховування шляху навігації
• Зміщення верхнього поля — налаштуйте, де починається друк, щоб частково використані аркуші етикеток вирівнювалися правильно
• Включити номер штрихкоду — друкуйте необроблений ідентифікатор під кожним QR для ручного введення, коли сканування недоступне
• Лише очікувані повторні друки — пропустіть уже надруковані етикетки в масовому запуску, щоб не витрачати аркуші
• Зберегти як PDF — попередньо перегляньте повний аркуш на екрані перед відправкою на принтер

Використовуйте перемикач «Було надруковано», щоб передрукувати окремі мітки без масового повторного друку.

Пошук і голос

Пошук працює на базі SQLite FTS5 для блискавичного повнотекстового пошуку за назвами предметів, описами та тегами. Голосовий пошук використовує розпізнавання мовлення на пристрої.

Функції пошуку

• Повнотекстовий пошук — знаходить збіги за назвами, описами та тегами
• Префіксний пошук — почніть вводити, і результати з'являться миттєво
• Голосовий пошук — торкніться значка мікрофона та промовте свій запит
• Фільтр за місцезнаходженням — звузьте результати до конкретної кімнати або зони
• Фільтр за категорією — показувати лише предмети з певної категорії
• Фільтр за статусом — на зберіганні, видано, виставлено на продаж тощо
• Голос у кожному полі — мікрофон працює в полях Назва та Опис товару, примітках до оголошення, ціні запиту, іменах для Реєстрації / Виписки, а також у будь-якому іншому текстовому полі додатка
• Пошук всередині локацій — голосовий або текстовий пошук над деревом локацій, щоб перейти до кімнати, шухляди чи контейнера за назвою

Люди та позики

Керуйте списком осіб, які можуть брати ваші речі в борг. Застосунок має дві окремі дії: <strong>Видати</strong> забирає предмет з його місця, тоді як <strong>Позичити</strong> призначає його конкретній особі. Застосунок показує видані та позичені предмети окремо, щоб ви завжди знали, де що знаходиться.

Процес видачі та позики

1. На екрані деталей предмета натисніть Видати, щоб забрати предмет з його місця, або натисніть Позичити, щоб призначити його певній особі
2. Для дії Позичити оберіть особу зі своїх контактів або створіть нову
3. Статус предмета змінюється на Забрано або Видано з відображенням імені особи
4. Щоб повернути, натисніть Прийняти — предмет повертається до статусу На зберіганні

Керування людьми

Історія подій

Кожне приймання, видача та позика фіксуються з часовими мітками. Переглядайте історію на екрані деталей предмета.

Облік запасів

За бажанням увімкніть облік кількості для будь-якого предмета — незалежно від прийняття/видачі. Відстежуйте кількість витратних матеріалів, запасів або будь-чого, що ви зберігаєте в кількох одиницях.

Як це працює

1. Під час створення або редагування предмета увімкніть Облік запасів
2. Встановіть початкову кількість
3. На екрані деталей предмета використовуйте кнопки + та - для зміни кількості
4. Натисніть на число, щоб вручну встановити конкретну кількість
5. Усі зміни реєструються з мітками часу в історії запасів

Звіти запасів

Натисніть іконку звіту поруч із перемикачем запасів, щоб створити інвентарний звіт PDF. Звіт містить мініатюру предмета, поточну кількість та повну таблицю історії змін. Збережіть або поділіться PDF через системне меню поширення.

Сканування штрихкоду

Торкніться зеленої іконки QR на вкладці «Інвентар», щоб відкрити Сканування інвентарю — сканер з живою камерою з двома вкладками для коригування запасів: Приймання для товарів, що надходять, і Вручну для встановлення точної кількості. Витрата запасів обробляється скануванням Продажі в POS, описаним у розділі Square POS.

Низький запас і відсутність товару

Установіть Точку повторного замовлення для будь-якого відстежуваного товару. Вкладка «Інвентар» показує помаранчевий значок Низький запас, коли наявна кількість є на цій точці або нижче, і червоний значок Немає в наявності, коли кількість сягає нуля. Підсумкова плитка панелі та картка сповіщення на головному екрані відображають кількість, тож ви помічаєте нестачу без пошуку, а фільтри Низький запас і Немає в наявності звужують список лише до відповідних товарів.

Облік запасів

Відкрийте Облік з меню ⋮, виберіть місце призначення та пройдіться по кожному відстежуваному товару в цьому місці, ввівши фактичну кількість, яку ви бачите на полиці. Екран показує очікувану кількість поряд із вашим записом із зеленою або червоною стрілкою, що вказує на розбіжність. Збережіть, і додаток зафіксує лише ті товари, які змінилися, з опціональною причиною та приміткою до кожного коригування.

Імпорт CSV

У меню ⋮ виберіть Імпорт з CSV та виберіть файл із двома стовпцями — barcode_or_name і quantity. Числові значення довжиною 8–14 цифр розглядаються як штрихкоди; усе інше нечітко зіставляється з назвами товарів. Перший рядок автоматично визначається як заголовок. Імпорт реєструється як коригування імпорту CSV, тож ви можете відстежити будь-яку зміну до файлу.

Облік пошкоджень і втрат

Коли облік товарів виявляє нестачу, позначте розбіжність причиною — Пошкоджено, Помилка обліку, Застаріле, Псування, Крадіжка або Інше. Причини передаються у два звіти в меню ⋮: Розбіжності (необроблений список усіх коригувань) і Звіт про збитки (підсумки, згруповані за причиною та діапазоном дат), обидва експортуються в PDF для страхування або огляду наприкінці періоду.

Панель інвентарю

Вкладка Інвентар — головний центр для всього, що стосується запасів: підсумкові картки для Відстежувані товари, Загальна кількість одиниць і Низький запас; фільтри Усі, Низький запас і Немає в наявності; повнотекстовий і голосовий пошук; плаваюча кнопка сканування QR; ярлик принтера; і меню ⋮, що відкриває Облік, переміщення, імпорт CSV і чотири вбудовані звіти — Рівень запасів, Рух, Оцінка та Збитки.

Square POS

Where The Bleep має вбудовану точку продажу на вкладці Продаж — кошик із керуванням сканером штрих-кодів, який передає платежі картою до Square. Ви також можете приймати готівку з вбудованим розрахунком решти або зафіксувати продаж, оплачений через інший канал. Кожна сесія каси відкривається з Підсумком за сьогодні (Продажі, Повернення, Чистий результат) та списком останніх транзакцій, які можна повторно роздрукувати чи повернути кошти.

Способи оплати

Робочий процес оформлення

1. На вкладці Продаж натисніть зелену кнопку QR-сканера, щоб відкрити сканер POS
2. Відскануйте штрих-код (або виберіть зі списку пошуку), щоб додати товар до кошика — кількість за замовчуванням дорівнює 1 і її можна змінити у вікні Додати до кошика
3. Натисніть Сплатити на панелі кошика, щоб відкрити Оформлення замовлення, де ви обираєте спосіб оплати та підтверджуєте суму
4. Для зчитувача карток і ручного введення картки додаток передає платіж до Square; для готівки введіть прийняту суму, і додаток обчислить решту
5. Після завершення продажу з'являється екран чека для клієнта — клієнт може за бажанням ввести електронну адресу, щоб отримати чек обраною мовою

Офлайн-режим POS

Коли додаток втрачає інтернет, точка продажу продовжує працювати для платежів поза Square і ставить у чергу все, що потребує синхронізації з сервером.

• Готівкові та зовнішні продажі повністю працюють офлайн — мережа не потрібна
• Коригування інвентарю від продажів через POS записуються локально та синхронізуються з іншими пристроями одразу після відновлення з'єднання
• Електронні чеки ставляться у локальну чергу та надсилаються автоматично, щойно мережа повернеться; екран подяки клієнту все одно показується одразу

Примітка: Платежі через зчитувач карток і ручне введення картки потребують активного інтернет-з'єднання під час списання — Square має авторизувати картку. Якщо мережа зникає під час оформлення, перейдіть на готівку або зовнішню оплату, прийміть платіж іншим способом і зафіксуйте продаж, щоб ваш інвентар і звітність залишалися точними.

Продавці та оператори

Додайте продавців (операторів), щоб у точці продажу могло працювати кілька осіб і кожна транзакція була приписана тому, хто її пробив. Оператори входять за іменем і необов'язковим PIN-кодом, отримують лише ті дозволи, які ви їм надаєте, і ви можете будь-коли повернутися до облікового запису адміністратора за допомогою свого пароля шифрування.

Додавання продавця

1. Відкрийте Налаштування > Продажі > Продавці та натисніть Додати продавця (або кнопку + у списку продавців)
2. Введіть ім'я та необов'язковий 6-значний PIN-код — без PIN-коду профіль відкритий і ним може користуватися будь-хто, що підходить для однієї довіреної точки, але не для жвавого торгового залу
3. Увімкніть дозволи, які бажаєте надати — доступ до інвентарю, доступ до звітів та необов'язкове встановлення терміну дії для тимчасового доступу
4. За бажанням оберіть локацію продажу за замовчуванням, щоб продажі через POS оператора автоматично зменшували запаси у потрібному місці

Рівні дозволів

Тимчасовий доступ

Увімкніть встановлення терміну дії під час додавання чи редагування продавця та виберіть дату. Після цієї дати їхні дозволи автоматично скасовуються, а на екрані входу оператора показується чітке повідомлення про закінчення терміну — зручно для сезонного персоналу, підрядників або будь-кого, кому потрібно надати лише тимчасовий доступ.

Позначення подій та журнал аудиту

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

Примітка: Перехід із сесії оператора назад до адміністратора потребує пароля шифрування (або розблокування пристрою, якщо шифрування вимкнене). Це не дозволить оператору, що увійшов у систему, змінювати налаштування, видаляти інших операторів або переглядати звіти каси, які йому не призначені.

Продаж і оголошення на маркетплейсах

Виставляйте предмети на продаж на 7 підтримуваних маркетплейсах. ШІ генерує деталі оголошення з даних вашого предмета, а додаток створює PDF-аркуші продажу, на які можна посилатися під час публікації.

Підтримувані маркетплейси

Процес створення оголошення

1. Перейдіть на вкладку Продаж і натисніть Нове оголошення
2. Оберіть предмет із засобу пошуку предметів
3. Виберіть маркетплейс
4. ШІ автоматично заповнює поля оголошення: назву, ціну, категорію, стан та опис
5. Кожен маркетплейс має власні додаткові поля (наприклад, eBay: бренд, UPC, доставка; Poshmark: відділ, розмір)
6. Перегляньте та відредагуйте все на екрані перевірки
7. Згенеруйте PDF-аркуш продажу — містить фото предмета, всі деталі оголошення та QR-код із посиланням на сторінку створення оголошення на маркетплейсі
8. Збережіть у Завантаження або Поділіться через AirDrop, електронну пошту чи месенджер

Відстеження продажів

Товари проходять через статуси оголошень: Виставлено на продаж → Продано — не доставлено → Доставлено. Панель продажів показує активні оголошення (включно з проданими, але не доставленими товарами), повну історію продажів та зведену статистику з даними покупців, цінами, комісіями та чистим прибутком. Генеруйте звіти про продажі у форматі PDF або CSV за будь-який період.

Інтеграція Square для продажів

Окрім прийому особистих карткових платежів у касі, інтеграція зі Square також забезпечує роботу Електронних чеків — коли підключена активна підписка Square на електронні чеки, чеки, звернені до клієнта, можуть надсилатися мовою, обраною покупцем, безпосередньо з екрана подяки в касі. Авторизуйте Square один раз у Налаштування > Продажі > Платежі Square, і як карткові платежі, так і електронні чеки використовуватимуть одне й те саме з'єднання.

Чеки

Кожен продаж у касі завершується екраном Дякуємо, зверненим до клієнта, з позиціями товарів, загальною сумою, способом оплати та (для готівки) сумою решти. Клієнт може за бажанням ввести свою електронну пошту, щоб отримати чек обраною мовою, а ви можете повторно роздрукувати або повернути будь-який минулий продаж зі списку Останні транзакції.

Можливості чеків

• Багатомовність — чеки автоматично перекладаються на обрану клієнтом мову в момент продажу (підтримується 18 мов)
• Два канали доставки — екран, звернений до клієнта, який покупець читає на вашому пристрої, та опціональний електронний чек, надісланий на його адресу
• Повторний друк за вимогою — кожна транзакція в розділі Останні транзакції відкриває повну сторінку деталей чека, яку можна повторно надіслати, зберегти у форматі PDF або повернути
• Облік готівкової решти — для готівкових продажів чек фіксує отриману суму та видану решту, тож аудиторський слід є однозначним

Робочий процес чеків

1. Завершіть продаж у касі — екран чека, звернений до клієнта, з'являється автоматично з підсумками та вибором мови
2. Передайте пристрій клієнту; на екрані використовується більший шрифт і вибір мови, щоб він міг зручно його читати та змінювати мови на льоту
3. Якщо клієнт хоче отримати копію електронною поштою, він вводить свою адресу та натискає Надіслати чек — електронний лист ставиться в чергу обраною мовою
4. Натисніть Готово, щоб повернутися до сканера каси, готового до наступного продажу

Налаштування чеків

Брендинг чеків береться з Налаштування > Продажі > Інформація про бізнес — назва вашого бізнесу, адреса, телефон, електронна пошта, ідентифікаційний номер платника податків і поштовий індекс відображаються вгорі. Налаштуйте відправника електронної пошти в Налаштування > Продажі > Параметри електронної пошти: оберіть вбудовану поштову службу Where The Bleep (потрібна підписка) або власний сервер Custom SMTP, щоб чеки надходили з вашого власного домену.

Примітка: Електронні чеки потребують підключення до інтернету в момент відправлення, але вони ставляться в чергу локально, якщо ви офлайн, і відправляються одразу після відновлення мережі. Екран подяки, звернений до клієнта, завжди відображається миттєво — як онлайн, так і офлайн.

Шифрування та безпека

Where The Bleep використовує наскрізне шифрування з нульовим знанням. Ваші дані шифруються на пристрої ще до потрапляння в хмару. Ми не можемо прочитати ваші дані — тільки ви маєте доступ.

Деталі шифрування

Ієрархія ключів

Ваш пароль генерує Майстер-ключ (256 біт) через PBKDF2-HMAC-SHA256 (600 тис. ітерацій). З майстер-ключа виводяться три підключі:

• DEK (Data Encryption Key) — шифрує поля предметів, назви, описи
• FEK (File Encryption Key) — шифрує зображення та документи фрагментами по 64 КБ
• SIK (Search Index Key) — створює сліпі індекси для серверних запитів

Параметри розблокування

Захист від перебору паролів

Невдалі спроби введення пароля викликають блокування з експоненційною затримкою: 30 секунд → 5 хвилин → 15 хвилин → 1 година.

Двофакторна автентифікація

Поєднайте застосунок-автентифікатор зі своїм обліковим записом для додаткового рівня захисту понад пароль. Налаштуйте це в Налаштування > Безпека > Двофакторна автентифікація — підійде будь-який застосунок, сумісний з TOTP (Google Authenticator, Authy, 1Password, Microsoft Authenticator). Після поєднання вхід на новому пристрої вимагатиме як вашого пароля, так і свіжого 6-значного коду із застосунку.

Безпека мережі

• Моніторинг прозорості сертифікатів — відстеження TLS-сертифікатів за принципом TOFU для кожної кінцевої точки API
• Виявлення зміни сертифіката — сповіщення при неочікуваній зміні відбитка сертифіката
• Блокування незашифрованого трафіку на Android — жодних незашифрованих HTTP-з'єднань
• Екран моніторингу сертифікатів — переглядайте видавця сертифіката, термін дії, відбиток і історію змін для кожної кінцевої точки (Налаштування > Безпека > Моніторинг сертифікатів)

Хмарна синхронізація

Where The Bleep працює офлайн-першочергово — повністю функціонує без інтернету. Хмарна синхронізація є додатковою опцією для підписників Pro.

Як працює синхронізація

• Усі дані зберігаються локально в SQLite — додаток ніколи не потребує інтернету
• webDocsSyncFeature2
• Дані шифруються перед відправленням з вашого пристрою — сервер бачить лише зашифровані стовпці
• Виявлення конфліктів — на рівні рядків перемагає останній запис, конфлікти фіксуються в журналі подій
• Поширення видалення — видалення на Пристрої A видаляє елемент на Пристрої B
• Ізоляція на рівні користувача — безпека на рівні рядків гарантує, що ви бачите лише свої дані
• Оголошення та продажі на маркетплейсах включені в синхронізацію із зашифрованою персональною інформацією покупців

Резервне копіювання та відновлення

Експортуйте всю базу даних та зображення як зашифрований архів резервної копії. Встановіть пароль резервного копіювання під час експорту та використовуйте його для відновлення на будь-якому пристрої.

Вміст резервної копії

• Повна база даних SQLite
• Усі зображення предметів
• Шифрування AES-256-GCM з паролем резервного копіювання, встановленим користувачем (ключ на основі PBKDF2)
• JSON-маніфест для перевірки цілісності архіву

Процес відновлення

1. Перейдіть до Налаштування > Резервне копіювання та відновлення
2. Натисніть Імпортувати резервну копію
3. Виберіть файл резервної копії за допомогою засобу вибору файлів
4. Введіть пароль резервного копіювання, який ви встановили при створенні резервної копії
5. Ваші дані та зображення відновлено

Експорт даних і звіти

Експортуйте дані вашого інвентарю в різних форматах для страхових випадків, особистих записів або перенесення даних.

Формати експорту

Описи на основі ШІ

Зробіть фото, і ШІ згенерує назву, опис та теги для вашого предмета. Та сама можливість ШІ використовується для створення оголошень на маркетплейсі. Ви використовуєте власний API-ключ від будь-якого з 8 підтримуваних провайдерів.

Підтримувані провайдери ШІ

Налаштування

1. Перейдіть до Налаштування > Постачальник ШІ
2. Виберіть бажаного провайдера
3. Введіть свій API-ключ
4. За бажанням змініть модель за замовчуванням
5. Під час додавання або редагування предметів натисніть кнопку ШІ-камери, щоб скористатися цією функцією

Примітка: Ваш API-ключ зберігається лише на пристрої і ніколи не надсилається на наші сервери. Запити до ШІ йдуть безпосередньо з вашого пристрою до провайдера.

Налаштування

Екран налаштувань — це ваш центр керування шифруванням, синхронізацією, конфігурацією ШІ, експортом даних та управлінням обліковим записом.

Розділи налаштувань

Підписки

Where The Bleep пропонує щедрий безкоштовний план з усіма основними функціями. Pro відкриває хмарну синхронізацію, автоматичне резервне копіювання та пріоритетну підтримку.

Тарифні плани

Підписки керуються через App Store (iOS) або Google Play (Android). Ви можете скасувати будь-коли в налаштуваннях підписок вашого пристрою.

What's Included with Pro

• Ведіть справжній бізнес — Square POS з оплатою карткою через зчитувач та ручним введенням картки, продавці з PIN-кодами та індивідуальними дозволами для кожного оператора, чеки електронною поштою 18 мовами, лістинг на eBay і чотири вбудовані звіти про інвентар (Залишки, Рух, Оцінка вартості, Втрати)
• Залучіть свою команду — оберіть тариф на 5, 10 або 20 пристроїв, щоб ваші продавці, працівники кухні чи співвласники могли працювати кожен зі свого пристрою з власним обліковим записом
• Працює без Wi-Fi — усі екрани залишаються доступними у разі відсутності мережі, включно з продажами за готівку, коригуваннями інвентарю та інвентаризаціями; усе ставиться в чергу та синхронізується, щойно ви знову вийдете на зв’язок
• Зашифрована хмарна синхронізація та автоматичне резервне копіювання — ваші дані наскрізно шифруються на пристрої, реплікуються на всі підключені пристрої за лічені секунди та постійно резервуються в хмару, тож ви можете відновити їх, навіть якщо всі пристрої зникнуть