Operator guideENcmscountry-messagedetailai

CMS / Country Message / Detail

AI greeting manager with settings, per-locale preview, generation controls, recent greetings, and activity logs.

Reader view

Clean portal guidance

This page keeps the operator explanation, field and action descriptions, and screenshots visible without exposing repo paths, raw sidecars, or editorial-only implementation details.

Narrative content

Page body

What this page does

This page opens the AI greeting manager used to maintain the personalizedGreetingMessage workflow.

What operators can do here

  • review overall greeting coverage before changing prompt or target-country settings
  • monitor renewal progress for a long-running all-country regeneration run
  • choose the target language
  • select which countries should be included in the next generation run
  • save the current prompt and country set to configuration
  • preview one generated greeting before a full run
  • generate or renew greetings in batches
  • delete all greetings for the selected locale
  • refresh country-distribution and statistics cards
  • reset the prompt back to its template baseline
  • review recent generated greetings and activity logs

Why operators open this screen

  • the greeting prompt has changed and the configuration should be updated
  • a country list must be expanded or reduced before the next run
  • support needs a quick preview for one locale
  • generated greeting coverage should be refreshed or cleared
  • a renewal run is already in progress and its completion needs to be monitored without leaving the dialog

Known caveats

  • The screen mixes settings management and content generation. Saving settings and generating content are separate actions.
  • Greeting content is eventually stored as a core resource under personalizedGreetingMessage.
  • Delete All clears generated greeting content for the current locale selection, then republishes the backing resource.
  • The modal shows both global coverage cards and one-off preview content. Previewing a greeting does not persist anything by itself.
  • Preview Generated Greeting uses the first selected country, or falls back to US if no country is selected.
  • Generate Greetings processes only the first Countries per Run countries from the current selection.
  • Reset Template restores the hardcoded FE default prompt text. It does not reload the currently saved prompt from system settings.
  • The FE keeps an internal selectedDevice state, but no visible device-toggle control was verified on the current modal, so the current preview remains a combined mobile and desktop result.

Verification status

  • status: verified_backend_and_core
  • FE dialog and action flow checked from AIGreetingModal.tsx
  • admin-side greeting routes and core resource or settings persistence traced
Field dictionary

Fields

field

Target Language

Language for preview, delete, and generation actions currently performed from the dialog.

Data Type
string
Editable
true
field

Target Countries

Country list included in the next preview or generation workflow.

Data Type
string-list
Editable
true
field

Countries per Run

Limits how many selected countries are processed in one run from the current action.

Data Type
integer
Editable
true
Caveats
The FE input advertises a recommended range of `1..20`, but the actual generate request simply takes the first `batchSize` countries from the current selection.
field

Prompt Template

Base instruction used when the AI service creates or previews greeting content.

Data Type
text
Editable
true
Caveats
`Reset Template` resets this field to the FE hardcoded default prompt, not to the currently saved system-settings value.
field

Coverage statistics

Shows how much greeting coverage already exists across configured countries and languages.

Data Type
metric-set
Editable
false
field

Cron renew Enabled / disabled

Indicates whether the scheduled greeting-renewal process is enabled.

Data Type
status-chip
Editable
false
field

Renews every X days

Renewal cadence used by the scheduled greeting-refresh workflow.

Data Type
integer
Editable
false
field

Users

Number of users with country data contributing to the country-distribution summary.

Data Type
integer
Editable
false
field

Countries

Number of countries currently represented in user data and therefore eligible for greeting generation.

Data Type
integer
Editable
false
field

Renewal progress

Inline tracker for one long-running `Renew All Countries & Languages` run.

Data Type
progress-state
Editable
false
field

Total Possible

Total country-language combinations that could contain generated greeting content.

Data Type
integer
Editable
false
field

Generated

Number of combinations that already have generated greeting content.

Data Type
integer
Editable
false
field

Missing

Number of combinations still missing generated content.

Data Type
integer
Editable
false
field

Overall Coverage

Global coverage percentage across all country-language combinations.

Data Type
percentage
Editable
false
field

Mobile coverage

Coverage percentage for generated mobile greeting content.

Data Type
percentage
Editable
false
field

Desktop coverage

Coverage percentage for generated desktop greeting content.

Data Type
percentage
Editable
false
field

User Distribution by Country

Top-country distribution card set used to decide which countries matter most for the next run.

Data Type
record-list
Editable
false
field

Language Coverage

Per-language generated, missing, and coverage rows across active locales.

Data Type
record-list
Editable
false
field

Available variables

Prompt placeholders operators can copy into the template, including `{country}`, `{language}`, and `{date}`.

Data Type
token-list
Editable
false
field

Preview Result

One-off generated result shown before a full run, split into mobile and desktop versions.

Data Type
preview-record
Editable
false
Caveats
Preview uses the first selected country, or `US` when no country is currently selected.
field

Recent Generated Greetings

Latest greeting results shown for review after generation or renewal, including locale, country, generated time, expiry, and mobile or desktop content.

Data Type
record-list
Editable
false
field

Activity Log

Recent AI greeting actions displayed for operator audit context inside the dialog.

Data Type
log-list
Editable
false
Operational notes

Notes

item

FE mapping confirms the AI greeting manager dialog, statistics and coverage cards, inline renewal progress tracker, prompt save action, preview flow, selected-country generation flow, locale delete action, recent-results panel, and activity-log view.

item

Admin greeting actions call `gs-admin-backend`, while the generated content is persisted and published through core resources.

item

The preview and recent-results panels both expose mobile and desktop content variants, while the currently mounted FE does not expose a visible manual device-toggle control.

item

`Reset Template` restores the FE hardcoded default prompt string, not the current `systemSettings.personalizedGreetingMessage.prompt` value.

item

`Generate Greetings` trims the selected country array with `selectedCountries.slice(0, batchSize)`, while `Preview Generated Greeting` uses only the first selected country or `US` as fallback.

item

`Refresh Data` reloads both statistics and available countries, while the small country-selector refresh icon only reloads the country inventory.

Related references

Related pages

pageCMS / Country Message

Operator guide for the AI greeting manager used to configure, preview, generate, renew, and clear country-specific greeting messages.

pageActivity Tag Rules / Detail

Rule inspection page with backend identity, conditions, timestamps, impact estimate, run action, delete action, and recent application history.

pageAffiliate Payment Settings / Detail

Saved affiliate payment-setting detail page for reviewing one configured record.

pageAffiliate Settings / Detail

Saved affiliate detail workspace for reviewing one affiliate and opening report actions.

pageAuto Tags Manager / Detail

Edit surface for one existing auto-tag rule, using the same dynamic rule builder as create but with a persisted rule payload and ID-backed updates.

pageAutomatic Withdrawal / Detail

Management workspace for automatic withdrawal, combining the rules register with processed history and the non-qualified withdrawal queue.