Backend ja SDK

Tietokanta (b77.db)

Kokoelmat, kyselyt ja käyttäjäkohtainen data.

b77.db on skeematon dokumenttitietokanta. Kokoelma luodaan automaattisesti, kun kirjoitat siihen ensimmäisen kerran.

Luominen

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

Lukeminen

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

Suodattimet

where vertaa kenttiä täsmällisesti ja tukee operaattoreita:

OperaattoriEsimerkki
on yhtä kuin{ status: 'paid' }
$ne{ status: { $ne: 'draft' } }
$in{ status: { $in: ['sent', 'paid'] } }
$gt / $gte / $lt / $lte{ total: { $gte: 100 } }
$contains{ name: { $contains: 'ann' } } (kirjainkoolla ei väliä)

sort ottaa kentän nimen, ja --etuliite tarkoittaa laskevaa järjestystä (oletus -createdAt). limit on enintään 500, ja offset jakaa tulokset sivuihin.

Päivittäminen ja poistaminen

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

Käyttäjäkohtainen data

Kun käyttäjä on kirjautunut, hänen luomansa tietueet saavat ownerId:n. Hae vain nykyisen käyttäjän tietueet asetuksella mine: true:

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

Jos tietueella on omistaja, vain hän voi päivittää tai poistaa sen.

Käyttöoikeussäännöt

Jokaisella kokoelmalla on käyttöoikeussääntö, joka tarkistetaan palvelimella. Jos kokoelmalla ei ole sääntöä, se saa oletussäännön nimensä perusteella: ihmisten lähettämät asiat (orders, bookings, messages…) saavat säännön submit, julkaisemasi sisältö (products, menu, posts…) säännön readonly, leaderboard ja guestbook säännön append, ja kaikki muu on private. Voit vaihtaa säännön kokoelmakohtaisesti editorin Data-välilehdellä tai antaa sovelluksesi määritellä säännöt b77.config.json-tiedostossa:

{ "rules": { "notes": "private", "menu": "readonly", "orders": "auth" } }
SääntöKuka voi lukeaKuka voi kirjoittaa
publicKuka tahansaKuka tahansa
authKirjautuneet sovelluksen käyttäjätKirjautuneet sovelluksen käyttäjät
privateJokainen näkee vain omat tietueensaVain tietueen omistaja
readonlyKuka tahansaVain sinä, Data-välilehdeltä
submitVain sinä ja sovelluksen ylläpitäjätKuka tahansa voi lähettää merkintöjä
appendKuka tahansaKuka tahansa voi lisätä, mutta muuttaa tai poistaa vain omiaan
membersKirjautuneet käyttäjät, joilla on voimassa oleva tilausKirjautuneet käyttäjät, joilla on voimassa oleva tilaus
members-privateJokainen tilaaja näkee vain omat tietueensaVain tietueen omistaja
teamSinä ja käyttäjät, jotka teet ylläpitäjiksiSinä ja käyttäjät, jotka teet ylläpitäjiksi
directLähettäjä, vastaanottaja ja sovelluksen ylläpitäjätVain lähettäjä voi muuttaa tai poistaa viestin

Rajoitukset

Tietue voi olla enintään 64 kt (tallenna tiedostot sen sijaan b77.storage.upload-kutsulla). Tietueiden enimmäismäärä sovellusta kohden riippuu paketistasi: Free 2 000, Starter 20 000, Plus 50 000, Pro 100 000 ja Elite 200 000.