Recipes
Recette : CMS de blog
Créez un backend de blog avec :
- Des articles avec contenu Markdown et images de couverture
- Des auteurs avec profils
- Des catégories avec une relation many-to-many
Collections
Section intitulée « Collections »import { defineCollection } from "@rebasepro/cms-types";
export const authorsCollection = defineCollection({ slug: "authors", name: "Authors", singularName: "Author", table: "authors", properties: { name: { type: "string", name: "Name", validation: { required: true } }, email: { type: "string", name: "Email", email: true, validation: { required: true, unique: true } }, avatar: { type: "string", name: "Avatar", storage: { storagePath: "avatars", acceptedFiles: ["image/*"], maxSize: 2 * 1024 * 1024 } }, bio: { type: "string", name: "Bio", admin: { multiline: true } } }, admin: { icon: "person" }});
export default authorsCollection;Catégories
Section intitulée « Catégories »import { defineCollection } from "@rebasepro/cms-types";export const categoriesCollection = defineCollection({ slug: "categories", name: "Categories", singularName: "Category", table: "categories", properties: { name: { type: "string", name: "Name", validation: { required: true } }, slug: { type: "string", name: "Slug", validation: { required: true, unique: true } }, color: { type: "string", name: "Color", enum: [ { id: "blue", label: "Blue", color: "blue" }, { id: "green", label: "Green", color: "green" }, { id: "red", label: "Red", color: "pink" }, { id: "orange", label: "Orange", color: "orange" } ] } }, admin: { icon: "label" }});
export default categoriesCollection;Articles
Section intitulée « Articles »import { defineCollection } from "@rebasepro/cms-types";import { policy } from "@rebasepro/types";import authorsCollection from "./authors";import categoriesCollection from "./categories";// The row shape, so callbacks below see typed `values` instead of `unknown`.type Article = { title: string; slug: string; status: string; publishedAt?: Date | null;};
export const articlesCollection = defineCollection({ slug: "articles", name: "Articles", singularName: "Article", table: "articles", history: true, properties: { title: { type: "string", name: "Title", validation: { required: true } }, slug: { type: "string", name: "URL Slug", validation: { required: true, unique: true } }, author: { type: "relation", name: "Author", relation: { kind: "belongsTo", target: () => authorsCollection, localKey: "author_id" } }, categories: { type: "relation", name: "Categories", relation: { kind: "manyToMany", target: () => categoriesCollection, through: { table: "article_categories", sourceColumn: "article_id", targetColumn: "category_id" } } }, status: { type: "string", name: "Status", enum: [ { id: "draft", label: "Draft", color: "gray" }, { id: "review", label: "In Review", color: "orange" }, { id: "published", label: "Published", color: "green" } ], defaultValue: "draft" }, cover_image: { type: "string", name: "Cover Image", storage: { storagePath: "articles/covers", acceptedFiles: ["image/*"] } }, content: { type: "string", name: "Content", admin: { markdown: true } }, excerpt: { type: "string", name: "Excerpt", admin: { multiline: true }, validation: { max: 300 } }, publishedAt: { type: "date", name: "Published At" }, createdAt: { type: "date", name: "Created At", autoValue: "on_create", admin: { readOnly: true } }, // The signed-in user who created the article, stamped by the server. // `author` is the byline; this is who may keep editing the draft. createdBy: { type: "string", name: "Created by", autoValue: "user_on_create", admin: { readOnly: true } } }, callbacks: { beforeSave: async ({ values, status }) => { // Auto-generate slug if (values.title && !values.slug) { values.slug = values.title .toLowerCase() .replace(/[^a-z0-9]+/g, "-"); } // Set publishedAt when publishing if (values.status === "published" && !values.publishedAt) { // `publishedAt` is a `date` property, so its value is a Date. values.publishedAt = new Date(); } return values; } }, securityRules: [ // Anyone can read published articles { operation: "select", using: "{status} = 'published'" }, // Writers read, create and edit their own articles { operations: ["select", "insert", "update"], ownerField: "createdBy", roles: ["writer"] }, // Editors read and edit every article { operations: ["select", "insert", "update"], roles: ["editor"] }, // Only an editor publishes. Restrictive, so it holds over every rule // above: a writer can neither save an article as published nor edit // one that already is. { operations: ["insert", "update"], mode: "restrictive", condition: policy.or( policy.rolesOverlap(["editor", "admin"]), policy.compare(policy.field("status"), "neq", policy.literal("published")) ) }, { operation: "delete", roles: ["admin"] } ], admin: { icon: "article", defaultViewMode: "table" }});
export default articlesCollection;Qui peut publier
Section intitulée « Qui peut publier »Le flux de travail repose sur le champ status et les règles ci-dessus, et c’est
Postgres qui l’applique, si bien qu’il vaut aussi pour le panneau
d’administration, l’API REST et le SDK :
- Un rédacteur (
writer) crée des articles et fait passer les siens dedraftàreviewet inversement. Enregistrer un article commepublishedest refusé, tout comme modifier un article déjà publié. - Un éditeur lit tous les articles, brouillons compris, et publie.
- Les lecteurs, connectés ou non, ne voient que les articles publiés. Les
lectures anonymes nécessitent
AUTH_REQUIRE=falsesur le backend ; voir Accès public.
writer et editor sont des entrées des roles d’un utilisateur. Si vous êtes
parti du scaffold, ajoutez writer aux options de rôle dans
config/collections/users.ts.
Configuration
Section intitulée « Configuration »- Enregistrez les trois fichiers dans
config/collections/—authors.ts,categories.tsetarticles.ts; chacun doit exporter sa collection par défaut (export par défaut), sinon le démarrage refuse le répertoire. Ajoutez-les au tableaucollectionsdansconfig/collections/index.tspour choisir où ils apparaissent dans la navigation — chaque fichier du répertoire est chargé dans tous les cas. - Avec
rebase deven cours d’exécution, c’est tout : enregistrer régénère le schéma, redémarre le backend, et le démarrage crée les tables, la table de jonction et leurs politiques de sécurité au niveau des lignes. En dehors derebase dev, contre votre propre PostgreSQL, exécutezrebase schema generatepuisrebase db push.
Vous disposez désormais d’un CMS de blog entièrement fonctionnel avec :
- Gestion des auteurs avec téléversement d’avatars
- Étiquetage par catégories via des relations many-to-many
- Édition de contenu Markdown
- Un flux de travail Brouillon → En révision → Publié dans lequel seul un éditeur publie, appliqué par Postgres
- Slugs d’URL générés automatiquement
- Des rédacteurs limités à leurs propres articles, et des brouillons exclus des lectures publiques
- Piste d’audit complète grâce à l’historique des entités
Requêtes depuis le SDK
Section intitulée « Requêtes depuis le SDK »Utilisez le SDK typé pour récupérer les articles avec leurs relations :
// The row shape you expect back — without it every field arrives as `unknown`.type Article = { title: string; status: string; publishedAt?: string | null; authorId: string; author?: { name: string }; categories?: { name: string }[];};
// Fetch published articles with author and categories includedconst { data: articles } = await client.data .collection<Article>("articles") .where("status", "==", "published") .include("author", "categories") .orderBy("publishedAt", "desc") .limit(10) .find();
// Rows come back flat — there is no `values` wrapper on the SDK.for (const article of articles) { console.log(article.title); console.log(article.author?.name); // Hydrated relation console.log(article.authorId); // Scalar FK console.log(article.categories); // Array of related entities}Voir aussi
Section intitulée « Voir aussi »- Définir des collections — l’API de collection utilisée dans cette recette
- Relations — les liaisons d’auteurs et de catégories, en détail
- Règles de sécurité (RLS) — publier sans exposer les brouillons