Ваші перші хвилини

Ця сторінка починається, коли Kept уже запущено і ви можете відкрити його адресу. Встановлення описано в Встановлення за допомогою Docker Compose.

1. Отримайте сервер за допомогою коду налаштування

При першому запуску Kept без адміністратора він виводить у логах одноразовий код налаштування як KEPT SETUP CODE: K7Q-2M9. Відкриття адреси Keft веде вас до Налаштувати цей Kept, три кроки:

Код налаштування. Введіть шість символів. Тире необов’язкове, регістр не важливий. Код перестає працювати після використання. Загубили логи? kept admin setup-code видасть новий (як, під Compose).
Перший обліковий запис. Ваше ім’я, електронна пошта та пароль не менш ніж 8 символів. Цей обліковий запис — адміністратор сервера: він керує сервером (користувачі, реєстрація, резервні копії). Він не бачить нічого всередині чужої Головної, поки його не запросять.
Параметри сервера. Один перемикач: Дозволити будь-кому з адресою створювати обліковий запис. Залиште вимкненим для домогосподарства: люди приходять через запрошення, або ви додаєте їх самі. Змінити пізніше можна в Налаштування → Адміністрування.

Завершити налаштування веде на Головну.

ШІ та пошук штрихкодів не входять до налаштування. Kept працює без них, а ШІ-провайдера можна підключити пізніше (Провайдери ШІ).

2. Прочитайте Контрольний список початку роботи на Головній

Головна відкривається з Почати роботу, один рядок з прогресом та наступним кроком, розрахованим із того, що ви справді зробили, тому кроки відмічаються самі. Стрилка відкриває кроки:

Крок	Що просить
Переведіть Kept на HTTPS	Показується адміністратору сервера, поки Kept обслуговується по звичайному HTTP. Телефони блокують камеру, встановлення Kept, push-сповіщення та локацію по HTTP. Див. HTTPS.
Створіть свою першу Головну	Локація, нижче.
Додати 3 речі	Кілька речей, які шкода було б загубити з очей.
Надрукуйте свою першу етикетку	Коли Етикетки увімкнено в локації.
Запросити когось	Посилання або QR-код; електронна пошта не потрібна.
Підключити ШІ-провайдера	Не показується запрошеним учасникам, або в локації на пресеті Основне.
Встановити на телефон	Відзначається сам при першому відкритті Kept із іконки на головному екрані.

× приховує назавжди; Довідка → Контрольний список початку роботи → Показати знову повертає його. Воно зникає саме, коли всі кроки виконано. Більше про Головну в щоденне використання.

3. Створіть свою першу Головну

У кожного з початку є Особиста локація: вона тільки ваша (без учасників, запрошень чи посилань для спільного доступу) і туди потрапляє сканування без локації. Перейменуйте в Налаштування локації → Загальні, і Kept покаже нову назву всюди. Коли з’явиться інша локацію, її можна приховати в Налаштування → Я → Ваші локації. Спільні речі належать у власну локацію. Оберіть Створити свою першу Головну (або Нова локація на Головній):

Як називається це місце? Назва, наприклад Головна або Гараж, та її вид: Будівля, Квартира, Гараж, Склад, Офіс, Дача або Інше.
Кімнати. Шаблон виду заповнює кімнати та місця; перейменуйте, видаліть або Додати кімнату або місце. У кожної локації також є Без місця, для речей, які ще не мають місця. Пропустити залишає лише Без місця.
Що відстежувати. Три пресети:
- Основне: пошук речей: кімнати, коробки, етикетки та пошук.
- Домогосподарство: додає чеки та гарантії, нагадування, позичання, папери та транспорт.
- Повне: додає паливо, речі, що закінчуються, паролі та коди, переїзд, та “Підключити ChatGPT або Claude”.

Часовий пояс і валюта беруться з браузера. Змініть їх, увімкніть або вимкніть окремі модулі, в Налаштування локації локації (Загальні та Що відстежувати). Вимкнення модуля приховує його; нічого не видаляється.

4. Додайте свою першу річ

Найшвидший спосіб — Сканування, середня вкладка на телефоні: наведіть камеру, натисніть спуск, і річ збережеться там, де каже чіп місця зверху. Назва необов’язкова під час сканування: якщо підключено ШІ-провайдера, Kept назвє її за фото; без нього — безіменні речі чекають у Вхідних на назву. На комп’ютері Додати сюди на кімнаті або коробці додає річ формою. Щоденне використання охоплює сканування, етикетки та інше.

