Skip to content

Article Collection Intents

Purpose

This document defines the operating model for article collections managed through article-bff.

Role Of Article Collections

Article collections support:

  • reusable editorial grouping
  • stable selection targets for site pages
  • collection-level name, description, and image metadata
  • member ordering and retrieval for article grids

Retrieval Intent

Use the live article BFF for retrieval:

  • getArticleCollection
  • listArticleCollections

Mutation Intent

Use the live article BFF for mutation:

  • createArticleCollection
  • updateArticleCollection
  • deleteArticleCollection
  • addArticlesToCollection
  • removeArticlesFromCollection
  • replaceArticlesInCollection

Current Contract Shape

The retrievable collection shape should be treated as BFF-first and collection-first, including:

  • collectionKey
  • name
  • description
  • scope
  • image
  • articlesCount
  • articles[]

Operating Rules

  • Collections are first-class BFF-backed objects, not site-local lists.
  • Site docs should reference which collections a site uses, not redefine the collection object.
  • Collection membership changes should be applied through collection mutations, not local surrogate sources.