mbochniak01
Fix compat, bugs, and types; expand retail KB
e181667
# Retail domain — knowledge base documents
# Retrieved by RAG pipeline, grounded against in faithfulness check
# Each entry: id, title, content (2-4 sentences, retrieval-friendly), tags
documents:
- id: retail_001
title: "Stock Check Process"
content: >
A stock check queries real-time inventory levels for a given product and location.
Results include current quantity on hand, reorder threshold, and last updated timestamp.
If quantity falls below threshold, an out-of-stock alert is automatically triggered.
Stock checks can be initiated manually or scheduled on a recurring basis.
tags: [inventory, stock, availability]
- id: retail_002
title: "Supplier Setup and Onboarding"
content: >
Supplier setup is the process of registering a new vendor in the system before
products can be sourced or orders placed. Required fields include legal entity name,
tax ID, payment terms, and primary contact. Incomplete supplier records block
purchase order creation until all mandatory fields are validated.
tags: [supplier, vendor, onboarding]
- id: retail_003
title: "Compliance Reporting"
content: >
Compliance reports capture a timestamped record of system actions, user decisions,
and policy rule evaluations for regulatory and internal audit purposes.
Reports are immutable once generated and stored for a minimum of seven years.
Access is restricted to users with the Audit role or higher.
tags: [compliance, audit, reporting]
- id: retail_004
title: "Feature Flags and Capability Switches"
content: >
Feature flags (also called capability switches) enable or disable product functionality
per client, region, or user segment without a code deployment.
Each flag has an owner, an activation scope, and an expiry date to prevent flag debt.
Enabling a flag in production requires sign-off from both the product and engineering lead.
tags: [feature-flags, configuration, rollout]
- id: retail_005
title: "Product Catalog Management"
content: >
The product catalog (item registry) is the authoritative source of product attributes
including SKU, description, category hierarchy, dimensions, and active status.
Catalog updates sync to all downstream systems within 15 minutes via event stream.
Deactivated products remain in the catalog as archived records and cannot be reactivated
without a manual review.
tags: [catalog, products, SKU]
- id: retail_006
title: "Price Update Workflow"
content: >
Price updates (pricing syncs) must be submitted through the pricing portal and require
approval for changes greater than 15% of the current price.
Approved changes go live at the next scheduled sync window, which runs every four hours.
Emergency price corrections outside the sync window require escalation to the pricing team.
tags: [pricing, price-update, workflow]
- id: retail_007
title: "Store Configuration"
content: >
Each store location has a configuration profile (location profile) that defines
operating hours, supported payment methods, fulfillment capabilities, and
regional compliance rules. Configuration changes take effect at store open
on the following business day. Misconfigured stores are flagged in the daily
operations health report.
tags: [store, configuration, location]
- id: retail_008
title: "Low Inventory Alerts"
content: >
A low inventory signal (out-of-stock alert) fires when a product's on-hand quantity
drops below its configured reorder point. Alerts are routed to the responsible
category manager and the supplying vendor simultaneously. Unacknowledged alerts
escalate to the regional operations lead after 24 hours.
tags: [inventory, alerts, stock]
- id: retail_009
title: "Purchase Order Creation and Approval"
content: >
A purchase order is raised against a validated supplier record once a low inventory
signal or manual restock request is approved. Orders below the auto-approve threshold
are processed immediately; orders above require sign-off from the category manager.
Once approved, the order is transmitted to the supplier and a delivery window is
confirmed within 48 hours.
tags: [purchase-order, procurement, supplier]
- id: retail_010
title: "Reorder Point Calculation"
content: >
The reorder point for a product is calculated as average daily sales multiplied by
supplier lead time, plus a configurable safety stock buffer.
Reorder points are recalculated automatically every 30 days using rolling sales data.
Category managers can override the calculated reorder point with a manual value,
which is flagged for review at the next monthly cycle.
tags: [inventory, reorder, stock-management]
- id: retail_011
title: "Planogram Compliance and Shelf Execution"
content: >
A planogram defines the exact shelf position, number of facings, and display order
for every SKU in a store section. Stores are audited against the current planogram
quarterly; deviations are logged in the compliance report and assigned a correction
deadline. Repeated non-compliance triggers an escalation to the regional operations lead
and may result in a store configuration review.
tags: [planogram, compliance, merchandising, shelf]
- id: retail_012
title: "Product Substitution and Alternate SKU Policy"
content: >
When a primary SKU is unavailable, the system can suggest an approved substitute
from the same category based on margin, availability, and customer rating.
Substitutions must be pre-approved in the item registry and flagged in the
availability scan result. Unapproved substitutions are blocked at the point of
fulfillment and require category manager sign-off before proceeding.
tags: [substitution, SKU, availability, catalog]
- id: retail_013
title: "Supplier Performance and Scorecard"
content: >
Supplier performance is tracked across four dimensions: on-time delivery rate,
order fill rate, invoice accuracy, and response time to low inventory signals.
Scorecards are generated monthly and shared with the supplier via the merchant
onboarding portal. Suppliers falling below the minimum threshold on two or more
dimensions for three consecutive months are placed on a performance improvement plan.
tags: [supplier, performance, scorecard, vendor]
- id: retail_014
title: "Pricing Sync Rollback Procedure"
content: >
If a pricing sync introduces an erroneous price, the pricing team can initiate a
rollback within 30 minutes of the sync window closing. Rollbacks restore the
last confirmed price for affected SKUs and generate an audit trail entry.
Any orders placed at the incorrect price during the affected window are flagged
for manual review and customer communication if required.
tags: [pricing, rollback, audit, error-handling]
- id: retail_015
title: "New Product Introduction Process"
content: >
Introducing a new product requires creating a complete item registry entry with
all mandatory attributes before the SKU can be included in a purchase order.
The product must be assigned to a planogram section and a reorder point configured
before the first stock arrives. New products are excluded from availability scans
until the first inventory receipt is confirmed in the system.
tags: [new-product, catalog, onboarding, SKU]
- id: retail_016
title: "Store Operations Health Report"
content: >
The daily operations health report summarises open low inventory signals, unacknowledged
alerts, misconfigured location profiles, and planogram deviations across all stores.
It is generated automatically at 06:00 local time and distributed to regional operations
leads and category managers. Items unresolved after 48 hours are escalated and highlighted
in the following day's report.
tags: [operations, health-report, alerts, store]
- id: retail_017
title: "Capability Switch Governance"
content: >
Each capability switch must have a documented owner, a defined activation scope
(client, region, or user segment), and a sunset date set at the time of creation.
Switches that have passed their sunset date are automatically disabled and logged
in the audit trail. Reactivating an expired switch requires a new approval cycle
identical to the original enablement process.
tags: [feature-flags, governance, configuration]
- id: retail_018
title: "Bulk Price Update and Seasonal Pricing"
content: >
Bulk price updates affecting more than 50 SKUs in a single submission require
a two-stage approval: category manager approval followed by finance sign-off.
Seasonal pricing campaigns can be scheduled in advance with a defined activation
and expiry date, after which prices revert automatically to the standard pricing sync.
All bulk updates are recorded in the audit trail with the submitting user and
approval timestamps.
tags: [pricing, bulk-update, seasonal, approval]
- id: retail_019
title: "Inventory Reconciliation"
content: >
Inventory reconciliation compares the system's recorded on-hand quantity against
a physical count or warehouse scan to identify shrinkage, receiving errors, or
system discrepancies. Reconciliations are mandatory after every supplier delivery
and at month-end close. Discrepancies above the tolerance threshold are escalated
to the loss prevention team and logged in the compliance report.
tags: [inventory, reconciliation, shrinkage, compliance]
- id: retail_020
title: "What the System Can Help With"
content: >
This assistant answers operational questions about stock and inventory management,
supplier setup and performance, product catalog and item registry, pricing workflows,
store configuration, planogram compliance, feature flags, and low inventory alerts.
It uses only information from the configured knowledge base and will say so clearly
if a question falls outside that scope. For questions about specific live stock levels
or order status, initiate an availability scan through the operations portal.
tags: [capabilities, scope, help, onboarding]