The store keeps a Menu Set's state in the directory layout (drafts/ versus published/) and its metadata in a manifest, with publishing as a single directory rename. Editing is allowed on Drafts only, so a published menu can never change under a customer. Stages 2 and 3 of docs/plan.md, with tests.
2.2 KiB
Menu Publishing
Publishing the customer-facing menus of several brewery-restaurant Sites. A Site serves photographed pages of its printed menus, grouped into Sections and published as Menu Sets.
Language
Structure
Site: One restaurant's customer-facing menu deployment, with its own brand, Sections and content. Each Site runs its own instance of the app. Avoid: brand, tenant, deployment, instance
Section: A top-level category of menu content that customers choose between, such as Food, Bar or What's On. Avoid: type, category, tab, folder
Menu Set: One complete set of Pages published together for a Section, with a label and an optional valid-until date. Avoid: menu, version, batch, upload, album
Page: One image within a Menu Set, in a deliberate order; usually a photographed page of a printed menu. Avoid: sheet, slide, image, photo
Poster: A Page whose content is an event or seasonal creative rather than a menu, published in the What's On Section. Avoid: flyer, banner, creative
Publication
Draft: A Menu Set that has been uploaded but is not visible to customers.
Current: The single published Menu Set per Section that customers see. Avoid: live, active, main
Archive: A Menu Set that was once Current and has been superseded. Reachable by direct URL, never listed in customer navigation. Avoid: old menu, history, expired, past
Publish: The act of making a Draft Current, which archives the Menu Set that was Current before it. Avoid: release, deploy, go live
Images
Original: The uploaded image as stored, kept so that viewing images and thumbnails can be regenerated. Never served to customers. Avoid: source, master, full-size
Viewing image: The wide image shown on a Section page and opened by tap-to-zoom. Avoid: preview, display image
Thumbnail: The small image used only inside the admin. Avoid: preview, grid image
Surfaces
Landing page: The Site root, listing the Sections that have a Current Menu Set. Avoid: home, index
Admin: The password-protected area where a Menu Set is uploaded, ordered, previewed and published. Avoid: dashboard, CMS, back office