simulated_customers¶

simulated_customers is a handbook-based generator of synthetic customers. A run produces state changes, transactions, product usage, and behavioral events for a cohort.

The process runs locally. It keeps a per-run database as its own copy of what it generated, then posts accounts and events to the cluster gateway. That local database is not the cluster record. The cluster accepts or rejects each post on its own.

The generator is deterministic for a given seed. Event payloads follow schemas that live with the simulator. The superproject checks that the pinned simulator and the pinned cluster still agree on those schemas.

This page does not describe how to operate a live cohort or how to change data already stored in the cluster.