slp-modular-cms/aidlc-docs/features/master-cms-module/construction/frontend-cms-page/functional-design/business-rules.md

Business Rules — Unit 3: frontend-cms-page

Table Display (Q1: B+C)

• BR-FE-01: The CmsInstanceList table displays six columns: Name, URL, Status, Last Contact, DisableMessage, Actions.
• BR-FE-02: lastContactedAt is formatted as a localised date/time string; displays "—" when null.
• BR-FE-03: disableMessage displays "—" when null or empty.

Inactive Row Styling (Q2: A)

• BR-FE-04: A <TableRow> whose instance.status === 'Inactive' receives className="opacity-50". All cells within that row are visually dimmed as a result.

Status Badge Colors

• BR-FE-05: Available → green badge (secondary or custom green variant).
• BR-FE-06: NotAvailable → red badge (destructive variant).
• BR-FE-07: Inactive → muted badge (outline variant).

SetStatusDialog — DisableMessage (Q3 note, existing unit-of-work)

• BR-FE-08: The DisableMessage field is only rendered when the selected status is NotAvailable.
• BR-FE-09: DisableMessage is required (non-empty) when status is NotAvailable. Form submit is blocked if it is empty.
• BR-FE-10: When status changes away from NotAvailable, the DisableMessage field is hidden and its value is reset to "".
• BR-FE-11: The value sent to the API is null for all statuses except NotAvailable; for NotAvailable it is the trimmed string value.

UpdateStatusResult Toast (Q3: B, "cliënt" terminology)

• BR-FE-12: On HTTP 200 with slaveContactSuccess === true: show toast "Status updated — cliënt confirmed".
• BR-FE-13: On HTTP 200 with slaveContactSuccess === false: show toast "Status saved — cliënt unreachable".
• BR-FE-14: The word "slave" must not appear in any user-visible text. Use "cliënt" in all UI strings.

AddCmsInstanceDialog Error Handling (Q4: A)

• BR-FE-15: On HTTP 400 from POST /api/v1/CmsInstances: display a FormBannerError at the top of the dialog. The dialog remains open.
• BR-FE-16: On network error: display a FormBannerError at the top of the dialog. The dialog remains open.
• BR-FE-17: On success (HTTP 201): close the dialog and show a success toast.

Empty State (Q5: A)

• BR-FE-18: When useCmsInstances returns an empty array, render a centered placeholder instead of the table. The placeholder contains:
  • A LayoutGrid icon (consistent with the existing CmsPage placeholder).
  • A heading: "No CMS instances yet".
  • A description: "Add your first CMS instance to get started."
  • An "Add CMS" button that opens AddCmsInstanceDialog.
• BR-FE-19: The "Add CMS" button in the page header is always visible regardless of empty state.

Access Control

• BR-FE-20: The /cms route is already guarded by RoleGuard allowedRoles={['Owner']}. No additional guard logic is needed inside CmsPage.