Customer Intelligence Platform¶

The Customer Intelligence Platform is a research system for customer data. A simulator creates customers, accounts, and behavioral events. A homelab cluster accepts those records and stores them. A lakehouse reads the daily analytical copy.

This repository is the integration project. It pins the three component repositories, describes how they fit together, and holds the checks that those pins still agree. Component implementation stays in the component repositories.

Running path¶

simulated customers
        |
        v
homelab cluster
        |
        v
lakehouse (read-only)

The simulator posts. The cluster stores, and it is the only writer of the shared analytical snapshot. The lakehouse reads that snapshot.

Pages¶

• Architecture — the three components and what this project owns
• Data flow — from a simulated event to a query
• Components — responsibilities of each repository
• Getting started — how to read and preview this documentation
• Roadmap — planned work, marked as not deployed