Események – adatmodell, hatókör és végpontok

Az események, a nyelvenkénti leírások, a felhasználói szerepek és a címkék tárolása, a mentés és törlés folyamata, a hatókörök és a kiegészítő végpontok.

Áttekintés

Események egy céghez és opcionálisan egy ügyhöz: dátum, cím és tartalom nyelvenként, felelős, végrehajtók, megfigyelők, címkék és „Elkészült” jelölés. Az adminfelület mellett token-linkes front-portál is olvassa.

Adatmodell

A táblanevek a telepítés saját előtagjával állnak az adatbázisban.

TáblaSzerep
eventesemény (cég, ügy, dátum, felelős, lezárt, létrehozó)
event_descriptionnyelvenkénti cím és tartalom
event_uservégrehajtók és megfigyelők
company_objectaz esemény céghez kötése
label_linkcímkék

Folyamat

  1. Mentés: a cég kötelező és hatókörön belüli; legalább egy nyelven cím. Új: addEvent(post, creator, 'admin'), meglévő: editEvent(). Super admin más létrehozót is megadhat (setCreatedBy).
  2. Címke-létrehozás (labelcreate): azonos nevű aktív címkénél azt adja vissza, különben a címke-modell addLabel()-jével event csoportban hoz létre.
  3. Lezárás (complete): toggleCompleted(), naplóz.
  4. Törlés: a hatókörön kívüli eseményt kihagyja; törli az eseményt, a leírásait, a felhasználó-sorait, a cég- és címke-kapcsolatait.

Jogosultság

  • list cég-hatókörrel, továbbá topic/topic_id, event/event_id, user/user_id hatókör-szabályokkal (a saját események mindig látszanak).
  • edit (űrlap), canSave() + companyInScope() (mentés), complete (+ az esemény cége a hatókörben), delete (+ soronkénti hatókör), debug.
  • A companysearch csak client cégeket ad a hatókörön belül.

Kiegészítő végpontok

  • event.exporttxt: a szűrt események szöveges exportja cég → ügy → nyitott/kész bontásban; csak super admin.
  • event.portallink: a front-portál linkje a felhasználó API-kulcsával; ha nincs kulcs, generál egyet (user/user::setApiKey); jog: list.
  • event.groupcompanies: közös cég-választó, jog: list.

Ismert korlátok

  • Az add kulcs nincs besorolva a seedekben; a mentést a canSave() dönti el.
Kapcsolódó témák: eseménykezelés jogosultság