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 KB всеки (за файлове използвай b77.storage.upload). Броят записи на приложение зависи от плана: 2000 във Free, 20 000 в Starter, 50 000 в Plus, 100 000 в Pro и 200 000 в Elite.