5. Запросіть людей

Спільний доступ дається по локації: кого запросите до Головної — бачить Головну, і нічого іншого вашого. Після створення локації Головна показує картку Запросити людей до …; та сама сторінка в Налаштування локації → Учасники → Запросити.

Оберіть Роль і, під Доступ, Немає дати завершення або До зазначеної дати. Їхній доступ, і будь-які їхні токени, зупиняються на тій даті.
Створити посилання для запрошення. Отримаєте посилання з Копіювати посилання та QR-код для Сканування їхнім телефоном. Посилання працює раз, 7 днів, і показується під Учасники як очікуване запрошення, поки не використано, де його можна відкликати.
Надіслати електронною поштою працює лише коли у сервера налаштовано пошту (KEPT_SMTP_URL).

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

Ролі

Роля	Що можуть у цій локації
Власник	Все, включаючи правила двофакторки, передачу та видалення. Власник один.
Адміністратор	Запрошувати й видаляти учасників і спостерігачів, налаштування й модулі, імпорт та експорт, посилання для спільного доступу та набори кодів, видаляти остаточно. Тільки власник дає або забирає адміністраторів.
Учасник	Додавати, редагувати, переміщувати, позичати й смітити речі; логувати покази та сервіси; друкувати етикетки; використовувати ШІ-сканування. Гроші видимі.
Спостерігач	Тільки дивитися і шукати. Гроші приховані, якщо локація не дозволяє спостерігачам бачити їх; помічник відповідає, але не може нічого змінювати.

Повна матриця — MATRIX у packages/shared/src/roles.ts.

Люди без електронної пошти

Для дитини або батька без пошти власник або адміністратор використовує Додати особу без електронної пошти на сторінці Учасники. Kept створює керований обліковий запис з іменем користувача та показує одноразовий код (працює раз, на 30 хвилин). Особа входить через У мене є одноразовий код, своє ім’я користувача та код, і обирає свій пароль; ви його ніколи не бачите. Хто створив обліковий запис (поки ще власник або адміністратор там), або власник цієї локації, пізніше може видати новий код — він вийде з облікового запису скрізь. Особа може додати пошту, щоб забрати обліковий запис до себе. Керований обліковий запис не може бути власником локації, і локація тримає не більше 20 таких.

6. Мова та тема

Налаштування → Я → Відображення містить параметри екрану пристрою, які застосовуються до малювання сторінки:

Мова: العربية, Deutsch, English, Español, Français, Italiano, Українська або Tiếng Việt. Відкрийте список, або напишіть, щоб знайти: власна назва, назва англійською або мовою, якою ви користуєтеся, і дрібні помилки — ок (german, deutsch і francais всі працюють). Арабська розкладає весь додаток справа наліво. Сторінки входу мають той самий вибір. Доки ви не оберете мову, Kept використовує мову браузера. Листи й нагадування надходять мовою, яку ви обрали останньою.
Цифри арабською: Західні (0123) або Східні (٠١٢٣), показується лише коли мова — арабська. Короткі ID та серійні номера завжди залишаються у західних цифрах.
Регіон: Сполучені Штати (Oct 29) або Сполучене Королівство (29 Oct, 29/10/2026), показується лише коли мова — англійська. В іспанській числа й дати відповідають регіону браузера: браузер із регіоном Мексика пише 1,234,567.5, а з регіоном Іспанія — 1.234.567,5.
Суми читаються так, як їх пише ваша мова. Там, де кома — десятковий знак, як в українській, 1.234 — це тисяча двісті тридцять чотири, а 12,50 — дванадцять з половиною. Суму, яку можна прочитати двома способами, як-от 0.125, відхиляємо, а не вгадуємо.
Формат дати: За замовчуванням (29 Oct, рік лише для інших років), 29 Oct 2026, 29/10/2026 або 2026-10-29 (як пише Сполучене Королівство). Кожен варіант показує сьогоднішню дату у цьому форматі, у вашому регіоні. Дати покупки та гарантії завжди показують рік.
Тема: Система (слідує за світлою або темною темою пристрою), Світла або Темна.
Одиниці: Метрична або Імперська, зберігається у вашому обліковому записі, а не на пристрої, тож кожен пристрій слідує за нею. Імперська показує розміри кімнат, розміри меблів, висоту речі на стіні та розміри матеріалів етикеток у футах і дюймах, споживання палива в mpg або mi/kWh, а транспортний засіб, який ви додаєте, отримує одометр у милях. Те, що ви зберегли, ніколи не змінюється: розміри лишаються в сантиметрах, а показники такими, як ви їх ввели. Одометр має власну одиницю: див. Транспортні засоби.
Ширина вмісту: По центру або На всю ширину, на екранах від 768 пкс і ширше.

