CMS Sections

CMS Sections este un proiect personal de studiu construit ca un page builder compact peste Laravel 12, Inertia.js 2 și Vue 3. În locul unui model rigid de pagină, conținutul este compus din secțiuni ordonate, fiecare având un tip și un payload JSON. Un registry TypeScript definește schema de editare pentru fiecare tip, iar aceeași cheie de tip este folosită de frontendul public pentru alegerea componentei Vue corespunzătoare.

Editorul permite crearea paginilor cu titlu și slug unic, marcarea unei singure pagini ca home, adăugarea secțiunilor dintr-un catalog, editarea conținutului într-un modal și reordonarea prin drag-and-drop. Registry-ul confirmă 11 tipuri de secțiuni: hero, carousel, features, testimonials, team, pricing, FAQ, CTA, statistics, gallery și contact. Câmpurile pot fi text, textarea, imagine sau repeatere recursive, ceea ce permite structuri precum slide-uri, planuri de preț, membri de echipă, întrebări FAQ și galerii fără câte un formular hardcodat separat pentru fiecare secțiune.

Persistența folosește două entități principale: Page și PageSection. Page păstrează metadata de bază, iar PageSection leagă pagina de tipul secțiunii, ordinea ei și conținutul JSON. La salvare, actualizarea paginii și înlocuirea setului de secțiuni sunt executate într-o tranzacție, astfel încât structura paginii să nu rămână parțial actualizată dacă apare o excepție. Este o abordare simplă și potrivită pentru un proiect de studiu, cu compromisul că secțiunile sunt recreate la fiecare salvare și nu există istoric de versiuni sau optimistic locking.

Media este gestionată printr-un endpoint autentificat de upload. Imaginile sunt validate ca fișiere image de maximum 2 MB, primesc nume randomizate și sunt salvate pe disk-ul public Laravel; URL-ul rezultat este injectat în conținutul secțiunii. Acest flux este folosit inclusiv în câmpurile nested din repeatere.

Frontendul public rezolvă pagina home sau pagina după slug și cache-uiește payload-ul pregătit timp de 10 minute. Cache-ul este invalidat explicit după editare și poate fi curățat manual din zona de administrare. Hero-ul este încărcat eager, iar celelalte componente de secțiune folosesc defineAsyncComponent și IntersectionObserver pentru a fi montate când se apropie de viewport. Galeria include lightbox și navigare din tastatură, carousel-ul și testimonials au autoplay, iar componentele publice folosesc layout responsive și stiluri Tailwind.

Autentificarea provine în mare parte din Laravel Breeze: register, login, resetare parolă, verificare email și profil. Funcționalitatea CMS personalizată se află în modelele Page/PageSection, controllerele de pagini și upload, registry-ul de secțiuni, editorul Vue, componentele publice și logica de cache/randare.

Scope-ul repository-ului rămâne de prototip/studiu. Nu există versionare de conținut, status draft/published pe pagini, preview separat de pagina live, management SEO, policies/roluri editoriale sau pipeline CI/CD. Formularul din secțiunea Contact simulează submit-ul doar în browser, iar harta este un placeholder pentru o integrare Maps neconfigurată. Din acest motiv proiectul este prezentat ca un page builder funcțional și extensibil, nu ca un CMS production-ready.