Search Configuration

The Search Configuration panel is an admin-facing tool for managing the Meilisearch synonym dictionaries that power the Mallnline discovery engine. Malet Owners with the MANAGE_SEARCH permission can create, edit, and delete synonym groups across 7 industry verticals, push changes to the live Meilisearch index, and monitor the index reconciliation status.

NOTE

The Search Configuration is accessed from the Admin Dashboard's Search tab. All synonym mutations require the MANAGE_SEARCH permission, enforced by the backend SynonymResolver.

Architecture

┌──────────────────────────────────────────────────┐
│         Admin Dashboard (+page.svelte)            │
│  Tab: "Search" (lazy-loaded)                      │
│  ┌──────────────────────────────────────────────┐ │
│  │         SearchConfigPanel.svelte              │ │
│  │ ┌──────────────────┐ ┌──────────────────────┐ │ │
│  │ │  Synonym Panel   │ │  Actions Sidebar     │ │ │
│  │ │ (vertical tabs   │ │ (apply, reconcile)   │ │ │
│  │ │  + CRUD table)   │ │                      │ │ │
│  │ └──────────────────┘ └──────────────────────┘ │ │
│  └──────────────────────────────────────────────┘ │
│                      ↕                            │
│     searchConfigStore.svelte.ts (Zod validation)  │
│     searchConfig.ts (GraphQL queries/mutations)   │
└──────────────────────────────────────────────────┘
         ↕ (GraphQL via gateway)
┌──────────────────────────────────────────────────┐
│     search subgraph (SynonymResolver)             │
│     Redis + Meilisearch                           │
└──────────────────────────────────────────────────┘

Store: `searchConfigStore.svelte.ts`

Exports pure functions and constants (no class — GraphQL calls are handled by the component):

Zod validation — validateSynonymInput() validates term + synonyms + vertical
Synonym parsing — parseSynonymString() splits comma-separated input → lowercased array
Vertical constants — ALL_VERTICALS, VERTICAL_LABELS, VERTICAL_ICONS

Queries & Mutations: `searchConfig.ts`

Operation	Query/Mutation	Backend Target
List synonyms	`searchSynonyms(vertical?)`	`SynonymResolver.searchSynonyms`
Create/Update	`setSynonymGroup(input)`	`SynonymResolver.setSynonymGroup`
Delete	`deleteSynonymGroup(input)`	`SynonymResolver.deleteSynonymGroup`
Apply to search	`applySynonyms`	`SynonymResolver.applySynonyms`
Reconciliation status	`reconciliationStatus`	`ReconciliationResolver.reconciliationStatus`
Trigger reconciliation	`triggerReconciliation`	`ReconciliationResolver.triggerReconciliation`

Component: `SearchConfigPanel.svelte`

Two-column layout:

Synonym Panel (left)
- Vertical pill tabs (7 industries with emoji icons)
- Inline add form: term input + comma-separated synonyms + "Add" button
- Synonym table: each row shows term badge + synonym chips + edit/delete buttons
- Inline edit mode: replaces chips with input, Save/Cancel buttons
Actions Sidebar (right)
- Apply to Search card: pushes all synonym groups to Meilisearch
- Reconciliation card: status (running/idle), last run stats, manual trigger button

Verticals

Vertical	Icon	Example Synonyms
General	🌐	shop → store, malet, boutique
Restaurant	🍽️	takeout → takeaway, carry out, to go
Tour & Safari	🏔️	safari → game drive, wildlife tour, bush trip
Photography	📸	session → booking, appointment, sitting
Fashion	👗	clothing → apparel, garments, wear, attire
Wellness	🧘	spa → wellness center, treatment, massage
Entertainment	🎭	concert → show, performance, gig, live music

Each vertical has its own isolated synonym dictionary in Redis (search:synonyms:{VERTICAL}), preventing cross-domain pollution (e.g. "session" in photography doesn't affect restaurant results).

Apply Workflow

When "Apply Synonyms" is clicked:

All synonym groups across all verticals are fetched from Redis
Groups are merged into a bidirectional synonym map
The map is pushed to the Meilisearch index via updateSynonyms()
Success banner shows total groups applied

Reconciliation

The reconciliation system ensures the Meilisearch index stays in sync with MongoDB source data.

Field	Description
`isRunning`	Whether a reconciliation is currently in progress
`lastRunAt`	ISO timestamp of the last completed run
`added`	Documents added to the index
`removed`	Orphaned documents removed
`unchanged`	Documents already in sync
`errors`	Errors encountered during the run
`durationMs`	Total reconciliation duration in milliseconds

File Map

File	Purpose
`src/lib/queries/searchConfig.ts`	GraphQL queries/mutations + TypeScript types
`src/stores/searchConfigStore.svelte.ts`	Zod validation, parsing, vertical constants
`src/lib/components/admin/SearchConfigPanel.svelte`	Two-column admin UI
`src/routes/admin/+page.svelte`	Search tab integration
`tests/searchConfigStore.test.ts`	14 unit tests

Alerts Resilience — Backend DLQ and delivery infrastructure referenced alongside search ops
Admin Analytics Dashboards — Analytics tabs alongside the Search tab in the Admin Dashboard
Alert Templates — Templates tab in the Admin Dashboard
Custom RBAC — MANAGE_SEARCH permission definition