Core concepts
The small vocabulary behind every SodaFlex website.
This capability is implemented for the scope described here. Production acceptance may still be named explicitly.
Website and portable source
A Website belongs to an Account. Its meaningful public representation is versioned structured data and ordinary assets, independent of incidental Rails database identifiers.
Business data, pages, and sections
Business data stores facts reused across the site, such as contact details and opening hours. Pages define routes and metadata. Ordered sections hold schema-valid content rendered by reusable components.
Assets and themes
Assets use stable portable identities and ordinary exported file names. Themes contain constrained design decisions and component variants, not page copy or executable Ruby.
Draft, proposal, and preview
A draft is editable source. A proposal is an inspectable suggested change from AI or website intake. Preview renders the actual draft through the same component system used to build production output.
Publication and deployment
A Publication freezes a validated source version and exact static artifact. A Deployment transports that immutable artifact to a destination. Failed delivery must not replace the last known-good release.
Integration and export
An integration connects a replaceable external capability. Export contains customer-owned source, assets, and a functioning static build; it excludes credentials and private dashboard data.