Profiles
A profile represents one person: a name, a slug, a visibility, and a set of typed attribute records drawn from every source you have. It can link to a security identity — or stand alone as a record for someone who hasn't signed in yet.
Attribute records
Each piece of what you know about a person is its own record — a typed value plus the metadata that says how much to trust it. When two sources disagree, both records are kept — each carrying the priority and confidence to weigh it by.
Attribute types
An attribute type declares a kind of data a profile can hold — a stable, dot-namespaced id, a display name, and a default visibility. The data lives on the profile; the type says what shape it takes.
{
"id": "bosca.recommendations.learned_interest",
"name": "Learned Interest",
"visibility": "system",
"protected": true
}Identity
A profile can link to a security principal — the sign-in identity that carries credentials, groups, and devices. One principal can own several profiles, with a primary one returned at sign-in, so a person can wear different hats without a second account.
Visibility
A profile and each individual record carry their own visibility, so a public display name and a system-only note sit on the same person without leaking.
Keep exploring