Détail des couches #202

NerOcrO · 2024-11-19T10:29:44Z

NerOcrO
Nov 19, 2024
Maintainer

Nommage (PascalCase) : LeNomDeLaPageController
Type : une fonction
Dépendance : components, gateways, presenters et use-cases
Input : un params ou searchParams ou rien
Fonction
- valide les searchParams et les params parce que l’utilisateur peut les bidouiller
- composition de dépendance le loader (+ query) + presenter + component
Output : un component
Commentaire : on y défini le title unique de la page

Nommage (Majuscule) : GET
Type : une fonction
Dépendance : gateways et use-cases
Input : une request
Fonction
- vérifie que l'on est authentifié
- valide les request.nextUrl.searchParams parce que l’utilisateur peut les bidouiller
- composition de dépendance le loader (+ query)
Output : un json

Nommage (PascalCase) : UseCaseAction
Type : une fonction
Dépendance : domain, gateways et use-cases
Input : un actionParams ou rien
Fonction
- valide les actionParams s’ils existent avec zod parce que l’utilisateur peut les bidouiller
  - les erreurs ne sont pas encore utilisées
- invalide le cache de la page appelante au besoin
- exécute la command en injectant son repository pour écrire en base de données
Output : un Result (un tableau de message d’erreur ou ok)
- les erreurs ne sont pas encore utilisées
Commentaire : elle est injectée dans ClientContext plutôt qu'appelée directement dans un component

Nommage (PascalCase) : LeNomDeLaPage, LeNomDuComposant
Type : une fonction
Dépendance : components et presenters
Input : un ViewModel
Fonction : il doit être bête, aucune logique métier sauf celle liée au composant
Output : du tsx

Nommage (PascalCase) : LeNomDeLObjetMetier
Type : une classe qui étend Entity ou ValueObject
Dépendance : domain
Input : rien
Fonction :
- on y met toute la logique liée à un objet/entité métier
- doit être pur, interdication d'y mettre des choses aléatoires du genre new Date(), Math.random, ...
- c'est la factory de l'objet qui instancie les value objects et retourne une erreur si une validation n'est pas passée
- il y a un getter qui s'appelle state pour avoir l'état de l'objet
Output : un state et des méthodes métier

Nommage (PascalCase) : ImplementationTechniqueDomain(Loader|Repository|Gateway)
Type : une classe qui implémente une interface de use-cases
Dépendance : domain, use-cases
Input : un client Prisma et autres au besoin
Fonction :
- loader : aucune logique métier, requête la base de données ou appel un système externe et transforme le Record en ReadModel
- repository : aucune logique métier, ça prend en paramètre un objet métier pour l’écrire en base de données et renvoie rien ou une indication si ça c’est mal passé
Output
- Loader (lecture) : un ReadModel
- Repository (écriture) : un ou plusieurs objets du domain
- Gateway : à définir

Nommage (CamelCase) : leNomDeLaPageController
Type : une fonction
Dépendance : aucune
Input : un ReadModel
Fonction : aucune logique métier, transforme le ReadModel en ViewModel pour remplir les trous d’un component
Output : un ViewModel

Nommage (PascalCase) : LaRegleMetier
Type : une classe qui implémente CommandHandler
Dépendance : domain
Input : un repository et une Comand (Struct)
Fonction :
- on y met toute la logique liée à une règle métier pour écrire en base de données
- doit être pur, interdication d'y mettre des choses aléatoires du genre new Date(), Math.random, ...
Output : un Result (un message d’erreur ou ok)
- Les erreurs ne sont pas encore utilisées

Nommage (PascalCase) : LaRegleMetier
Type : une classe qui implémente QueryHandler ou une interface qu’implémente une gateways
Dépendance : domain
Input : un Loader
Fonction :
- orchestre pour la lecture (classe) ou rien (interface)
- doit être pur, interdication d'y mettre des choses aléatoires du genre new Date(), Math.random, ...
Output : un ReadModel (Struct, Date, Set, Map ou primitive uniquement)