System Overview

System Overview

HCP uses a hierarchical data model to organize retail operations across multiple organizations and locations.

Data Hierarchy

Organisation
└── Client
    └── Site
        └── SiteProduct
            ├── CountEntry (daily counts)
            ├── SapEntry (SAP data)
            └── Anomaly (auto-detected issues)

Organisations

The top-level entity. Most users belong to one organisation.

Clients

Retail chains or brands within an organisation. Example: Pick n Pay, Checkers.

Sites

Individual retail locations (stores, branches) belonging to a client.

Products

Items tracked by the system. Products are assigned to sites via Site Products.

Entries

• Count Entry — Physical inventory counts from field workers
• SAP Entry — Official inventory data from SAP systems

Daily Workflow

1. Controller visits site — Scans products or selects from list
2. Enters count data — Locker and sales floor quantities
3. Enters SAP data — Inventory and sales figures
4. System evaluates — AnomalyEvaluator runs automatically
5. Anomalies created — Based on configured thresholds
6. Dashboards update — Real-time status visible to managers

Anomaly Detection

The system automatically detects 7 types of issues:

Anomaly	Severity	Condition
Locker Short	ALERT	Negative locker balance
Sales Floor Short	ALERT	Negative sales floor balance
Out of Stock	ALERT	Zero sales floor inventory
High Damages	ALERT	Damages exceed threshold
Short Delivery	WATCH	Delivery below threshold
OSA Breach	WATCH	On-shelf availability % below target
On Shelf Available	OK	Positive sales floor stock

---

Next: Logging In