Asosiy tushunchalar

Sitora barcha yuzalar va APIʼlarda yagona qatʼiy lugʻatdan foydalanadi. Mana oʻsha atamalar va ular bilan keladigan qoidalar.

Shaxs global, ruxsat kontekstga bogʻliq

Insonning Sitoraʼda aynan bitta shaxsi boʻladi. U nima qila olishi butunlay kontekstga bogʻliq: bitta shaxs bir restoranda mehmon, boshqasida ofitsiant va uchinchisida ega boʻlishi mumkin. Ruxsat haqida shaxsning oʻzida hech narsa saqlanmaydi — hammasi aʼzolik va rollarda yashaydi.

Lugʻat

Atama	Maʼnosi
Restoran	Biznes subyekti. Brend, menyular, obuna va oʻz filiallariga egalik qiladi.
Filial	Bitta jismoniy manzil. Operatsion chegara: xodimlar, buyurtmalar, ombor, stollar va robototexnika faollashuvlari — hammasi filialga bogʻlangan.
Aʼzolik	Shaxs bilan restoran yoki filial oʻrtasidagi, rolni olib yuruvchi bogʻlanish.
Rol	Nomlangan ruxsatlar toʻplami. Ilova rollari sakkizta: ofitsiant, kassir, oshxona, zal menejeri, omborchi, taʼminot menejeri, kontent menejeri, filial administratori. Rollar server qaysi amallarni taklif qilishini belgilaydi.
Sessiya	Mehmonning stolga bogʻlangan tashrifi. Stolda berilgan buyurtmalar sessiyaga tegishli.
Buyurtma	Mehmon talabining birligi. Aniq holat mashinasidan oʻtadi: zal uchun received → preparing → ready → served, olib ketish va yetkazish uchun pickup_ready va out_for_delivery → delivered, filial tayyorlashdan oldin toʻlov olganda pending_payment, va buyurtma hali ish jarayonida boʻlganda yetib boriladigan cancelled. Oʻtishlar serverga tegishli.
Tranzaksiya	Pul harakati. Qayd etilgach oʻzgarmas.
Ombor tranzaksiyasi	Zaxira harakati. Qayd etilgach oʻzgarmas; tuzatishlar kompensatsion yozuv orqali.

Jarayon haqiqati serverda yashaydi

Mijozlar nimaga ruxsat borligini hech qachon hal qilmaydi. Holatni oʻzgartira oladigan har bir yuza serverdan allowed_actions oladi va aynan oʻsha imkoniyatlarni koʻrsatadi. Aynan shuning uchun, masalan, robot buyurtmani hech qachon oldinga sura olmaydi: buyurtma holat mashinasi faqat server vakolat bergan subyektlardan oʻtishni qabul qiladi, robot esa ularga kirmaydi — uning yakunlashlari oʻtishni taklif qiladi, keyin uni qoida yoki xodim qoʻllaydi.

Oʻzgarmaslik va jurnal

Pul, ruxsat, zaxira, hayotiy sikl yoki boshqaruv holatini oʻzgartiradigan amallar bajaruvchi subyekt koʻrsatilgan holda faqat qoʻshiladigan jurnal hodisalari sifatida qayd etiladi. Ega amallari biznes jurnal hodisalarini, Sitora xodimlari amallari Konsol jurnal hodisalarini, robot faoliyati esa har bir vazifa boʻyicha oʻzgarmas hodisalar jurnalini hosil qiladi. Ularning hech biri keyinchalik tahrirlanmaydi.