Ποιες είναι οι βέλτιστες πρακτικές για τον σχεδιασμό ενός GraphQL schema;

Question

IT Interview Practice · Accepted Answer

Ένα καλό schema είναι **καθοδηγούμενο από τον client, nullable-by-default στα άκρα και εξελίξιμο χωρίς εκδόσεις**. Μοντελοποιεί το domain με όρους που πραγματικά χρησιμοποιούν οι clients, όχι με τους πίνακες της βάσης δεδομένων σου.

## Nullability

Κάνε ένα πεδίο non-null (`!`) μόνο όταν μπορείς *πάντα* να το επιστρέψεις. Η υπερβολική χρήση του `!` είναι παγίδα: αν ένα non-null πεδίο σφάλλει, μηδενίζει ολόκληρο το parent αντικείμενό του, μετατρέποντας μια μικρή αποτυχία σε ένα μεγάλο κενό. Προτίμησε το nullable για οτιδήποτε εξαρτάται από ένα downstream service.

```graphql
type User {
  id: ID!             # truly always present
  email: String!      # required in your DB -> safe as non-null
  avatarUrl: String   # comes from an external service -> nullable, so its failure is isolated
}
```

## Ονοματοδοσία & inputs

- Χρησιμοποίησε συνεπή, περιγραφικά ονόματα· τα booleans διαβάζονται ως κατηγορήματα (`isPublished`).
- Δώσε σε κάθε mutation έναν μοναδικό τύπο **`input`** και επίστρεψε έναν τύπο **payload** — μπορείς να προσθέσεις πεδία αργότερα χωρίς να σπάσεις την υπογραφή.

```graphql
input CreatePostInput { title: String!, body: String! }
type CreatePostPayload { post: Post!, errors: [UserError!]! }  # room to grow
type Mutation { createPost(input: CreatePostInput!): CreatePostPayload! }
```

## Εξέλιξη χωρίς versioning

Το GraphQL αποφεύγει τα `/v2` URLs. Εξελίσσεσαι **προσθετικά**: πρόσθεσε πεδία ελεύθερα, και απόσυρε τα παλιά με `@deprecated` καθώς οι clients μεταναστεύουν.

```graphql
type User {
  fullName: String!
  name: String! @deprecated(reason: "Use fullName")   # keep serving until clients move off
}
```

Η αφαίρεση ή η μετονομασία ενός πεδίου είναι η μόνη πραγματική breaking change, οπότε σχεδίασε έτσι ώστε σπάνια να τη χρειάζεσαι. Απόφυγε επίσης να διαρρέεις τη μορφή της DB (εξέθεσε `fullName`, όχι `first_name`/`last_name` αν οι clients θέλουν ένα ενιαίο πεδίο).

## Γιατί έχει σημασία

Αυτές οι επιλογές είναι που ξεχωρίζουν ένα schema που κρατά χρόνια από ένα που οι clients παλεύουν εναντίον του. Οι συνεντευκτές το χρησιμοποιούν για να μετρήσουν την **ωριμότητα στον σχεδιασμό API** — ειδικά το trade-off nullability/σφαλμάτων και τη νοοτροπία της προσθετικής εξέλιξης, που είναι μοναδικά στο GraphQL.

Nullability

Ονοματοδοσία & inputs

Εξέλιξη χωρίς versioning

Γιατί έχει σημασία

Σχετικές ερωτήσεις