🏀 Sport Center Reservation API

🏢 Backend API untuk sistem reservasi fasilitas olahraga modern

📊 Arsitektur Cloud

Sistem ini didesain untuk dijalankan di infrastruktur cloud Azure dengan mempertimbangkan high availability, keamanan, dan skalabilitas.

☁️ Komponen Utama

Frontend Tier (High Availability)
- Multiple VM untuk redundansi dan load balancing
- NGINX untuk hosting UI dan proxy ke API
Backend Tier (High Availability)
- Multiple VM untuk redundansi dan load balancing
- Express.js API dengan Node.js
- Clustering dengan PM2 untuk memanfaatkan multi-core
Komponen Express Application
- Routes - Mengelola endpoint API
- Controllers - Logika bisnis untuk autentikasi, pengguna, admin, dan owner
- Middlewares - Validasi, autentikasi, dan error handling
- Repositories - Akses data dengan Prisma ORM
- Socket Handlers - Manajemen koneksi real-time
- Zod Schemas - Validasi request
- Utils - Helper functions
Data Storage
- Azure MySQL Database - Menyimpan data aplikasi
- Azure Blob Storage - Menyimpan file dan gambar
- NodeCache - Caching di memori aplikasi
Keamanan
- Application Gateway
- Network Security Groups
- Azure Firewall
- Key Vault untuk credential management
Monitoring
- Azure Monitor
- Application Insights
DevOps Services
- CI/CD Pipeline
- Source Repositories
- Project Management

🔄 High Availability & Scaling

Load balancer untuk mendistribusikan traffic
Multiple VM instance untuk redundansi
Auto-scaling berdasarkan CPU usage
Clustering dengan PM2 di setiap VM

🔒 Keamanan

Virtual Network (VCN) untuk isolasi
Network Security Groups untuk kontrol akses
Key Vault untuk penyimpanan kredensial
HTTPS enforcement di semua endpoint publik

🌟 Fitur Utama

🔒 Autentikasi & Otorisasi
- JWT-based authentication
- Role-based access control (Super Admin/Branch Admin/User)
- Secure password hashing dengan bcrypt
📅 Manajemen Reservasi
- Real-time booking status via Socket.io
- Pencarian & filter fasilitas olahraga
- Sistem pembayaran terintegrasi dengan Midtrans
- Review dan rating fasilitas
🔔 Notifikasi
- Real-time updates via Socket.io
- Activity log tracking
- Status pembayaran dan booking
📊 Manajemen Cabang
- Multiple branch management
- Analisis pendapatan per cabang
- Manajemen lapangan dan tipe lapangan
- Sistem promosi dan diskon

🛠 Tech Stack

Runtime: Node.js v22.8.0
Language: TypeScript 5.0
Framework: Express.js
Database: MySQL + Prisma ORM
Real-time: Socket.io
Payment Gateway: Midtrans
File Storage: Cloudinary
Security: Helmet, CORS, Rate Limiting
Logging: Winston
Deployment: PM2 dengan clustering

🚀 Quick Start

Prerequisites

# Versi minimum yang dibutuhkan
Node.js >= v22.8.0
npm >= v10.8.2
MySQL >= 8.0

Instalasi

Clone & Install Dependencies

git clone <repository-url>
cd backend
npm install

Setup Environment

# Copy .env.example
cp .env.example .env

Edit .env dengan konfigurasi yang sesuai:

# Database
DATABASE_URL="mysql://user:password@localhost:3306/sport_center"

# JWT
JWT_ACCESS_TOKEN_SECRET=your_access_token_secret
JWT_REFRESH_TOKEN_SECRET=your_refresh_token_secret

# Midtrans
MIDTRANS_SERVER_KEY=your_server_key
MIDTRANS_CLIENT_KEY=your_client_key

# Cloudinary
CLOUDINARY_CLOUD_NAME=your_cloud_name
CLOUDINARY_API_KEY=your_api_key
CLOUDINARY_API_SECRET=your_api_secret

Setup Database & Prisma

# Generate Prisma Client
npx prisma generate

# Run migrations
npx prisma migrate dev

# Seed database
npx prisma db seed

Start Development Server
```
npm run dev
```
Server berjalan di http://localhost:3000

🚀 Deployment dengan PM2

Build aplikasi:
```
npm run build
```
Jalankan dengan PM2:
```
npm run start:prod
```

Perintah pengelolaan:

# Menghentikan aplikasi
npm run stop:prod

