Rhythm 2.0 Specifications

Appearance

CAP-WEB-WEB-010Maintain the site's shared presentation settings

Markdown

CAP-WEB-WEB-010

Maintain the site's shared presentation settings

Markdown
  • DocumentDraft
  • Product intentConfirmed
  • ImplementationObserved

Planning

Feature
FEAT-WEB-WEB-03
Exercised by
FAS-WEB-WEB-02-01, FAS-WEB-WEB-02-04, FAS-WEB-WEB-02-05, FAS-WEB-WEB-03-01, FAS-WEB-WEB-03-02, FAS-WEB-WEB-03-04, FAS-WEB-WEB-03-05
Key concepts
CON-WEB-WEB-001, CON-WEB-WEB-002
Actors
ACT-WEB-001, ACT-WEB-002, ACT-WEB-003
Journeys
JNY-WEB-WEB-002, JNY-WEB-WEB-003, JNY-WEB-WEB-005
Depends on
CAP-WEB-WEB-006, CAP-WEB-WEB-009
Related
CAP-WEB-WEB-018, CAP-WEB-WEB-004
Proved by
ATS-WEB-WEB-010

Implementation

Executable suites
TST-WEB-WEB-013, TST-WEB-WEB-014, TST-WEB-WEB-030, TST-WEB-WEB-071, TST-WEB-WEB-255, TST-WEB-WEB-261, TST-WEB-WEB-263

KindCapabilityProduct areaWebsitesModuleWebsites, content and the portal runtimeRevision1

Read atservices-websites 5fc6823crhythm-web 38aef7d2react-console baf6dae3

Maintain the site's shared presentation settings ​

Purpose ​

Publishers need a clear place to choose defaults that apply across the site's content.

How It Works ​

Staff open Site Settings to review shared choices and site identity. Name, addresses, status and followed-template details provide context without becoming editable settings here. A publisher selects the home page and default menus. Search presentation and visitor messages can be adjusted alongside those choices. Saving publishes the settings immediately. Editors who cannot publish can inspect them but cannot save changes. Foreign content references and invalid mapping values are rejected. Rollback-authorized administrators can continue to Releases from this screen. An unset home-page selection currently needs clearer presentation.

Relationships ​

Pages and menus supply the selected records. Site identity supplies the inspection facts, and release management provides rollback.

The Formal Contract

The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.

Outcomes
Maintain the site's shared presentation settings.
Surfaces
consoleapi
Intent sources
services-websites:docs/milestones/plans/WEB-M2-operate-a-site-plan.md#1. Objectiveservices-websites:docs/milestones/plans/WEB-M2-operate-a-site-plan.md#3. How it works for the personservices-websites:docs/milestones/WEB-M2-operate-a-site.md#D3

Controls

40 controls apply, from the corpus control catalogue.

TC-AVL-002 TC-AVL-003 TC-AZ-001 TC-AZ-002 TC-AZ-003 TC-AZ-004 TC-AZ-006 TC-CHG-001 TC-CHG-002 TC-CHG-003 TC-CHG-004 TC-CRY-001 TC-CRY-002 TC-CRY-003 TC-CRY-004 TC-DAT-001 TC-IAM-001 TC-IAM-002 TC-IAM-004 TC-IAM-005 TC-IAM-006 TC-LOG-001 TC-LOG-002 TC-LOG-003 TC-LOG-004 TC-LOG-005 TC-MON-001 TC-MON-003 TC-MON-004 TC-PI-001 TC-PI-003 TC-PI-005 TC-SEC-001 TC-SEC-002 TC-SEC-003 TC-SEC-004 TC-TEN-001 TC-TEN-002 TC-TEN-003 TC-TEN-004

Permissions

KeyChecked atScope
websites.website-changes.readapitenant
websites.content.publishapitenant

Business Rules

11 rules, 9 to be proved before approval. A rule's product intent is derived from its origin: 11 confirmed by a product decision, the rest inheriting this capability's confirmed.

