Cubes Architecture (Final)¶

Overview¶

Service → data\ Executor → flow + grouping\ Cube (frontend.php) → logic\ Template → render\ Group → runtime (not DB, not editor)

Structure¶

Modules/Cubes/ - DTO/CubeDTO.php - Service/CubesQueryService.php - Service/CubesService.php - Runtime/CubeExecutor.php - Runtime/TemplateSplitter.php - Runtime/CubeRenderContext.php

Data Flow¶

DB → CubesQueryService\ → CubesService (normalize + lang fallback)\ → CubeExecutor\ → groupByTypeSequence()\ → renderSingle / renderGroup

Contract¶

Each cube receives: - \$cube (DTO) - \$data (normalized array) - \$meta (first/last/odd/group) - \$ctx (context)

Each cube ends with: echo cube_view(...)

Group Rendering¶

Split template using 

Render: - head (first cube) - loop items - foot (last cube)

Rules¶

Allowed: - logic in template - missing data - fallback handling

Forbidden: - cube affecting another cube - shared global state

BOX (optional shared context)¶

\$ctx->box = ['layout' => 'grid'];

TL;DR¶

Keep core clean. Allow chaos inside cubes.