feat(builder): add project editor

docs/Project-Editor.md

@@ -0,0 +1,138 @@
+# Marketplace Project Editor - Sprint 13
+
+## Scope
+
+Sprint 13 introduces first version of Marketplace Project Editor.
+
+Editor only manages bootstrap configuration.
+
+Out of scope:
+- products
+- categories
+- orders
+- analytics management
+
+## Architecture
+
+```text
+src/app/features/project-editor/
+  pages/
+  components/
+  sections/
+  models/
+  services/
+  facade/
+```
+
+Editor uses strongly typed bootstrap models and isolated feature state.
+Components do not call APIs directly.
+
+## Facade API
+
+`ProjectEditorFacade` exposes:
+- `loadBootstrap()`
+- `updateBootstrap()`
+- `exportBootstrap()`
+- `importBootstrap()`
+- `preview()`
+
+Current source of truth:
+- existing bootstrap provider via `ConfigService`
+
+Future backend integration:
+- replace local import/export/save flow with builder endpoints
+- keep component contracts unchanged
+
+## Supported Sections
+
+- General
+  - marketplace name
+  - domain
+  - description
+  - default language
+  - supported languages
+- Branding
+  - logo
+  - small logo
+  - favicon
+  - marketplace title
+- Theme
+  - palette tokens via color pickers
+- Header
+  - logo/search/categories/languages/cart/profile/wishlist/compare/region toggles
+- Footer
+  - company information
+  - address
+  - phone
+  - email
+  - copyright
+  - payment icons
+  - social links
+  - static pages
+- Homepage
+  - home page sections list
+  - visibility
+  - order
+  - layout
+  - drag-and-drop ordering
+- Widgets
+  - homepage widget configuration
+  - typed shortcuts for hero/categories/product collection widgets
+  - JSON fallback for other widget props
+- Marketplace Features
+  - feature flags
+  - search suggestions/history
+  - recently viewed
+  - reviews/questions/recommendations
+- Preview
+  - export JSON
+  - import JSON
+  - runtime preview without full browser refresh
+
+## Preview Strategy
+
+Preview updates bootstrap snapshot in memory and re-applies:
+- theme
+- branding
+- runtime state
+- route-based page rendering on next Angular navigation
+
+This keeps bootstrap engine intact while enabling fast local preview.
+
+## Widget Configuration
+
+Current widget editor supports explicit fields for:
+- Hero
+  - layout
+  - height
+  - overlay
+  - autoplay
+- Categories
+  - layout
+  - columns
+- Product Collection
+  - layout
+  - cards per row
+  - filters
+  - badges
+  - rating
+  - price
+
+Other widgets use JSON props fallback until dedicated editors are added.
+
+## Future Backend Endpoints
+
+Recommended future builder endpoints:
+- `GET /builder/bootstrap`
+- `PUT /builder/bootstrap`
+- `POST /builder/bootstrap/preview`
+- `POST /builder/bootstrap/validate`
+- `POST /builder/bootstrap/import`
+- `GET /builder/bootstrap/export`
+
+## Constraints
+
+- runtime bootstrap engine not replaced
+- configuration stays source of truth
+- no hardcoded marketplace values
+- no business domain management mixed into editor

docs/platform/00-overview.md

@@ -86,3 +86,8 @@
 - Возвращать валидный bootstrap JSON для каждого tenant.
 - Поддерживать согласованные API-контракты каталога.
 - Обеспечивать обратную совместимость либо явно повышать schemaVersion.
+
+## Project Editor
+- Внутренний Project Editor редактирует только bootstrap-конфигурацию маркетплейса.
+- Editor не управляет товарами, категориями, заказами или аналитикой.
+- Первичная версия поддерживает секции general, branding, theme, header, footer, homepage, widgets, marketplace features и preview.

docs/platform/02-bootstrap-json-spec.md

@@ -171,3 +171,9 @@ Bootstrap JSON является главным конфигурационным
 - Отдавать tenant-specific bootstrap.json.
 - Поддерживать schemaVersion и changelog контракта.
 - Не включать frontend-специфические runtime-хуки в JSON.
+
+## Project Editor Coverage
+- Marketplace Project Editor изменяет bootstrap-конфигурацию без редактирования доменных сущностей.
+- Editor работает со строго типизированными разделами: general, branding, theme, header, footer, homepage, widgets, marketplace features.
+- Под preview допускается in-memory override bootstrap snapshot без полной перезагрузки браузера.
+- Будущие builder endpoints должны повторять контракты BootstrapConfig без tenant-specific веток во frontend.

docs/platform/05-widget-system.md

@@ -1,3 +1,9 @@
+## Project Editor Widget Support
+- Project Editor предоставляет typed editing для homepage widgets.
+- Hero: layout, height, overlay, autoplay.
+- Categories: layout, columns.
+- Product collection: layout, cards per row, filters, badges, rating, price.
+- Остальные виджеты редактируются через JSON props fallback до появления специализированных editors.
 # 05. Widget System
 
 ## Назначение