77builder77
Бекенд і SDK

База даних (b77.db)

Колекції, запити й дані кожного користувача.

b77.db — документна база даних без схеми. Колекції створюються автоматично під час першого запису.

Створення

const task = await b77.db.create('tasks', { title: 'Ship v2', done: false, priority: 2 });
// → { id, title, done, priority, createdAt, updatedAt, ownerId }

Читання

const all = await b77.db.list('tasks');
const open = await b77.db.list('tasks', { where: { done: false }, sort: '-priority', limit: 50 });
const one = await b77.db.get('tasks', id);            // null if missing
const count = await b77.db.count('tasks', { where: { done: true } });

Фільтри

where порівнює поля на точний збіг і підтримує оператори:

ОператорПриклад
дорівнює{ status: 'paid' }
$ne{ status: { $ne: 'draft' } }
$in{ status: { $in: ['sent', 'paid'] } }
$gt / $gte / $lt / $lte{ total: { $gte: 100 } }
$contains{ name: { $contains: 'ann' } } (без урахування регістру)

sort приймає назву поля, а - на початку означає сортування за спаданням (за замовчуванням -createdAt). limit можна задати до 500, offset потрібен для посторінкового виводу.

Оновлення й видалення

await b77.db.update('tasks', id, { done: true });   // shallow merge
await b77.db.replace('tasks', id, { title: 'New' }); // overwrite all fields
await b77.db.remove('tasks', id);

Дані кожного користувача

Записи, створені, коли користувач увійшов у систему, отримують ownerId. Щоб отримати лише записи поточного користувача, передай mine: true:

const myNotes = await b77.db.list('notes', { mine: true });

Змінити чи видалити запис із власником може лише сам власник.

Правила доступу

Кожна колекція має правило доступу, яке перевіряється на сервері. Якщо правила немає, колекція отримує типове залежно від назви: те, що надсилають люди (orders, bookings, messages…), отримує submit, вміст, який публікуєш ти (products, menu, posts…), отримує readonly, leaderboard і guestbook отримують append, а все інше private. Змінити правило окремої колекції можна на вкладці Дані в редакторі, або додаток сам задасть правила у файлі b77.config.json:

{ "rules": { "notes": "private", "menu": "readonly", "orders": "auth" } }
ПравилоХто може читатиХто може записувати
publicБудь-хтоБудь-хто
authАвторизовані користувачі додаткаАвторизовані користувачі додатка
privateКожен бачить лише свої записиЛише власник запису
readonlyБудь-хтоЛише ти, з вкладки Дані
submitЛише ти й адміністратори додаткаБудь-хто може надсилати записи
appendБудь-хтоБудь-хто може додавати; кожен змінює чи видаляє лише свої записи
membersАвторизовані користувачі з активною підпискоюАвторизовані користувачі з активною підпискою
members-privateКожен передплатник бачить лише свої записиЛише власник запису
teamТи й користувачі, яких ти зробив адміністраторамиТи й користувачі, яких ти зробив адміністраторами
directВідправник, отримувач і адміністратори додаткаЗмінити чи видалити повідомлення може лише відправник

Обмеження

Кожен запис до 64 КБ (файли зберігай через b77.storage.upload). Кількість записів на додаток залежить від тарифу: 2 000 на Free, 20 000 на Starter, 50 000 на Plus, 100 000 на Pro і 200 000 на Elite.