club.filmclash.comparison Documentation (EN)

main record

A single pairwise preference: the user prefers `winner` over `loser`.

Record Key tid Timestamp-based ID

Properties

createdAt string datetime Required

An RFC 3339 formatted timestamp.

loser ref #work Required

No description available.

session string Optional

Optional id grouping comparisons made in one shuffle/refine or insertion session. Enables UX analytics and active-learning batching.

maxLength: 64 bytes

winner ref #work Required

No description available.

View raw schema

{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "winner",
      "loser",
      "createdAt"
    ],
    "properties": {
      "loser": {
        "ref": "#work",
        "type": "ref"
      },
      "winner": {
        "ref": "#work",
        "type": "ref"
      },
      "session": {
        "type": "string",
        "maxLength": 64,
        "description": "Optional id grouping comparisons made in one shuffle/refine or insertion session. Enables UX analytics and active-learning batching."
      },
      "createdAt": {
        "type": "string",
        "format": "datetime"
      }
    }
  },
  "description": "A single pairwise preference: the user prefers `winner` over `loser`."
}

work object

Identity of a title, by external catalog id. Uses a shared identifier convention for cross-app join compatibility.

Properties

imdbId string Optional

IMDB id, e.g. "tt5950044". Optional but recommended as a stable secondary key.

maxLength: 32 bytes

tmdbId string Required

TMDB id, stored as a string (e.g. "1061474").

maxLength: 32 bytes

type string Required

Open work vocabulary. FilmClash uses movie/tv_show initially; the open set leaves room to extend without a breaking change.

maxLength: 64 bytes

Known values: movie, tv_show, book, game, music

View raw schema

{
  "type": "object",
  "required": [
    "tmdbId",
    "type"
  ],
  "properties": {
    "type": {
      "type": "string",
      "maxLength": 64,
      "description": "Open work vocabulary. FilmClash uses movie/tv_show initially; the open set leaves room to extend without a breaking change.",
      "knownValues": [
        "movie",
        "tv_show",
        "book",
        "game",
        "music"
      ]
    },
    "imdbId": {
      "type": "string",
      "maxLength": 32,
      "description": "IMDB id, e.g. \"tt5950044\". Optional but recommended as a stable secondary key."
    },
    "tmdbId": {
      "type": "string",
      "maxLength": 32,
      "description": "TMDB id, stored as a string (e.g. \"1061474\")."
    }
  },
  "description": "Identity of a title, by external catalog id. Uses a shared identifier convention for cross-app join compatibility."
}