Identifier les objets de la meilleure API de table de championnat que vous ayez jamais vue !

Dans le dernier texte, nous avons terminé avec une vague idée de ce à quoi pourraient ressembler nos JSON d'entrée et de sortie.

Je suis allé plus loin et j'ai demandé à un LLM de modéliser ces exigences au format JSON, pour que les choses soient encore plus claires. Voyons si cela nous aide ?

{
  "nomeCampeonato": "String",
  "equipes": [
    {
      "id": "Integer",
      "nome": "String",
      "localizacao": "String",
      "grupo": "String",
      "subGrupo: "String"
    },
    ...
  ],
  "formatoCampeonato": {
    "divisaoPorGrupos": Integer,
    "grupos": [
      {
        "id": "Integer",
        "nome": "String",
        "equipes": ["Integer"],

      },
    ],
    "turnosDentroGrupo": "Integer",
    "turnosEntreGrupos": "Integer",
    "sorteioGrupos": "Boolean"
  },
  "calendarioConfig": {
    "tabelaOtimizada": "Boolean",
    "totalJogosPorDia": "Integer",
    "diasDescanso": "Integer"
  }
}

Comprenons ce que le LLM nous a apporté :

• Un objet appelé équipes, contenant le nom de l'équipe et sa localisation ;
• Un objet appelé FormatCampeonato, qui définit en combien de groupes les équipes seront divisées et nous apporte, intégré, un objet groupe ;
• L'objet groupe est l'endroit où les équipes sont organisées. Pensez que dans le Brasileirão, par exemple, nous n'aurions qu'un seul objet comme celui-ci, avec 20 équipes. Chez les Libertadores, nous aurions 8 objets "groupe", avec 4 équipes chacun.
• Dans le format Championnat, nous définissons également si et combien de changements il y aura entre les équipes d'un même groupe et entre les équipes de groupes différents. N'oubliez pas qu'au Paulistão (jusqu'en 2024), par exemple, il existe 4 groupes dans lesquels les équipes jouent un tour contre des équipes d'autres groupes et ne jouent pas contre des équipes de leur propre groupe.
• formatCampeonato définit également si c'est nous qui devrons dessiner les groupes ou si l'utilisateur enverra tout prêt. C'est pourquoi nous avons les champs de groupe et de sous-groupe dans l'objet teams.
• Et, pour finir, l'objet calendrierioConfig, qui définit les enjeux du calendrier, comme le nombre de matchs par jour, le nombre de jours de repos qu'une équipe doit avoir entre un match et un autre et notre "sauce secrète" : l'optimisation des déplacements !

Eh bien, si vous avez un peu étudié l'orientation objet, vous savez que ces objets JSON que nous modélisons ici sont d'excellents candidats pour devenir des classes dans notre code, non ?

Dans le prochain texte, nous analyserons si chaque objet JSON comme celui-ci est éligible pour générer une classe dans notre backend et nous parlerons également un peu de l'architecture de notre Tabelão.

On continue.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!