92 lines
2.7 KiB
Markdown
92 lines
2.7 KiB
Markdown
|
# Widget Manifest Report
|
||
|
|
|
||
|
|
## Scope
|
||
|
|
|
||
|
|
Sprint 8 introduced a generic widget manifest and data-source engine for the runtime homepage path. The implementation stays within the frozen architecture and does not change Product Domain, Category Domain, authentication, payment, or backend APIs.
|
||
|
|
|
||
|
|
The widget engine now resolves widget metadata, supported layouts, supported data sources, settings schema, and default settings from a manifest. Widgets receive only the section config and resolved data.
|
||
|
|
|
||
|
|
## Implemented Changes
|
||
|
|
|
||
|
|
### Widget Manifest
|
||
|
|
|
||
|
|
- `src/app/widgets/contracts/widget-manifest.contract.ts`
|
||
|
|
- `src/app/widgets/registry/widget-manifest.service.ts`
|
||
|
|
- `src/assets/mock/bootstrap/widget-manifest.json`
|
||
|
|
|
||
|
|
Added widget metadata for:
|
||
|
|
|
||
|
|
- Hero
|
||
|
|
- Categories
|
||
|
|
- ProductCollection
|
||
|
|
- Banner
|
||
|
|
- Html
|
||
|
|
- Partners
|
||
|
|
- Footer
|
||
|
|
|
||
|
|
Each widget definition now exposes:
|
||
|
|
|
||
|
|
- supported layouts
|
||
|
|
- supported data sources
|
||
|
|
- settings schema
|
||
|
|
- default settings
|
||
|
|
|
||
|
|
### Data Source Resolver
|
||
|
|
|
||
|
|
- `src/app/widgets/resolvers/data-source-resolver.service.ts`
|
||
|
|
|
||
|
|
Added a generic resolver that delegates to the existing facades:
|
||
|
|
|
||
|
|
- `CategoryFacade` for root and parent category data
|
||
|
|
- `ProductFacade` for featured, latest, category, manual, and related product data
|
||
|
|
|
||
|
|
Supported data source modes include:
|
||
|
|
|
||
|
|
- ProductCollection: `featured`, `latest`, `category`, `manual`, `related`, `future`
|
||
|
|
- Categories: `root`, `parent`, `manual`, `future`
|
||
|
|
|
||
|
|
### Widget Rendering
|
||
|
|
|
||
|
|
- `src/app/dynamic-renderer/widget-host/widget-host.service.ts`
|
||
|
|
- `src/app/layouts/containers/dynamic-page-layout.component.ts`
|
||
|
|
- `src/app/widgets/ui/hero-widget.component.ts`
|
||
|
|
- `src/app/widgets/ui/categories-widget.component.ts`
|
||
|
|
- `src/app/widgets/ui/product-carousel-widget.component.ts`
|
||
|
|
- `src/app/widgets/ui/footer-navigation-widget.component.ts`
|
||
|
|
|
||
|
|
Widgets now receive section config plus resolved data only. The layout resolves widgets asynchronously through the host service and renders the resolved component with those two inputs.
|
||
|
|
|
||
|
|
### Homepage Bootstrap
|
||
|
|
|
||
|
|
- `src/assets/mock/bootstrap/bootstrap.json`
|
||
|
|
- `src/assets/mock/bootstrap/homepage.json`
|
||
|
|
- `src/app/pages/home/home.component.ts`
|
||
|
|
- `src/app/pages/home/home.component.html`
|
||
|
|
|
||
|
|
The homepage now resolves from the runtime section collection and includes:
|
||
|
|
|
||
|
|
- Hero
|
||
|
|
- Categories
|
||
|
|
- ProductCollection
|
||
|
|
|
||
|
|
## Validation
|
||
|
|
|
||
|
|
Completed checks:
|
||
|
|
|
||
|
|
- Existing homepage still renders.
|
||
|
|
- ProductCollection works through the data-source resolver.
|
||
|
|
- Categories work through the data-source resolver.
|
||
|
|
- Widget metadata exists in the manifest.
|
||
|
|
- Data-source resolution is isolated from widget components.
|
||
|
|
- Build passes.
|
||
|
|
|
||
|
|
Build validation:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
npm run build
|
||
|
|
```
|
||
|
|
|
||
|
|
## Stop Point
|
||
|
|
|
||
|
|
Sprint 8 widget-manifest and data-source-engine work is complete. Stop here and wait for approval before extending the manifest system to more pages or adding new widget types.
|