Skip to content

CRUD-Sites

CRUD-Sites is the family for operational application surfaces.

These experiences are not public marketing pages. They are governed front-end systems with create, read, update, and delete workflows, role-based access control, and authenticated app shells.

Current CRUD-Site Portfolio

Site App URL Implementation Status
Asset Admin — Distributor (webapp v2) assets.omnivoltaic.com webapp-asset-admin-distributor-v2 Active — primary operational portal
Asset Admin — Superadmin Internal admin host webapp-asset-admin-superadmin Active — platform SUPER_ADMIN console (CRA)

Scope

  • authenticated portal apps
  • enterprise admin panels
  • Odoo admin surfaces
  • operational interfaces with role-based access
  • legacy CRUD-oriented surfaces retained for completeness

Page Families Within CRUD Sites

CRUD sites may contain pages from more than one page family:

Page Family Used For
crud Record list, record detail, record form, workflow steps
metric Dashboards, telemetry views, events logs, indexed data
auth Sign-in, sign-up, password reset
onboarding Step-by-step first-run flows

The Asset Admin — Distributor site uses crud, metric, and auth page families.

Delivery

CRUD sites are implemented in their app repos (e.g. webapp-asset-admin-distributor-v2). Rebuilds are AI-prompt-driven from the oves-sites intent bundle — see docs/agent/generate-assets-v2-prompt.md. The UI stack is Mosaic-based, consistent with docs/governance/style-policy.md.

Governing Discipline

CRUD sites follow the same portfolio rule as all other families:

  • metadata defines layout and UI behavior
  • headless content and DTOs supply domain data
  • app code consumes the declared contract rather than inventing its own

The intent schema for CRUD sites is docs/contracts/crud-intent.schema.json.

Child Site Pages

Each CRUD site has a human-readable spec under docs/sites/ and a machine-readable intent under docs/intents/sites/.

Regenerable sites ship a five-artifact bundle: intent, GraphQL catalog, themes registry, Mosaic design-system manifest, and human spec. See CRUD scaffold regeneration contract.

Generate assets v2 via AI prompt + intent bundle — see Asset Admin — Distributor and AI prompt template.