Cdp Lite Adapter

Adapt the User Explorer (CDP-lite) prototype to new data sources by mapping input exports to the build pipeline, updating adapters/enrichments, and preserving output JSON schemas for the UI. Use when asked to connect real data, replace inputs, or modify the build outputs/UI contracts.

majiayu000 9c9de01 2 files · 2.1 KB Updated 567 repo stars

File contents

CDP-lite Adapter

Overview

Map new data sources into the existing CDP-lite build pipeline while keeping output schemas stable for the UI.

Workflow

  1. Identify input formats and field names for activity + profiles.
  2. Update adapters to normalize into the expected fields.
  3. Adjust enrichments (score/segments) only if business rules change.
  4. Run make build and validate data/ outputs against the UI contract.

Adapter Targets

  • scripts/adapters/activity.js
    • Normalize to: email, date, login, total_views, unique_views, dashboard_name (optional)
  • scripts/adapters/profiles.js
    • Normalize to: email, name, department, geo, title, manager_email, skip_level_email

Output Contract

Preserve the output schemas in:

  • data/users/u_<sha1>.json
  • data/index.json
  • data/facets.json
  • data/dashboards.json

For field-level details, read references/data-contract.md.

Notes

  • Weekly activity must include every week from 2025-06-01 to today, Monday week start.
  • Email is the primary key; always normalize to lowercase + trim.
  • Keep activity_score_bucket in the index for filtering.

majiayu000/claude-skill-registry-data/tree/main/data/cdp-lite-adapter commit 9c9de0123a

Frequently asked questions

npx skillmds add majiayu000/cdp-lite-adapter