Skip to content

OVES Sites

This site explains how Omnivoltaic's front-end estate is structured, what each site family is meant to do, and which governing disciplines apply across the portfolio.

Use it when you need to answer questions such as:

  • what belongs on a site or route
  • how ISR-Sites, CRUD-Sites, and Metric-Sites differ
  • which metadata rules govern layout and UI behavior
  • which headless content domains populate the governed site objects

Start Here

Read in this order:

  1. Shared Site Rules
  2. Site Overview
  3. Headless Content Types
  4. the relevant contract or domain guide
  5. the specific site guide
  6. ADRs when you need the durable reasoning behind a rule
  7. Reference for terminology, schemas, and lookup material

What This Repo Owns

  • route and page-composition authority for Omnivoltaic sites
  • the portfolio model across ISR-Sites, CRUD-Sites, and Metric-Sites
  • metadata and headless-content disciplines for governed front ends
  • human-readable site specs paired with machine-readable site intents

What This Repo Does Not Own

  • scaffold implementation mechanics
  • generated runtime app code
  • local shadow copies of article or product objects
  • page-specific fixes that belong only in downstream apps

Operating Rule

The docs here are the source of truth for the governing front-end model.

They should explain:

  • site-family structure
  • metadata and behavior rules
  • headless-content boundaries
  • domain contracts that downstream delivery must respect

They should not read like app-maintainer notes or generated-code instructions.

Main Sections

  • Foundations: portfolio-wide rules, boundaries, and operating policies
  • Domain Guides: metadata, headless-content, product, article, contact, and site-intent contracts
  • Headless Content Types: current content domains, dynamic data types, and site-targeted BFF grouping
  • Site Guides: portfolio-wide site families plus active ISR site specs
  • ADRs: durable decisions about documentation structure and content authority
  • Reference: stable lookup pages for terminology, schemas, endpoint families, and repo map
  • Appendix: supplemental glossary material

Small notes: progressive architecture decisions are tracked in Architecture Decision Records; stable lookup material lives under Reference.

Downstream Relationship

oves-sites is the governing authority across all site families.

Current downstream delivery is centered on dirac-uxi-isr, but the repo scope already extends beyond ISR-Sites into the planned CRUD-Sites and Metric-Sites families.

Published docs: docs.omnivoltaic.com/oves-sites