# Restart aplikasi
npm run restart:prod

# Monitoring
npm run monitor:prod

# Membersihkan log
pm2 flush

# Reset PM2
pm2 reset all

🔄 Panduan Menjalankan Aplikasi

💻 Mode Development

Mode development dioptimalkan untuk kecepatan pengembangan dan debugging:

Jalankan dalam mode development:
```
npm run dev
```
Fitur mode development:
- Hot-reload dengan nodemon
- Debugging lebih detail
- Tidak ada kompresi response untuk memudahkan debugging
- HTTPS enforcement dinonaktifkan
- Automatic Prisma Client generation

Debugging:

# Jalankan dengan inspeksi node
node --inspect src/app.ts

# Atau dengan lebih banyak log
DEBUG=* npm run dev

🏭 Mode Production

Mode production dioptimalkan untuk performa dan keamanan maksimal:

Build aplikasi:
```
npm run build
```
Jalankan dalam cluster mode dengan PM2:
```
npm run start:prod
```
Fitur mode production:
- Clustering untuk pemanfaatan multi-core
- Kompresi response untuk kecepatan loading
- Rate limiting untuk keamanan
- Optimasi memori dengan garbage collection otomatis
- HTTPS enforcement diaktifkan
- Caching API selama 5 menit

Monitoring dan pengelolaan:

# Monitoring real-time
npm run monitor:prod

# Lihat log aplikasi
pm2 logs

# Tampilkan status instansi
pm2 status

Skalabilitas:
- Aplikasi akan otomatis menyesuaikan jumlah instansi berdasarkan beban CPU
- Port akan dialokasikan secara dinamis untuk setiap instansi
- Batas memori dikontrol untuk mencegah overload server

📊 Perbandingan Mode

Fitur	Development	Production
Hot-reload	✅	❌
Debugging	Detail tinggi	Minimal
Kompresi	❌	✅
Clustering	❌	✅ (Auto-scaling)
Caching	❌	✅ (5 menit)
HTTPS	Opsional	Wajib
Memory Limit	Tidak dibatasi	200MB/instance
GC Manual	❌	✅ (2 menit)
Rate Limiting	Longgar	Ketat (100/15min)

💪 Optimasi Performa

Aplikasi telah dioptimalkan untuk performa maksimal dengan:

🧠 Manajemen Memori

Batas memori: Maksimal 200MB per instance
Garbage Collection: Otomatis setiap 2 menit
V8 Engine: --max-old-space-size=200, --max-semi-space-size=64
Optimasi Flag: --optimize-for-size, --gc-interval=50

🔄 Clustering & Scaling

Mode Cluster PM2: Pemanfaatan multi-core CPU
Auto-scaling: Berdasarkan beban CPU
Instance: Minimum 1, maksimum 2 untuk penggunaan memori optimal

🌐 Network Optimization

Kompresi: Dengan middleware compression
Caching: API responses selama 5 menit
WebSocket: Payload maksimum 50KB, optimasi ping interval

🔒 Keamanan & Pembatasan

Rate Limiting: 100 request per 15 menit
Headers Keamanan: Dengan helmet
HTTPS Enforcement: Otomatis di production

⚡ Runtime Performance

Timeout: Listen timeout 5000ms, kill timeout 2000ms
Restart: Eksponensial backoff 50ms
Tracing: --trace-warnings, --trace-uncaught, --trace-sync-io

📁 Struktur Project

backend/
├── prisma/                 # Database schema & migrations
│   ├── migrations/        # Database migrations
│   ├── schema.prisma      # Prisma schema
│   └── seeds/            # Database seeders
├── src/
│   ├── config/           # App configuration
│   ├── controllers/      # Request handlers
│   │   ├── admin/       # Admin controllers
│   │   ├── owner/       # Owner controllers
│   │   └── user/        # User controllers
│   ├── middlewares/      # Express middlewares
│   ├── routes/           # API routes
│   ├── socket-handlers/  # Socket.io handlers
│   ├── utils/            # Helper functions
│   ├── zod-schemas/      # Request validation
│   └── app.ts           # App entry point
├── .env                  # Environment variables
├── ecosystem.config.js   # Konfigurasi PM2
└── package.json         # Dependencies

❓ Troubleshooting & FAQ

Masalah Umum

