Terminology¶
Use this page to keep repo concepts stable across governance, contracts, intents, and site specs.
Terms¶
| Term | Definition |
|---|---|
| BFF (Backend for Frontend) | The site-facing service layer used by Omnivoltaic sites for marketing-domain retrieval and mutation. |
| CMS | The underlying content-management persistence system behind the article BFF. |
| Site Intent | The declarative description of routes, pages, themes, blocks, and props that downstream scaffold consumes. |
| Scaffold | The translation layer that converts site intent into app-specific implementation code. |
| Delivery Cache | Generated build artifacts such as fetched JSON snapshots used for deployment convenience, but not treated as authored source-of-truth. |
| Canonical Slug | The slug returned by the live BFF after create or update, which downstream routes must use. |
| Article Collection | A BFF-backed reusable editorial grouping used by sites to render article grids and listings. |
| Product Collection | A BFF-backed grouping of products consumed by site product pages. |
| Omnivoltaic Hub | The root Omnivoltaic site at /, acting as the main entry point to the solution-site portfolio. |
| Human-First Documentation | A docs structure where narrative and decision-oriented material comes before agent support surfaces. |
| Intent-First Scaffold-Last | The required workflow where route, copy, composition, and block selection changes are authored in oves-sites, then translated by scaffold, with no direct site-app page edits as a source of truth. |