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.