gym pass api

API de gym-pass 2.0

L'API pour la gestion de l'enregistrement dans les gymnases, fabriquée dans .NET 8 est la recréation d'une ancienne API fabriquée dans Node.js. Il est possible de gérer les gymnases, les chèques et les informations des utilisateurs, de s'adresser aux concepts tels que CQRS, RBAC, DDD et Solid Princes.

Technologies utilisées

• .Net 8
• Asp.net
• Xunit (test unitaire)
• Noyau de cadre d'entité
• Swagger (documentation de l'API)

Concepts utilisés

• Conception axée sur le domaine (DDD)
• Principes solides
• Contrôle ACESS basé sur les rôles (RBAC)
• Sélection de la responsabilité des requêtes de commande (CQRS)

User

Méthode	Chemin	Action
Poste	/ Api / v1 / registre	Effectue l'enregistrement d'un nouvel utilisateur
Poste	/ Api / v1 / session	Effectue l'authentification de l'utilisateur
Obtenir	/ Api / v1 / utilisateur / profil	Sauvegarder les informations des utilisateurs

Gyms

Méthode	Chemin	Action
Poste	/ Api / v1 / gymnase	Enregistrez un nouveau gymnase (seul administrateur)
Obtenir	/ Api / v1 / à proximité	Recherchez les académies de proxmie en fonction de l'emplacement de l'utilisateur
Obtenir	/ Api / v1 / recherche	Rechercher des académies

Check-Ins

Méthode	Chemin	Action
Poste	/ Api / v1 / chèques	Effectue l'enregistrement d'un nouveau enregistrement
Obtenir	/ Api / v1 / chèques / user /: userId / Historique	Sauve l'historique des enregistrements de l'utilisateur
Obtenir	/ API / V1 / Check-inins / User /: UserID / Metrics	Sauve les métriques des enregistrements de l'utilisateur
Correctif	/ Api / v1 / check-inins /: checkinid / valider	Valide un enregistrement à votre arrivée au gymnase

Application avec DDD dans .NET C #

 /src
  /Domain
    - Biblioteca de Classes
    - Entidades, Agregados, Repositórios (Interfaces), Serviços de Domínio
  /Application
    - Biblioteca de Classes
    - Comandos, Consultas, Manipuladores
  /Infrastructure
    - Biblioteca de Classes
    - Persistência, Repositórios (Implementações), Serviços Externos
  /Shared
    - Biblioteca de Classes
    - DTOs, Eventos, Exceções Comuns
  /API
    - WebAPI
    - Controladores, Configuração de Roteamento

1. Domaine

• Type de projet: bibliothèque de classe

• Responsabilité: contient les règles commerciales fondamentales et la logique centrale du système, y compris les entités, les objets de valeur, les agrégats et les services de domaine.

2. Commun

• Type de projet: bibliothèque de classe

• Responsabilité: contient des composants réutilisables dans toute l'application, tels que les DTT, les événements de domaine, les exceptions courantes, etc.

3. Infra (infrastructure) et application

<<<<<< tête

• Infrastructure: =======
• Infrastructure:

Origine / Main - Type de projet: Bibliothèque de classe

 - ***Responsabilidade:*** Implementa componentes de infraestrutura, como persistência de dados (contextos de banco de dados, repositórios concretos), serviços externos e outras dependências que suportam a aplicação.

<<<<<< tête

• Application: =======
• Application:

Origine / Main

 - ***Tipo de Projeto:*** Biblioteca de Classes

- ***Responsabilidade:*** Orquestra a execução das operações de negócio, utilizando comandos e consultas (em uma abordagem CQRS). Esta camada coordena a comunicação entre a camada de domínio e outras camadas.

4. API

• Type de projet: webapi

• Responsabilité: présenter des points de terminaison HTTP pour les clients externes, tels que les applications frontales ou d'autres services. Comprend les contrôleurs qui reçoivent des demandes HTTP et orchestrer l'exécution des commandes et des consultations.

RF (exigences fonctionnelles)

• Il doit être possible pour l'utilisateur de s'inscrire;
• Il devrait être possible pour l'utilisateur de s'authentifier;
• Il devrait être possible d'obtenir le profil d'un utilisateur enregistré;
• Il devrait être possible d'obtenir le numéro d'enregistrement effectué par le client enregistré;
• Il devrait être possible pour le client de chercher des gymnases proches;
• Il devrait être possible pour l'utilisateur de rechercher le client par son nom;
• Il devrait être possible pour le client de s'enregistrer dans un gymnase;
• Il devrait être possible de valider l'enregistrement d'un client;
• Il devrait être possible d'enregistrer un gymnase;
• Il devrait être possible pour le client d'obtenir son historique d'enregistrement
• Il devrait être possible d'obtenir le nombre de chèques fabriqués par le client connecté

RN (règles commerciales)

• L'utilisateur ne doit pas s'inscrire avec un e-mail en double;
• L'utilisateur ne peut pas effectuer 2 enregistrement le même jour;
• L'utilisateur ne doit pas s'enregistrer s'il n'est pas fermé (100 mètres) du gymnase;
• L'enregistrement ne peut être validé que jusqu'à 20 minutes après avoir été créé;
• L'enregistrement ne peut être validé que par les administrateurs;
• Le gymnase uniquement enregistré par les administrateurs;

RNF (exigences non fonctionnelles)

• Le mot de passe de l'utilisateur doit être crypté
• Les données d'application doivent être persistées dans BACNO Postgres SQL;
• Toutes les listes de données doivent être une page avec 20 éléments par page;
• L'utilisateur doit être nominé par Token JWT (token Web JSON);