# Platform Standardization Report Date: 2026-07-09 Scope: Sprint 11.5 - Platform Standardization ## Objective Standardize the frontend platform before Admin Platform work without adding new marketplace features. ## Summary The sprint delivered a platform-wide standardization pass across architecture boundaries, legacy cleanup, widget metadata support, translation coverage, theme token normalization, and architecture documentation updates. ## Files Changed - `angular.json` - `src/styles.scss` - `src/assets/mock/bootstrap/widget-manifest.json` - `src/app/theme/tokens/theme-variable-map.ts` - `src/app/theme/mappers/theme-css-vars.mapper.ts` - `src/app/shared/models/config/widget.model.ts` - `src/app/widgets/contracts/widget-manifest.contract.ts` - `src/app/widgets/resolvers/data-source-resolver.service.ts` - `src/app/layouts/containers/dynamic-page-layout.component.ts` - `src/app/components/product-card/product-card.component.ts` - `src/app/components/product-card/product-card.component.html` - `src/app/components/header/header.component.ts` - `src/app/components/header/header.component.html` - `src/app/components/header/header.component.scss` - `src/app/components/language-selector/language-selector.component.scss` - `src/app/components/delivery-selector/delivery-selector.component.scss` - `src/app/components/items-carousel/items-carousel.component.scss` - `src/app/pages/cart/cart.component.html` - `src/app/pages/cart/cart.component.scss` - `src/app/pages/home/home.component.ts` - `src/app/pages/home/home.component.html` - `src/app/pages/home/home.component.scss` - `src/app/pages/item-detail/item-detail.component.scss` - `src/app/pages/public/platform-home.component.ts` - `src/app/pages/backoffice/backoffice-dashboard.component.ts` - `src/app/pages/builder/builder-sandbox.component.ts` - `src/app/widgets/ui/unknown-widget.component.ts` - `src/app/widgets/ui/recently-viewed-widget.component.ts` - `src/app/features/website/user-experience/components/recently-viewed-strip/recently-viewed-strip.component.ts` - `src/app/features/website/user-experience/compare/components/compare-table.component.ts` - `src/app/features/website/user-experience/compare/components/compare-table.component.html` - `src/app/features/website/user-experience/wishlist/containers/wishlist-page.component.ts` - `src/app/i18n/translations.ts` - `src/app/i18n/en.ts` - `src/app/i18n/ru.ts` - `src/app/i18n/hy.ts` - `docs/architecture/foundation/README.md` - `docs/architecture/foundation/Configuration-Standards.md` - `docs/architecture/foundation/Component-Standards.md` - `docs/architecture/foundation/Service-Standards.md` - `src/app/features/website/catalog/services/catalog-search-history.service.ts` (deleted) ## Technical Debt Removed - Removed duplicate catalog search-history service implementation and consolidated on core search history service. - Removed legacy variant naming from active application-layer styles/templates (`novo` / `dexar` remnants in `src/app/**`). - Eliminated hardcoded UI strings identified in audited runtime pages/components by introducing translation keys. - Standardized global token surface for spacing and transition variables. - Added explicit widget metadata support surface for animation/style/permissions and normalized metadata propagation through dynamic rendering. ## Architecture Audit Result Target flow: UI -> Facade -> Domain -> Infrastructure -> Backend Result: - Audited website feature containers/components for direct forbidden dependencies. - No active component-level `HttpClient` usage found. - No active component-level DTO imports found. - No active component-level `environment` access found. - Facade/container orchestrations remain in place for catalog and product UX flows. ## Legacy Cleanup Result Searched and addressed: - `isMarketplaceVariant` - `marketplaceVariant` - `projectName` - legacy variant naming usage in app layer (`novo`, `lavero`, `dexar`) Result: - No remaining `isMarketplaceVariant`, `marketplaceVariant`, or `projectName` matches in `src/**`. - No remaining `novo`/`lavero` matches in `src/app/**`. ## Bootstrap Audit Result Config representability status: - Core page/section/widget configuration remains bootstrap-driven. - Widget metadata support expanded in contracts and dynamic renderer. Documented gaps (no backend changes implemented): - Full role/permission enforcement for widgets is limited by current auth session shape (no roles/permissions in session model). - Catalog popular-search defaults are still facade-local constants and should be modeled in bootstrap catalog config. - Optional persistent-storage key prefix override is not yet modeled in bootstrap schema. ## Widget Audit Result Support status: - `title`: supported - `subtitle`: supported - `visibility`: supported - `layout`: supported - `animation`: supported - `style`: supported - `permissions`: supported (auth-gate baseline) ## Translation Audit Result - Remaining hardcoded UI strings found in audited pages/components were replaced with translation keys. - Translation schema and locale resources were updated for new keys. ## Theme Audit Result Standardized token set ensured: - Spacing: `--space-xs`, `--space-sm`, `--space-md`, `--space-lg`, `--space-xl` - Radius: `--radius-sm`, `--radius-md`, `--radius-lg` - Shadows: `--shadow-sm`, `--shadow-md`, `--shadow-lg` - Transitions: `--transition-fast`, `--transition-normal`, `--transition-slow` Runtime mapping now propagates spacing/transition tokens through theme engine. ## Validation Executed: - `npm run build` - `node tools/architecture/check-boundaries.mjs` Expected acceptance target: - Build with no warnings - No legacy marketplace conditions in app layer - No environment-driven business logic in feature/business layers - No duplicate implementations in catalog search history path ## Remaining Recommendations 1. Extend auth session model/contracts to include role and permission claims, then enforce widget role/permission checks in dynamic layout. 2. Move `SearchFacade.popularSearches` to bootstrap `catalog` settings to remove remaining hardcoded discovery defaults. 3. Add bootstrap-configurable storage namespace/prefix for all local persistence services. 4. Continue translation audit on legacy pages outside audited standardization scope (especially static/legal and long-tail utility pages). 5. Consider normalizing project naming in build metadata (`angular.json` project id/output naming) in a dedicated infra-only cleanup sprint.