Skip to content

AtlasWhat BrandTrackers knows, in plain language

One clear, verified description of the things we track and how they connect — written to be read by a person or a machine.

What Atlas is

BrandTrackers is a library of brand and marketing work — companies, the content they make, the campaigns they run, and the labels that describe all of it. Over time, the logic of how these pieces fit together has lived in scattered documents and in people's heads, and it kept getting re-explained.

Atlas is the one place that logic lives. It describes each part of the domain in plain words, says how the parts connect, and points to the exact data behind each claim. Read it before making a big decision about how the product is structured.

The four families

Everything we track falls into one of four groups:

  • Entities — the things in the world we follow: companies, people, songs, and artists. Start here →
  • Works and groupings — the containers that gather content together: campaigns, events, projects.
  • Content and moments — the actual creative pieces (posts, videos, pages) and the individual moments inside them.
  • Concepts — the labels we classify against: industry, audience, channel, creative discipline.

The rest of the pillars are being written. Each one follows the same pattern you'll see in Entities: what it is, in plain language; the real numbers; how it connects; and what's still undecided.

How to use this

  • Reading to understand the domain? Start with the pillars above.
  • Building on top of it? The exact tables, columns, and counts are in the data reference, kept separate from the prose on purpose.
  • Curious how the sausage is made? The internal notes hold the build plan, research, and status. They're working documents — not the domain model — and they're labelled that way.

Atlas — the BrandTrackers domain model. Source: git markdown, drift-checked against the live DB.