MAG Knowledge Hub / Architecture
Technical

Architecture

Kako su CMS, ACF, resolveri, REST i frontend razdvojeni da bi MAG ostao prilagodljiv različitim muzejima.

Data flow

Tipičan tok je: museum CMS → field mapping → resolver → REST → visitor frontend. Time muzej može zadržati sopstvenu kolekcijsku strukturu, a MAG održava jedan stabilan visitor contract.

Zašto resolver sloj postoji

Jedan muzej može imati polje autor, drugi creator_name, treći podatak u eksternom sistemu. Frontend ipak treba da dobije samo author. Resolver je granica koja sprečava curenje CMS specifičnosti u frontend.

Content model

Object, Space i Story predstavljaju sadržajne izvore. Tour Stop povezuje te izvore u kontekst ture, uz mogućnost override-a naslova, teksta, slike i audija. Tour određuje redosled i visitor flow.

Enterprise princip

Existing museum object CPT može ostati source of truth. MAG ne zahteva migraciju zbirke u novu paralelnu bazu. To je jedna od glavnih razlika u odnosu na zatvorene SaaS platforme.

Pravila za dalji razvoj

  • Ne hardkodovati guide slug.
  • Ne hardkodovati visitor stringove u JS.
  • Ne vezivati REST contract za ACF field names.
  • Breaking API promene ne uvoditi unutar /v1.
  • Preciznu visitor lokaciju ne slati serveru.
Otvori izvorni DOCX