sdarbinyan/marketplaces
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

phase-1: scaffold platform foundation structure and architecture governance

Browse Source
This commit is contained in:
sdarbinyan
2026-07-03 01:26:30 +04:00
parent a59ffbcaa4
commit b957112fc7
85 changed files with 918 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

35
docs/architecture/foundation/adr/ADR-005-dynamic-page-section-widget-rendering.md Normal file
View File

@@ -0,0 +1,35 @@
# ADR-005: Dynamic Page, Section, and Widget Rendering
Status: Accepted
Date: 2026-07-03
## Context
Platform websites must be generated from configuration. Hardcoded page composition blocks tenant scalability.
## Decision
Adopt dynamic rendering engine:
- A page definition contains ordered sections.
- A section contains ordered widgets.
- WidgetHost resolves widget type through registry.
- Registry-based resolution avoids renderer edits for every new widget.
- Hero, Carousel, Header, Footer, and other blocks are widgets/layout entries from configuration.
## Consequences
Positive:
- New tenant pages created by configuration.
- Supports Builder-driven composition.
Negative:
- Requires robust schema validation.
- Requires widget compatibility and versioning discipline.
## Compliance Requirements
- Page templates must not hardcode specific widget combinations.
- Widget rendering must be data-driven from configuration contracts.