77builder77
Serverio dalis ir SDK

Duomenų bazė (b77.db)

Kolekcijos, užklausos ir kiekvieno naudotojo duomenys.

b77.db yra dokumentų duomenų bazė be schemos. Kolekcija sukuriama automatiškai, kai į ją pirmą kartą ką nors įrašai.

Kūrimas

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

Skaitymas

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

Filtrai

where lygina laukus tiksliai ir palaiko operatorius:

OperatoriusPavyzdys
lygu{ status: 'paid' }
$ne{ status: { $ne: 'draft' } }
$in{ status: { $in: ['sent', 'paid'] } }
$gt / $gte / $lt / $lte{ total: { $gte: 100 } }
$contains{ name: { $contains: 'ann' } } (neskiria didžiųjų ir mažųjų raidžių)

sort priima lauko pavadinimą; priešdėlis - reiškia mažėjančią tvarką (numatytoji -createdAt). limit gali būti iki 500, o offset skirtas puslapiavimui.

Atnaujinimas ir trynimas

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

Kiekvieno naudotojo duomenys

Įrašai, sukurti prisijungus naudotojui, gauna ownerId. Tik dabartinio naudotojo įrašus gausi su mine: true:

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

Įrašą, turintį savininką, atnaujinti ar ištrinti gali tik tas savininkas.

Prieigos taisyklės

Kiekviena kolekcija turi prieigos taisyklę, kuri tikrinama serveryje. Jei kolekcija taisyklės neturi, ji gauna numatytąją pagal pavadinimą: tai, ką žmonės atsiunčia (orders, bookings, messages…), gauna submit, tavo skelbiamas turinys (products, menu, posts…) gauna readonly, leaderboard ir guestbook gauna append, o visa kita yra private. Taisyklę kiekvienai kolekcijai pakeisi redaktoriaus skiltyje Duomenys, arba programėlė gali nurodyti taisykles faile b77.config.json:

{ "rules": { "notes": "private", "menu": "readonly", "orders": "auth" } }
TaisyklėKas gali skaitytiKas gali rašyti
publicBet kasBet kas
authPrisijungę programėlės naudotojaiPrisijungę programėlės naudotojai
privateKiekvienas naudotojas mato tik savo įrašusTik įrašo savininkas
readonlyBet kasTik tu, skiltyje Duomenys
submitTik tu ir programėlės administratoriaiĮrašus siųsti gali bet kas
appendBet kasPridėti gali bet kas; keisti ar trinti kiekvienas gali tik savo įrašus
membersPrisijungę naudotojai su aktyvia prenumerataPrisijungę naudotojai su aktyvia prenumerata
members-privateKiekvienas prenumeratorius mato tik savo įrašusTik įrašo savininkas
teamTu ir naudotojai, kuriuos paskiri administratoriaisTu ir naudotojai, kuriuos paskiri administratoriais
directSiuntėjas, gavėjas ir programėlės administratoriaiŽinutę pakeisti ar ištrinti gali tik siuntėjas

Apribojimai

Vienas įrašas gali būti iki 64 KB (failus geriau saugok su b77.storage.upload). Kiek įrašų gali turėti programėlė, priklauso nuo plano: Free 2 000, Starter 20 000, Plus 50 000, Pro 100 000, Elite 200 000.