7. Пройдіть ознайомлення

Довідка → Ознайомлення веде вас по Kept по реальних екранах, короткими розділами по три–шість кроків кожен:

Розділ	Що показує
Основи	Головна, ваші локації, Сканування, Пошук, і де все інше
Речі та місця	додавання до локації, що в ній, і сторінка речі з її вкладками
Граф та 3D-карта	перемикач Список, Сітка, Граф, Таблиця, Карта (Таблиця на комп’ютері), граф у 2D або 3D, 3D або план, гвідзи, поверхи та Розміщення, де кімната рухається разом із тим, що в ній
Сканування та Вхідні	вибір того, що скануєте, спуск, і перегляд того, що прочитав Kept
Рахунок	сесія рахунку: лічба, упаковка чи переміщення, куди, і що змінює Завершити
Пошук та етикетки	поле пошуку, збережені вигляди, Вибір (перемістити, друкувати етикетки, Перемістити до Смітника), друк етикеток і Сканування, яке може покласти порожню етикетку на місце, яке у вас є
Переїзд	початок переїзду, його коробки, і де вони
Позичання	що позичене, Позначити поверненим, і Позичити на речі
Розклади та нагадування	новий розклад, що зазначається, Завершити, і як нагадування доходять до вас
Папери та гарантії	бібліотека паперів, що закінчується, додавання файлу, претензії
Транспорт та паливо	список транспорту, лог показу або сервісу, сервіси, які можна відкрити, і паливо
Імпорт та експорт	звідки йде імпорт, файл, і експорт
Налаштування та спільний доступ	сповіщення, ваші локації, запрошення людей, що відстежувати

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

Зверху: скільки розділів пройдено, тонкою смужкою, і Пройти ознайомлення. Коли декілька пройдено — пише Продовжити ознайомлення і починає з першого непройденого розділу.
Нижче, один короткий рядок на розділ: його номер і кроки. Натисніть рядок, щоб почати ознайомлення з цього розділу. Пройдені розділи сховаються під Готово (N); відкрийте, щоб передивитися.
Ознайомлення починається з Довідки. Верхня панель сторінки залишається за інструментами самої сторінки; у сесії сканування Почати сеанс має малий Покажіть мені для свого розділу.
Вспливаюве вікно показує, де ви: “Розділ 3 з 12, крок 2 з 5”.
Далі йде далі, Назад повертається всередині розділу, стрілки клавіатури роблять те саме, а Esc або × закривають.
Останній крок розділу називає наступний: Продовжити переходить одразу, Зупинитися тут закінчує ознайомлення там. Останній розділ закінчується Готово.
Сторінка все ще працює, поки йде ознайомлення: торкніться чогось поза підсвічуванням. Перехід куди ознайомлення не відкривало — закриває його.
Пройдений розділ каже Готово в Довідці, на кожному пристрої. Розділ, закритий посередині, починається з першого кроку наступного разу.
Розділ, що потребує чогось показати і нічого не знаходить, створює чітко названий зразок, наприклад “Зразок: Акумуляторний дриль”. Коли ознайомлення закінчується, ви обираєте — залишити чи видалити; воно ніколи не чіпає те, що у вас уже є.
Ознайомлення ніколи не починається саме.

Декілька одноразових підказок також з’являються перший раз, коли ви використовуєте Сканування, Рахунок, пропозиції Вхідних або Етикетки.

Після оновлення Kept Що нового в Kept показує виділене цього релізу, раз на реліз для кожної людини, на кожному пристрої: по одному на слайд, з картинкою або коротким кліпом, його заголовком і рядком. Далі і Назад, крапки, стрілки клавіатури або свайп листають між ними; у останнього слайду Зрозуміло прибирає його, а Довідка → Що нового показує знову. Кліпи грають без звуку і їх можна поставити на паузу; при увімкненому зменшеному русі вони стоять нерухомо, доки не натиснете Відтворити. Офлайн слайд показує іконку розділу замість картинки. Ніколи не показується на новому обліковому записі, чи над Скануванням чи Рахунком. Виділене англійською в кожній мові, з посиланням на повні нотатки релізу на GitHub.