Skip to content

README.md

Latest commit

 

History

History
94 lines (76 loc) · 4.83 KB

README.md

File metadata and controls

94 lines (76 loc) · 4.83 KB

evo-ui

evo-ui - це спільна Livewire + DaisyUI база для сучасних manager-модулів Evolution CMS.

Цей uk entrypoint є єдиною українською документаційною локаллю. Legacy значення Evolution manager ua нормалізується до uk і не має окремої папки документації.

Пакет використовується в sArticles, dIssues, sLang, sSeo і dDocs як канонічний UI-шар менеджера. Consumer-модулі декларативно описують tabs, tables, forms, workspaces, fields, providers і правила збереження, а evo-ui відповідає за shell, компоненти, state behavior, theme bridge і локальні assets.

Коли використовувати

Використовуйте evo-ui для manager screen, settings form, table/list CRUD, resource-like editor, issue workspace або спільних візуальних primitives. Бізнес-правила, ownership даних, provider semantics і workflow конкретного модуля залишаються в consumer package.

Основні можливості

  • Власний manager iframe layout з локальними assets.
  • Синхронізація тем Evolution manager.
  • Livewire 4 bridge для manager routes, CSRF і session.
  • Конфіговані таблиці з фільтрами, пошуком, сортуванням, пагінацією, table/list режимами, inline edit, modal edit, діями рядка і reorder.
  • Конфіговані форми для налаштувань і resource-like редакторів.
  • Provider-backed workspace для kanban/list сценаріїв, як у dIssues.
  • Спільні компоненти: кнопки, іконки, таби, модалки, бейджі, картки, choices, image/file поля і rich editors.
  • Збереження поточного UI state в manager session.

Типові workflow

  • Зібрати shell модуля через x-evo::layout, evo::partials.assets, module tabs і Livewire components.
  • Описати table/list поверхні через evo-ui.module-table presets.
  • Описати settings/model forms через evo-ui.form presets.
  • Використати issue workspace contract для provider-backed list/kanban сценаріїв.
  • Новий shared UI pattern спочатку документувати як contract, потім покривати package tests, і лише після цього підключати в consumer modules.

Приклад

<x-evo::layout :title="$pageTitle">
    <x-evo::module-tabs :items="$tabs" :active="$activeTab" />

    <livewire:evo-ui.module-table
        preset="vendor.module.items"
        :context="['moduleUrl' => $moduleUrl]"
    />
</x-evo::layout>

Документи для розробника

Правила для dDocs

  • Усі посилання тут навмисно лишаються всередині package docs/ tree.
  • Локалізовані README - це entrypoints; канонічні технічні contracts лежать у root docs і відкриваються через посилання вище.
  • Code examples мають fenced language identifiers, щоб dDocs стабільно підсвічував код.

Правило

У evo-ui має жити тільки спільний UI runtime. Бізнес-логіка, доменні хуки, збереження сутностей і інтеграції залишаються в конкретному модулі.