TRA - Contacts et travail

Description

Agents et Acteurs

Les acteurs ont besoin d’un agent pour les représenter. Ce sont les agents qui approchent les acteurs et qui font une proposition afin de les représenter. Un agent peut représenter plusieurs acteurs.

À chaque tour, un agent fait des demandes à tous les acteurs qui:

• N’ont pas déjà un agent.
• Ont autant ou plus de points de réputation que lui.

Les acteurs croient beaucoup en l’Hamstrologie. Celle-ci stipule que les acteurs vont mieux s’entendre avec les personnages dont la première lettre du nom est la plus proche de la première lettre de leur nom dans l’alphabet (distance Ascii, car case sensitive) (voir exemples plus bas). Si la première lettre est identique, y aller avec celui qui a le plus de points de réputation (Si première lettre identique et même nombre de points de réputation, choisir un agent au hasard. À noter que ce cas ne sera pas testé.). Ils vont donc accepter l’offre de l’agent selon ce critère.

Déroulement lorsqu’un tour est joué:

• Chaque agent fait des demandes à tous les acteurs qui correspondent aux critères plus haut.
• Les acteurs peuvent donc avoir plusieurs demandes d’agent et doivent choisir en utilisant l’Hamstrologie.

RattedIn

Les agents et les avocats peuvent faire des demandes de contact sur le réseau social RattedIn. Leur réseau de contacts leur sera utile plus tard. Si un avocat fait une demande à un agent et que ce dernier accepte, alors l’agent fait partie des contacts de l’avocat et vice versa (l’avocat fait partie des contacts de l’agent). Il n’y a pas de restriction au niveau des professions, c’est-à-dire qu’un agent peut avoir des agents et des avocats parmi ses contacts et vice versa.

Les acteurs ne sont pas sur RattedIn.

Les avocats acceptent toujours toute demande de contact. Alors que les agents sont plus réticents et ne vont accepter que les demandes qui proviennent de personnages qui ont le même nombre de points de réputation ou plus qu’eux (>=).

Les demandes de contact ne sont acceptées/refusées que lorsqu’un tour est joué. Si la demande de contact est refusée, le contact n’apparaitra tout simplement pas dans la liste des contacts.

Puisque les personnages auront éventuellement besoin d’avocats, ces derniers vont changer leur statut à openToWork sur RattedIn afin d’informer leurs contacts qu’ils sont disponibles pour offrir leurs services. Les agents ont toujours un statut d’emploi à N/A.

Lorsqu’un personnage est éliminé:

• Tout ce qui le concerne est effacé:
  • Son profil, donc GET /characters/nomDuPersonnageElimine retournera 404. Il serait possible d’ajouter un personnage avec le même nom qu’un personnage éliminé, mais ce ne sera pas vérifié.
  • S’il possède un compte sur Hamstagram, il sera effacé.
  • S’il possède un compte sur RattedIn, il sera effacé et retiré des contacts sur RattedIn.
  • S’il avait des demandes de contact sur RattedIn, ces demandes sont ignorées.
  • S’il s’agissait d’un agent, tous ses acteurs se retrouvent sans agent.
  • S’il s’agissait d’un acteur qui avait un agent, il sera retiré de la liste des acteurs représenté par l’agent.

Conditions de succès

Introduction de changements majeurs par rapport aux stories précédentes

Ordre des événements lorsqu’un tour est joué

Introduction de changements majeurs par rapport aux stories précédentes

API

Réseau social

Introduction de changements majeurs par rapport aux stories précédentes

Requête

GET /hamstagram/<username>

Réponse

• Ajout du champ represent. Liste des noms des acteurs que l’agent représente, la liste sera vide pour les acteurs.
• Ajout du champ representedBy. Le nom de l’agent de l’acteur sera vide si le personnage est un agent.

{
  "username": ""::string,
  "nbFollowers": 10000::int,
  "represent": [],
  "representedBy": ""::string
}

Exception

Pas de changements.

Demande de contact sur RattedIn

Le nom du personnage est utilisé à titre de username.

Requête

POST /rattedin/<username de celui qui reçoit la demande>/request

{
  "username": ""::string  username du personnage qui fait la demande de contact
}

Réponse

HTTP 200 OK

Exception

Aucune n’est exigée, on ne testera qu’un payload adéquat et que des personnages qui sont déjà sur RattedIn.

Obtenir les informations d’un utilisateur sur RattedIn

Requête

GET /rattedin/<username>

Réponse

HTTP 200 OK

{
  "username": ""::string,
  "status": openToWork | busy | N/A,  => Le statut passera à `busy` plus tard dans le projet.
  "contacts": [] => Liste des usernames
}

Exception

HTTP 404 Not Found

{
  "error": "CHARACTER_NOT_FOUND"::string,
  "description": "Character not found."::string
}