Cilat janë praktikat më të mira për dizajnin e schema-s GraphQL?

Question

IT Interview Practice · Accepted Answer

Një schema e mirë është **e drejtuar nga klienti, nullable-by-default në skaje, dhe e evoluueshme pa versione**. Ajo e modelon domain-in me terma që klientët i përdorin realisht, jo tabelat e databazës suaj.

## Nullability

Bëje një fushë non-null (`!`) vetëm kur mund ta kthesh *gjithmonë*. Përdorimi i tepërt i `!` është kurth: nëse një fushë non-null jep error, e bën null gjithë objektin parent të saj, duke e kthyer një dështim të vogël në një zbrazëti të madhe. Preferoni nullable për çdo gjë që varet nga një shërbim downstream.

```graphql
type User {
  id: ID!             # vërtet gjithmonë i pranishëm
  email: String!      # i detyrueshëm në DB-në tënde -> i sigurt si non-null
  avatarUrl: String   # vjen nga një shërbim i jashtëm -> nullable, që dështimi i tij të izolohet
}
```

## Emërtimi & input-et

- Përdorni emra konsistentë e përshkrues; boolean-ët lexohen si predikate (`isPublished`).
- Jepini çdo mutation një tip të vetëm **`input`** dhe kthejeni një tip **payload** — mund të shtoni fusha më vonë pa e prishur signature-n.

```graphql
input CreatePostInput { title: String!, body: String! }
type CreatePostPayload { post: Post!, errors: [UserError!]! }  # hapësirë për t'u rritur
type Mutation { createPost(input: CreatePostInput!): CreatePostPayload! }
```

## Evolucioni pa versionim

GraphQL i shmang URL-të `/v2`. Ju evoluoni **në mënyrë additive**: shtoni fusha lirisht, dhe tërhiqni ato të vjetrat me `@deprecated` ndërsa klientët migrojnë.

```graphql
type User {
  fullName: String!
  name: String! @deprecated(reason: "Use fullName")   # vazhdo ta shërbesh derisa klientët të largohen
}
```

Heqja ose riemërtimi i një fushe është i vetmi ndryshim vërtet prishës, prandaj dizajnoni ashtu që rrallë t'ju duhet. Shmangni gjithashtu rrjedhjen e formës së DB-së (ekspozoni `fullName`, jo `first_name`/`last_name` nëse klientët duan një fushë të vetme).

## Pse ka rëndësi

Këto zgjedhje janë ato që ndajnë një schema që zgjat vite nga një me të cilën klientët luftojnë. Intervistuesit e përdorin këtë për të matur **pjekurinë në dizajnin e API-ve** — veçanërisht trade-off-in nullability/error dhe mentalitetin e evolucionit additiv, që janë unike për GraphQL.

Nullability

Emërtimi & input-et

Evolucioni pa versionim

Pse ka rëndësi

Pyetje të ngjashme