UK Multi Tenant

Multi-Tenant і користувачі

🤖 Цей український переклад створений з AI-підтримкою з англійського оригіналу. Виправлення приймаються на GitHub.

🌐 Мова: EN · DE · FR · ES · TR · EL · UK

Tesla Carview підтримує кілька ізольованих облікових записів ("орендарів") на одному сервері — ідеально для родин, або якщо ви хочете запропонувати сервіс близьким друзям під некомерційною ліцензією.

---

Розуміння орендарів

Уявіть орендарів як окремі квартири в одному будинку:

• Кожен орендар має власних користувачів, автомобілі та дані
• Орендарі не можуть бачити дані один одного
• Один сервер, кілька ізольованих середовищ

Коли вам потрібно кілька орендарів?

• Родина з двома власниками Tesla, які хочуть окремі дані
• Ви та друг ділите сервер
• Тестування другої конфігурації без впливу на робочі дані

Коли достатньо одного орендаря?

• Ви та ваш партнер ділите одну Tesla
• У вас кілька Tesla, але ви хочете всі дані в одному місці
• Самостійне використання

---

Master-база даних vs. бази даних орендарів

Tesla Carview використовує два типи баз даних:

База даних	Розташування	Містить
master.db	/app/data/master.db	Список орендарів, токени користувачів, OAuth-стан
{tenant-uuid}.db	/app/data/tenants/	Усі дані автомобілів і користувачів для одного орендаря

Дані кожного орендаря повністю ізольовані на рівні файлів.

---

Створення нового орендаря

Варіант 1: Самореєстрація (якщо увімкнено)

Користувачі можуть реєструвати власного орендаря на https://tesla.yourdomain.com/register:

1. Заповніть назву орендаря, slug (короткий URL-безпечний ідентифікатор), ім'я адміна та пароль
2. Прийміть умови
3. Готово — створено нового ізольованого орендаря

Обмежити самореєстрацію кодами запрошень: У .env:

REGISTRATION_REQUIRES_INVITE=true

Потім створіть коди запрошень у Admin → Invites → Create Invite Code і поділіться посиланням.

Варіант 2: Через адміна (самореєстрація не потрібна)

Якщо самореєстрацію вимкнено, ви (як адміністратор) створюєте орендарів безпосередньо через API або тимчасово вмикаючи реєстрацію.

---

Керування користувачами в межах орендаря

Ролі користувачів

Роль	Що вони можуть робити
Admin	Усе — автомобілі, користувачі, налаштування, керування даними
User	Переглядати дані для призначених автомобілів, створювати записи журналу

Адміністратори встановлюють дозволи на кожного користувача поза базовою роллю:

Дозвіл	За замовчуванням для користувачів
Може редагувати автомобілі	Ні
Може додавати автомобілі	Ні
Потрібен MFA	Так (налаштовується)

Запрошення користувачів

Як адміністратор, запросіть інших до вашого орендаря:

1. Admin → Users → Invite User
2. Введіть їхній email (або просто згенеруйте посилання без email)
3. Встановіть їхні початкові дозволи
4. Вони натискають посилання та встановлюють свій пароль

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

Користувач може бачити лише ті автомобілі, до яких його призначено:

1. Admin → Users → натисніть на користувача
2. Під "Vehicles" → призначте, які автомобілі він може бачити
3. Зміни набирають чинності негайно (вихід не потрібен)

---

Псевдоніми орендарів

Для конфіденційності орендарі ідентифікуються псевдонімом (напр. "brave-eagle") на сторінці входу — а не справжньою назвою орендаря. Це запобігає тому, щоб сторінка входу розкривала, хто керує цим сервером.

Ви можете змінити псевдонім:

• Admin → Settings → Tenant → Change Pseudonym

---

Видалення орендаря

Видалення орендаря — це деструктивна операція, що вимагає підтвердження:

1. Admin → Data → Delete Tenant
2. Введіть фразу підтвердження
3. Перед видаленням автоматично створюється резервна копія

---

Статус орендаря

Орендарів можна призупинити без видалення:

• Admin → Tenants → Suspend
• Призупинені орендарі не можуть увійти
• Дані зберігаються

---

Технічні обмеження (один сервер)

Ресурс	Практичне обмеження
Кількість орендарів	Без жорсткого обмеження (SQLite добре масштабується)
Автомобілів на орендаря	Без жорсткого обмеження
Користувачів на орендаря	Без жорсткого обмеження
Розмір бази даних на орендаря	~50 МБ за 3 роки даних (типово)

Tesla Carview не призначено для крупномасштабного multi-tenant SaaS-використання — це для приватного/сімейного використання. Див. Ліцензія та використання для того, що дозволено.