CDP-lite Adapter
Overview
Map new data sources into the existing CDP-lite build pipeline while keeping output schemas stable for the UI.
Workflow
- •Identify input formats and field names for activity + profiles.
- •Update adapters to normalize into the expected fields.
- •Adjust enrichments (score/segments) only if business rules change.
- •Run
make buildand validatedata/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_bucketin the index for filtering.