gym pass api

Gym-Pass API 2.0

API untuk pengelolaan check-in di gym, dibuat di .NET 8 adalah rekreasi API lama yang dibuat di Node.Js. Dimungkinkan untuk mengelola pusat kebugaran, cek dan informasi pengguna, menangani konsep -konsep seperti CQRS, RBAC, DDD dan pangeran solid.

Teknologi bekas

• .Net 8
• Asp.net
• Xunit (pengujian unit)
• Inti Kerangka Entitas
• Swagger (dokumentasi API)

Konsep yang digunakan

• Domain-Driven Design (DDD)
• Prinsip yang solid
• Control Acess Berbasis Peran (RBAC)
• Perintah Kueri Segregation (CQRS)

User

Metode	Jalur	Tindakan
Pos	/API/V1/Daftar	Melakukan pendaftaran pengguna baru
Pos	/API/V1/Sesi	Melakukan otentikasi pengguna
Mendapatkan	/API/V1/Pengguna/Profil	Menyelamatkan informasi pengguna

Gyms

Metode	Jalur	Tindakan
Pos	/API/V1/GYMS	Daftarkan gym baru (hanya admin)
Mendapatkan	/API/V1/terdekat	Cari akademi Proxmia berdasarkan lokasi pengguna
Mendapatkan	/API/V1/Cari	Cari akademi

Check-Ins

Metode	Jalur	Tindakan
Pos	/API/V1/check-in	Melakukan pendaftaran check-in baru
Mendapatkan	/API/V1/check-in/user/: userid/history	Menyelamatkan riwayat check-in pengguna
Mendapatkan	/API/V1/check-in/user/: userid/metrics	Menyelamatkan metrik check-in pengguna
Tambalan	/API/V1/check-in/: checkinid/validasi	Memvalidasi check-in saat Anda tiba di gym

Aplikasi dengan DDD di .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. Domain

• Jenis Proyek: Perpustakaan Kelas

• Tanggung jawab: Berisi aturan bisnis mendasar dan logika pusat sistem, termasuk entitas, objek nilai, agregat dan layanan domain.

2. Dibagikan

• Jenis Proyek: Perpustakaan Kelas

• Tanggung jawab: Berisi komponen yang dapat digunakan kembali di seluruh aplikasi, seperti DTT, peristiwa domain, pengecualian umum, dll.

3. Infra (infrastruktur) dan aplikasi

<<<<<< Kepala

• Infrastruktur: ========
• Infrastruktur:

Asal/Utama - Jenis Proyek: Perpustakaan Kelas

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

<<<<<< Kepala

• Aplikasi: =======
• Aplikasi:

Asal/Utama

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

• Jenis Proyek: WebAPI

• Tanggung jawab: Tunjukkan titik akhir HTTP untuk pelanggan eksternal, seperti aplikasi ujung depan atau layanan lainnya. Termasuk pengontrol yang menerima permintaan HTTP dan mengatur eksekusi perintah dan konsultasi.

RF (persyaratan fungsional)

• Harus dimungkinkan bagi pengguna untuk mendaftar;
• Harus dimungkinkan bagi pengguna untuk mengotentikasi;
• Harus dimungkinkan untuk mendapatkan profil pengguna yang dicatat;
• Harus dimungkinkan untuk mendapatkan nomor check-in yang dibuat oleh pelanggan yang dicatat;
• Harus dimungkinkan bagi pelanggan untuk mencari pusat kebugaran dekat;
• Harus dimungkinkan bagi pengguna untuk mencari pelanggan dengan nama;
• Harus dimungkinkan bagi pelanggan untuk check -in di gym;
• Seharusnya dimungkinkan untuk memvalidasi check-in pelanggan;
• Harus dimungkinkan untuk mendaftarkan gym;
• Harus dimungkinkan bagi pelanggan untuk mendapatkan riwayat check-in mereka
• Harus dimungkinkan untuk mendapatkan jumlah check-in yang dibuat oleh pelanggan yang masuk

RN (aturan bisnis)

• Pengguna tidak boleh mendaftar dengan email duplikat;
• Pengguna tidak dapat melakukan 2 check-in pada hari yang sama;
• Pengguna tidak boleh check -in jika tidak menutup (100 meter) dari gym;
• Check-in hanya dapat divalidasi hingga 20 menit setelah dibuat;
• Check-in hanya dapat divalidasi oleh administrator;
• Gym hanya daya yang didaftarkan oleh administrator;

RNF (persyaratan nonfungsional)

• Kata sandi pengguna perlu dienkripsi
• Data aplikasi perlu bertahan di SQL BACNO Postgres;
• Semua daftar data harus menjadi halaman dengan 20 item per halaman;
• Pengguna harus dinominasikan oleh token JWT (JSON Web token);