Backend i SDK

Baza danych (b77.db)

Kolekcje, zapytania i dane każdego użytkownika.

b77.db to bezschematowa baza dokumentów. Kolekcja tworzy się automatycznie przy pierwszym zapisie.

Tworzenie

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

Odczyt

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 } });

Filtry

where dopasowuje pola dokładnie i obsługuje operatory:

OperatorPrzykład
równa się{ status: 'paid' }
$ne{ status: { $ne: 'draft' } }
$in{ status: { $in: ['sent', 'paid'] } }
$gt / $gte / $lt / $lte{ total: { $gte: 100 } }
$contains{ name: { $contains: 'ann' } } (bez rozróżniania wielkości liter)

sort przyjmuje nazwę pola, a - na początku oznacza kolejność malejącą (domyślnie -createdAt). limit wynosi maksymalnie 500, a offset służy do stronicowania.

Aktualizacja i usuwanie

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);

Dane każdego użytkownika

Rekordy utworzone przez zalogowanego użytkownika dostają ownerId. Żeby pobrać tylko rekordy bieżącego użytkownika, użyj mine: true:

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

Rekord z właścicielem może zaktualizować lub usunąć tylko jego właściciel.

Reguły dostępu

Każda kolekcja ma regułę dostępu, którą sprawdza serwer. Kolekcja bez reguły dostaje domyślną, zależnie od nazwy: to, co ludzie wysyłają (orders, bookings, messages…), dostaje submit, treści, które publikujesz (products, menu, posts…), dostają readonly, leaderboard i guestbook dostają append, a wszystkie pozostałe są private. Regułę każdej kolekcji zmienisz w zakładce Dane kreatora. Aplikacja może też zadeklarować reguły w pliku b77.config.json:

{ "rules": { "notes": "private", "menu": "readonly", "orders": "auth" } }
RegułaKto może czytaćKto może zapisywać
publicKażdyKażdy
authZalogowani użytkownicy aplikacjiZalogowani użytkownicy aplikacji
privateKażdy użytkownik widzi tylko swoje rekordyTylko właściciel rekordu
readonlyKażdyTylko Ty, z zakładki Dane
submitTylko Ty i administratorzy aplikacjiKażdy może wysyłać wpisy
appendKażdyKażdy może dodawać; każdy zmienia lub usuwa tylko swoje wpisy
membersZalogowani użytkownicy z aktywną subskrypcjąZalogowani użytkownicy z aktywną subskrypcją
members-privateKażdy subskrybent widzi tylko swoje rekordyTylko właściciel rekordu
teamTy i użytkownicy, których zrobisz administratoramiTy i użytkownicy, których zrobisz administratorami
directNadawca, odbiorca i administratorzy aplikacjiTylko nadawca może zmienić lub usunąć wiadomość

Limity

Rekord może mieć do 64 KB (pliki zapisuj przez b77.storage.upload). Liczba rekordów na aplikację zależy od planu: 2000 w planie darmowym, 20 000 w Starter, 50 000 w Plus, 100 000 w Pro i 200 000 w Elite.