gym pass api

ジムパスAPI 2.0

.NET 8で作成されたジムでのチェックインの管理のためのAPIは、node.jsで作られた古いAPIのレクリエーションです。 CQRS、RBAC、DDD、Solid Princesなどの概念に対処し、ジム、チェック、ユーザー情報を管理することが可能です。

使用されたテクノロジー

• .NET 8
• ASP.NET
• Xunit（単位テスト）
• エンティティフレームワークコア
• Swagger（APIドキュメント）

使用された概念

• ドメイン駆動型デザイン（DDD）
• 確固たる原則
• ロールベースのacessコントロール（RBAC）
• コマンドクエリ責任隔離（CQRS）

User

方法	パス	アクション
役職	/API/V1/レジスタ	新しいユーザーの登録を実行します
役職	/API/V1/セッション	ユーザー認証を実行します
得る	/API/V1/ユーザー/プロファイル	ユーザー情報の救助

Gyms

方法	パス	アクション
役職	/API/V1/ジム	新しいジムを登録する（管理者のみ）
得る	/API/V1/近く	ユーザーの位置に基づいて、プロクスミアアカデミーを検索します
得る	/API/V1/検索	アカデミーを検索します

Check-Ins

方法	パス	アクション
役職	/API/V1/チェックイン	新しいチェックインの登録を実行します
得る	/API/V1/CHECK-INS/USER/：USERID/history	ユーザーのチェックインの履歴を救出します
得る	/API/V1/CHECK-INS/USER/：userID/Metrics	ユーザーのチェックインメトリックを救出します
パッチ	/API/V1/CHECK-INS/：checkinid/validate	ジムに到着したときにチェックインを検証します

.NET C＃でDDDを使用したアプリケーション

 /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. ドメイン

• プロジェクトタイプ：クラスライブラリ

• 責任：エンティティ、バリューオブジェクト、集合体、ドメインサービスなど、システムの基本的なビジネスルールと中心ロジックが含まれています。

2. 共有

• プロジェクトタイプ：クラスライブラリ

• 責任： DTT、ドメインイベント、一般的な例外など、アプリケーション全体に再利用可能なコンポーネントが含まれています。

3. インフラ（インフラストラクチャ）およびアプリケーション

<<<<<<ヘッド

• インフラストラクチャ： =======
• インフラストラクチャー：

Origin/Main-プロジェクトタイプ：クラスライブラリ

 - ***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.

<<<<<<ヘッド

• アプリケーション： =======
• 応用：

起源/メイン

 - ***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

• プロジェクトタイプ： WebAPI

• 責任：フロントエンドアプリケーションやその他のサービスなど、外部顧客向けのHTTPエンドポイントを展示します。 HTTP要求を受け取り、コマンドと相談の実行を調整するコントローラーが含まれます。

RF（機能要件）

• ユーザーが登録できる必要があります。
• ユーザーが認証できるはずです。
• 記録されたユーザーのプロファイルを取得できるはずです。
• 記録された顧客によって作成されたチェックイン番号を取得することが可能であるはずです。
• 顧客が近くのジムを探すことができるはずです。
• ユーザーが名前で顧客を探すことができるはずです。
• 顧客がジムでチェックインできるはずです。
• 顧客のチェックインを検証できるはずです。
• ジムを登録することは可能です。
• 顧客がチェックインの履歴を取得できるはずです
• ログインした顧客によって作成されたチェックインの数を取得することができるはずです

RN（ビジネスルール）

• ユーザーは、重複した電子メールで登録しないでください。
• ユーザーは、同じ日に2つのチェックインを行うことはできません。
• ユーザーは、ジムから近く（100メートル）であればチェックインしてはなりません。
• チェックインは、作成されてから最大20分しか検証できません。
• チェックインは、管理者のみが検証できます。
• 管理者によって登録されたジムのみの電力。

RNF（機能不全の要件）

• ユーザーパスワードを暗号化する必要があります
• アプリケーションデータは、BACNO Postgres SQLで持続する必要があります。
• すべてのデータリストは、1ページあたり20アイテムを持つページである必要があります。
• ユーザーは、Token JWT（JSON Web Token）にノミネートする必要があります。