bankapi

🚀 BankAPI - Money Transfer REST API Service : A Portfolio Project

Tentang

BankAPI adalah RESTful API service untuk pengelolaan user, cabang, akun, mata uang, dan biaya transaksi.

• BankAPI menerapkan Dependency Injection, Domain Driven Design, dan Clean Architecture.
• Proses load configuration dari file .env dilakukan didalam config/*.
• Manajemen service atau framework yang digunakan dilakukan didalam service/*
• Manajemen database, external api, komunikasi protokol lain berada didalam infrastructure/*
• Manajemen middleware dilakukan didalam internal/middleware/*
• Manajemen utility function dilakukan didalam internal/utils/*
• Manajemen error dilakukan dengan membuat custom error type beserta fungsi untuk menentukan kode http status dari error tersebut internal/utils/errors.go

Kelebihan

Dengan penerapan yang telah dilakukan, dapat dilihat bahwa:

• Struktur kode yang modular dan terorganisir memudahkan proses pengembangan, debugging, dan scaling aplikasi.
• Dependency Injection memungkinkan pengujian unit (unit testing) menjadi lebih mudah karena setiap komponen dapat digantikan dengan mock sesuai kebutuhan.
• Clean Architecture menjaga batas tanggung jawab setiap layer (handler, usecase, repository), sehingga logika bisnis tidak tercampur dengan detail implementasi teknis seperti database atau HTTP framework.
• Konfigurasi fleksibel melalui file .env yang memudahkan pengaturan environment tanpa harus mengubah source code.
• Middleware terstruktur memungkinkan penerapan fitur seperti autentikasi JWT secara konsisten dan mudah dikembangkan lebih lanjut (misalnya logging, rate-limiting).
• Custom error handling memberikan kontrol lebih atas response error API agar lebih informatif dan sesuai dengan standar HTTP status code.

Catatan Tambahan

• Framework yang digunakan adalah Gin Gonic yang dikenal ringan dan cepat untuk membuat REST API.
• Saat ini project ini belum memiliki implementasi DELETE endpoint pada beberapa resource seperti /branches, /account-types, /currencies, dan /accounts, namun struktur dan dependensinya sudah siap jika sewaktu-waktu diperlukan.
• Jika ingin meringankan performa, gunakan pass by reference pada return dari repository dan usecase.

Belum Diimplementasi

• Proses Transfer belum diimplementasi saat ini. (Soon)
  
  

Key: ACID, ATOMIC, Transactional DB

Database ERD

Terdapat penyesuaian dalam DDL terhadap ERD. Terutama dalam hal generate account number yang memerlukan entitas baru sebagai provider nomor urutan.

📌 Auth Endpoints (Public)

👤 User Endpoints (Private - JWT Required)

🏢 Branch Endpoints (Private - JWT Required)

🏦 Account Type Endpoints (Private - JWT Required)

💱 Currency Endpoints (Private - JWT Required)

📘 Account Endpoints (Private - JWT Required)

💸 Transaction Fee Endpoints (Private - JWT Required)

🛠 Cara Menjalankan Project

1. Copy .env.example ke .env:

   cp .env.example .env