Entités (Neon)

Il y a deux façons de travailler avec des données relationnelles (Neon Postgres) depuis une application PRISM :

1. defineEntity — un générateur d'admin piloté par configuration qui mappe une entité vers un CRUD complet, adossé aux procédures tRPC de company-manager.
2. Accès direct à Neon — le tagged template sql du framework pour des requêtes écrites à la main.

defineEntity

defineEntity mappe une seule entité vers des écrans liste / détail / nouveau / édition plus le CRUD, adossé aux procédures tRPC de company-manager. Il est générique sur les noms des procédures tRPC — une faute de frappe dans un nom de procédure est une erreur de compilation.

Transport et configuration

Le transport tRPC est cmQuery (GET) / cmMutate (POST), issus du cm.ts du kit. La base, le tenant et le site proviennent de configureManage(...), appelé une seule fois comme import à effet de bord :

import { configureManage } from "@bext-stack/manage";

configureManage({
  appId: "<app-id>",
  cmBase: "…",
  host: "…",
  origin: "…",
  tenantId: "…",
  siteId: "…",
});

Le motif de ré-export mince

Hébergez une entité générée en ré-exportant le module d'entité du kit depuis un fichier de route — la route reste un simple shim mince :

// src/app/manage/posts/page.tsx
export { loader, default } from "@bext-stack/manage/entities/posts";

Exemple : la base de connaissances du helpdesk

L'entité KB du helpdesk est une vraie configuration defineEntity reliée à ces procédures :

Comme defineEntity est générique sur ces noms, renommer ou mal saisir l'un d'eux est détecté à la compilation. Voir Helpdesk.

Accès direct à Neon

Pour des requêtes écrites à la main, le framework exporte un helper SQL en tagged template :

import { sql, database, POSTGRES_DIALECT } from "@bext-stack/framework";

const posts = await sql`SELECT id, title FROM posts WHERE tenant_id = ${tenantId}`;

La chaîne de connexion Neon est récupérée une seule fois via une lecture KV en loopback de la clé cm:database_url, de sorte que vous n'avez pas à la configurer dans l'application.

Et ensuite