🐛 Aplikasi tidak dapat dimulai
- Periksa port 3000 sudah digunakan atau tidak
- Periksa status database MySQL
- Cek file log di logs/err.log
📈 Memori tinggi
- Jalankan npm run monitor:prod untuk memantau penggunaan
- Turunkan nilai max_instances jika diperlukan
- Cek bottleneck dengan monitoring
🐢 Performa lambat
- Optimasi query database
- Kurangi jumlah instance pada server dengan CPU terbatas
- Cek logs untuk blocking operations

📚 API Documentation

Base URL

http://localhost:3000/api/v1

Endpoints

🔐 Auth

POST /auth/register - Register user baru
POST /auth/login - Login user
POST /auth/refresh - Refresh access token
POST /auth/logout - Logout user

🏢 Branch

GET /branches - List semua cabang
GET /branches/:id - Detail cabang
POST /branches - Tambah cabang baru (Super Admin)
PUT /branches/:id - Update cabang
DELETE /branches/:id - Hapus cabang

⚽ Field

GET /fields - List semua lapangan
GET /fields/:id - Detail lapangan
POST /fields - Tambah lapangan baru (Admin)
PUT /fields/:id - Update lapangan
DELETE /fields/:id - Hapus lapangan

📅 Booking

GET /bookings - List reservasi user
POST /bookings - Buat reservasi baru
GET /bookings/:id - Detail reservasi
DELETE /bookings/:id - Batalkan reservasi

💰 Payment

GET /payments - List pembayaran user
GET /payments/:id - Detail pembayaran
POST /payments/notification - Webhook Midtrans

🔧 Scripts

{
  "dev": "npx prisma generate && nodemon src/app.ts",
  "build": "tsc",
  "start": "node dist/app.js",
  "lint": "eslint . --ext .ts --fix",
  "start:prod": "pm2 start ecosystem.config.js --node-args='--expose-gc'",
  "stop:prod": "pm2 stop ecosystem.config.js",
  "restart:prod": "pm2 restart ecosystem.config.js",
  "monitor:prod": "pm2 monit"
}

📝 License

Distributed under the MIT License. See LICENSE for more information.

Made with ❤️ by PBL Team

Konfigurasi Environment

Aplikasi ini menggunakan sistem konfigurasi berbasis tipe dengan nilai default yang sudah disediakan, sehingga tidak memerlukan file .env secara mayoritas. Berikut cara konfigurasi:

Cara 1: Tanpa File .env (Rekomendasi untuk Pengembangan)

Aplikasi akan menggunakan nilai default yang aman untuk pengembangan. Anda dapat langsung menjalankan aplikasi tanpa membuat file .env apapun. Sistem akan menampilkan informasi nilai default yang digunakan.

# Cukup jalankan aplikasi
npm run dev

Cara 2: Dengan File Environment (Untuk Production)

Untuk lingkungan production atau jika Anda perlu mengubah nilai default:

Salin file .env.type sebagai referensi:

# Untuk development
cp .env.type .env.development

# Untuk production
cp .env.type .env.production

Edit file tersebut dengan konfigurasi yang sesuai.
Aplikasi akan mencari file konfigurasi dengan prioritas:
- .env.{NODE_ENV} (misalnya .env.development atau .env.production)
- .env (sebagai fallback)
- Nilai default yang dikodekan dalam aplikasi

Cara Kerja

Semua variabel lingkungan didefinisikan sebagai tipe di src/types/env.ts dan memiliki nilai default di dalam kode. Sistem akan:

Mencoba memuat file lingkungan yang sesuai
Jika tidak ditemukan, menggunakan nilai default
Memberikan peringatan untuk nilai-nilai kritis yang menggunakan default di lingkungan production

Catatan Keamanan: Di lingkungan production, pastikan Anda mengatur variabel lingkungan kritis seperti JWT_SECRET, kredensial database, dan kunci API. Meskipun ada nilai default, nilai tersebut tidak boleh digunakan di production.

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
.vscode		.vscode
backup		backup
logs		logs
prisma		prisma
scripts		scripts
src		src
tests		tests
.env.example		.env.example
.env.type		.env.type
.gitignore		.gitignore
.prettierrc		.prettierrc
cloud-architecture.puml		cloud-architecture.puml
ecosystem.config.ts		ecosystem.config.ts
eslint.config.ts		eslint.config.ts
image.png		image.png
package-lock.json		package-lock.json
package.json		package.json
readme.md		readme.md
swagger.json		swagger.json
tsconfig.json		tsconfig.json
uml.puml		uml.puml

Latest commit

History

Folders and files

Repository files navigation