Backend és SDK

Adatbázis (b77.db)

Gyűjtemények, lekérdezések és felhasználónkénti adatok.

A b77.db egy séma nélküli dokumentumadatbázis. A gyűjtemények automatikusan létrejönnek, amikor először írsz beléjük.

Létrehozás

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

Olvasás

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

Szűrők

A where pontos egyezésre szűr a mezőkön, és operátorokat is támogat:

OperátorPélda
egyenlő{ status: 'paid' }
$ne{ status: { $ne: 'draft' } }
$in{ status: { $in: ['sent', 'paid'] } }
$gt / $gte / $lt / $lte{ total: { $gte: 100 } }
$contains{ name: { $contains: 'ann' } } (kis- és nagybetűtől független)

A sort egy mezőnevet vár, csökkenő sorrendhez - előtaggal (alapértelmezés: -createdAt). A limit legfeljebb 500, az offset lapozásra való.

Frissítés és törlés

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

Felhasználónkénti adatok

A bejelentkezett felhasználó által létrehozott rekordok ownerId-t kapnak. Ha csak az aktuális felhasználó rekordjait akarod lekérdezni, használd a mine: true beállítást:

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

Ha egy rekordnak van tulajdonosa, csak ő frissítheti vagy törölheti.

Hozzáférési szabályok

Minden gyűjteménynek van hozzáférési szabálya, és ezt a szerver ellenőrzi. Ha egy gyűjteménynek nincs szabálya, a neve alapján kap egy alapértelmezettet. Amit az emberek beküldenek (orders, bookings, messages…), az submit szabályt kap, az általad közzétett tartalom (products, menu, posts…) readonly szabályt, a leaderboard és a guestbook append szabályt, minden más pedig private lesz. A szabályt gyűjteményenként a szerkesztő Adatok fülén módosíthatod, de az alkalmazásod egy b77.config.json fájlban is megadhatja a szabályokat:

{ "rules": { "notes": "private", "menu": "readonly", "orders": "auth" } }
SzabályKi olvashatKi írhat
publicBárkiBárki
authBejelentkezett alkalmazásfelhasználókBejelentkezett alkalmazásfelhasználók
privateMindenki csak a saját rekordjait látjaCsak a rekord tulajdonosa
readonlyBárkiCsak te, az Adatok fülön
submitCsak te és az alkalmazás adminjaiBárki küldhet bejegyzést
appendBárkiBárki hozzáadhat; mindenki csak a sajátját módosíthatja vagy törölheti
membersAktív előfizetéssel rendelkező bejelentkezett felhasználókAktív előfizetéssel rendelkező bejelentkezett felhasználók
members-privateMinden előfizető csak a saját rekordjait látjaCsak a rekord tulajdonosa
teamTe és azok a felhasználók, akiket adminná teszelTe és azok a felhasználók, akiket adminná teszel
directA küldő, a címzett és az alkalmazás adminjaiAz üzenetet csak a küldője módosíthatja vagy törölheti

Korlátok

Rekordonként legfeljebb 64 KB (a fájlokat inkább a b77.storage.upload segítségével tárold). Hogy egy alkalmazásban hány rekord lehet, a csomagodtól függ: Ingyenes: 2000, Starter: 20 000, Plus: 50 000, Pro: 100 000, Elite: 200 000.