at.rolld.rating

rolld.at

Documentation

The user's grade for a game. Single overwritable record per game (BGG id in the record key); re-rating replaces it, no history kept in v1. Scale is 1-10 to align with BGG's community average you already hydrate.

main record

The user's grade for a game. Single overwritable record per game (BGG id in the record key); re-rating replaces it, no history kept in v1. Scale is 1-10 to align with BGG's community average you already hydrate.

Record Key any Any valid record key

Properties

bskyPostRef ref com.atproto.repo.strongRef Optional

Strong ref to a companion app.bsky.feed.post, if the user shared this rating on Bluesky. Links back to the per-entry permalink (/@<handle>/rating/<rkey> — note rating rkey is the BGG id). Enables Bluesky replies as discussion later.

content union Optional

Optional rich review of the game. Same model as at.rolld.play: open union (bring-your-own-content), v1 accepts markpub Markdown, render via $type with textContent as fallback. Replaces the earlier plain 'review' string so play and rating share one note shape.

Known types:
createdAt string datetime Required

When last rated. Doubles as ratedAt since the record is overwritten in place.

rating integer Required

Grade from 1 (worst) to 10 (best).

minimum: 1maximum: 10
target string uri Required

The canonical per-game URL (https://rolld.at/g/<bggId>) — the SAME frozen target the play record uses. Present so ratings are Constellation-discoverable by game (the community-wide 'what does rolld rate this game' + 'follows' reviews of this game' queries, D-39). Identical format and shared helper as play.target (D-9). FROZEN format. The targeted 'did this specific follow rate it' lookup uses getRecord by rkey (= BGG id) instead; target powers the open-ended who-rated-this queries.

textContent string Optional

Plain-text rendering of `content`, always populated when `content` is present. Universal fallback + search/preview field. No grapheme limit.

maxLength: 100000 bytes
View raw schema 
{
  "key": "any",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "game",
      "target",
      "rating",
      "createdAt"
    ],
    "properties": {
      "game": {
        "ref": "at.rolld.defs#gameRef",
        "type": "ref"
      },
      "rating": {
        "type": "integer",
        "maximum": 10,
        "minimum": 1,
        "description": "Grade from 1 (worst) to 10 (best)."
      },
      "target": {
        "type": "string",
        "format": "uri",
        "description": "The canonical per-game URL (https://rolld.at/g/<bggId>) — the SAME frozen target the play record uses. Present so ratings are Constellation-discoverable by game (the community-wide 'what does rolld rate this game' + 'follows' reviews of this game' queries, D-39). Identical format and shared helper as play.target (D-9). FROZEN format. The targeted 'did this specific follow rate it' lookup uses getRecord by rkey (= BGG id) instead; target powers the open-ended who-rated-this queries."
      },
      "content": {
        "refs": [
          "at.markpub.markdown"
        ],
        "type": "union",
        "description": "Optional rich review of the game. Same model as at.rolld.play: open union (bring-your-own-content), v1 accepts markpub Markdown, render via $type with textContent as fallback. Replaces the earlier plain 'review' string so play and rating share one note shape."
      },
      "createdAt": {
        "type": "string",
        "format": "datetime",
        "description": "When last rated. Doubles as ratedAt since the record is overwritten in place."
      },
      "bskyPostRef": {
        "ref": "com.atproto.repo.strongRef",
        "type": "ref",
        "description": "Strong ref to a companion app.bsky.feed.post, if the user shared this rating on Bluesky. Links back to the per-entry permalink (/@<handle>/rating/<rkey> — note rating rkey is the BGG id). Enables Bluesky replies as discussion later."
      },
      "textContent": {
        "type": "string",
        "maxLength": 100000,
        "description": "Plain-text rendering of `content`, always populated when `content` is present. Universal fallback + search/preview field. No grapheme limit."
      }
    }
  },
  "description": "The user's grade for a game. Single overwritable record per game (BGG id in the record key); re-rating replaces it, no history kept in v1. Scale is 1-10 to align with BGG's community average you already hydrate."
}

Lexicon Garden

@