gym pass api

Gym-Pass API 2.0

API สำหรับการจัดการการเช็คอินในโรงยิมที่ทำใน. NET 8 เป็นสันทนาการของ API เก่าที่ผลิตใน Node.Js. เป็นไปได้ที่จะจัดการโรงยิมตรวจสอบและข้อมูลผู้ใช้ที่อยู่แนวคิดเช่น 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/ใกล้เคียง	ค้นหา ProxMia Academies ตามตำแหน่งของผู้ใช้
รับ	/api/v1/ค้นหา	ค้นหาสถาบันการศึกษา

Check-Ins

วิธี	เส้นทาง	การกระทำ
โพสต์	/api/v1/check-ins	ดำเนินการลงทะเบียนการเช็คอินใหม่
รับ	/api/v1/check-ins/user/: userid/ประวัติ	ช่วยชีวิตการเช็คอินของผู้ใช้
รับ	/api/v1/check-ins/user/: userid/metrics	ช่วยตัวชี้วัดการเช็คอินของผู้ใช้
แพทช์	/api/v1/check-ins/: checkinid/ตรวจสอบ	ตรวจสอบการเช็คอินเมื่อคุณมาถึงโรงยิม

แอปพลิเคชันที่มี DDD ใน. 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. โดเมน

• ประเภทโครงการ: ไลบรารีคลาส

• ความรับผิดชอบ: มีกฎพื้นฐานทางธุรกิจและตรรกะส่วนกลางของระบบรวมถึงนิติบุคคลวัตถุค่ารวมและบริการโดเมน

2. ร่วมกัน

• ประเภทโครงการ: ไลบรารีคลาส

• ความรับผิดชอบ: มีส่วนประกอบที่นำกลับมาใช้ใหม่ได้ตลอดแอปพลิเคชันเช่น DTTs, เหตุการณ์โดเมน, ข้อยกเว้นทั่วไป ฯลฯ

3. Infra (โครงสร้างพื้นฐาน) และแอปพลิเคชัน

<<<<<< หัว

• โครงสร้างพื้นฐาน: =======
• โครงสร้างพื้นฐาน:

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;
• รายการข้อมูลทั้งหมดต้องเป็นหน้าด้วย 20 รายการต่อหน้า
• ผู้ใช้จะต้องได้รับการเสนอชื่อโดยโทเค็น JWT (โทเค็นเว็บ JSON);