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.
69 lines
2.2 KiB
Markdown
69 lines
2.2 KiB
Markdown
# 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
|