IdRuleKindEnforced atProvenance
01must prove
Confirmed
Saving Site Settings immediately publishes them and therefore rejects editors who lack publish-content authority.
origin: services-websites:docs/milestones/WEB-M2-operate-a-site.md#D2
proved by ATS-WEB-WEB-010-01, ATS-WEB-WEB-010-10, TST-WEB-WEB-014, TST-WEB-WEB-030, TST-WEB-WEB-255
permissionapi, servicetest
services-websites:modules/content/app/tests/site-operations.test.ts#are saved and published together, only for a caller with publish
02must prove
Confirmed
Settings reject home pages, default menus and search images belonging to another site.
proved by ATS-WEB-WEB-010-02
validationservicetest
services-websites:modules/content/app/tests/site-operations.test.ts#refuse a home page or a menu of another site
03must prove
Confirmed
Settings allow one menu per named place and no more than 20 place mappings.
proved by ATS-WEB-WEB-010-02, ATS-WEB-WEB-010-12, TST-WEB-WEB-013
validationapitest
services-websites:modules/content/tests/unit/aws/api/content-workspace-routes.spec.ts#accept the settings as the GET answered them, ignoring the read-only block, and refuse a place twice
04must prove
Confirmed
Title patterns cannot exceed 200 characters and individual site messages cannot exceed 2,000 characters.
proved by ATS-WEB-WEB-010-13
validationapiobserved
services-websites:modules/content/aws/api/content.schemas.ts:siteSettingsWriteRequestSchema
05
Confirmed
Unconfigured Site Settings return empty choices rather than invented defaults.
policyservicetest
services-websites:modules/content/app/tests/site-operations.test.ts#read as nothing set before any are saved
06must prove
Confirmed
Settings include read-only Platform facts for name, status, canonical-first addresses and followed template version, and ignore those facts when submitted for saving.
proved by ATS-WEB-WEB-010-03, ATS-WEB-WEB-010-08, TST-WEB-WEB-261, TST-WEB-WEB-263
calculationservicetest
services-websites:modules/content/tests/integration/services/persistence/sites.queries.integration.spec.js#answers the site’s name and status, its hostnames canonical first and none removed, and its template before any publish
07must prove
Confirmed
Selecting a different home page assigns that page the root address.
proved by ATS-WEB-WEB-010-04, ATS-WEB-WEB-010-09, TST-WEB-WEB-071
calculationservicetest
rhythm-web:packages/cms-config/tests/page-tree.test.ts#moves the home page when the settings name another
08must prove
Confirmed
Saved home-page, title-pattern and not-found-message choices affect the live site.
origin: services-websites:docs/milestones/plans/WEB-M2-operate-a-site-plan.md#9. Acceptance scenarios (WEB-M2-S09)
proved by ATS-WEB-WEB-010-05, ATS-WEB-WEB-010-09, ATS-WEB-WEB-010-10, ATS-WEB-WEB-010-12, TST-WEB-WEB-013, TST-WEB-WEB-014
policyservicetest
react-console:acceptance/websites/playwright/journeys/content/WEB-ACC-0034.spec.ts#WEB-ACC-0034
09must prove
Confirmed
Settings publication records the site and operation on the security trail.
proved by ATS-WEB-WEB-010-06, TST-WEB-WEB-263
policyservicetest
services-websites:modules/content/tests/integration/services/site-content/site-content.integration.spec.js#writes the trail for a published menu, deleted menu and published settings, naming the site and the operation but no content
10must prove
Confirmed
The Site Settings link to Releases is available only to staff with rollback authority.
origin: services-websites:docs/milestones/WEB-M2-operate-a-site.md#D6
proved by ATS-WEB-WEB-010-07, ATS-WEB-WEB-010-11
permissionconsoletest
react-console:acceptance/websites/playwright/journeys/sites/WEB-ACC-0039.spec.ts#WEB-ACC-0039
11
Confirmed
An unset home-page choice displays blank even when a page already occupies the root address.
policyconsoledocumented
services-websites:docs/debt/README.md#WD-020

Scenarios

IdGivenWhenThenProvenance
01About and Contact are available pages of one site.A publisher selects About as home and changes title presentation and the missing-page message.The root displays About, titles use the saved pattern and missing pages show the saved message.test
react-console:acceptance/websites/playwright/journeys/content/WEB-ACC-0034.spec.ts#WEB-ACC-0034

The Markdown files under specs/ in rhythmsoftware/rhythm-v2-docs are the canonical source of truth. This reader is a generated, read-only projection of them.

Rhythm Software