first commit

2026-04-14 01:21:54 +00:00
commit 35c101725f
443 changed files with 1245931 additions and 0 deletions
@@ -0,0 +1,173 @@
+# 📚 Dokumentasi Integrasi Minio Storage
+
+Modul ini (`internal/interfaces/minio`) berfungsi untuk mengatur koneksi dan inisialisasi ke layanan Object Storage berbasis S3 (seperti Minio, AWS S3, dll) menggunakan SDK `minio-go/v7`.
+
+---
+
+## 1. Konfigurasi (Environment / YAML)
+
+Berdasarkan struct `MinioCfg`, aplikasi mengekspektasikan konfigurasi untuk Minio. Pastikan file konfigurasi Anda (misalnya `config.yaml`) memiliki struktur yang dipetakan sebagai berikut:
+
+```yaml
+minio:
+  endpoint: "play.min.io"             # (Contoh) Jangan gunakan http:// atau https://
+  region: "ap-southeast-1"            # Region server S3/Minio
+  accessKey: "YOUR-ACCESS-KEY"        # Access key dari Minio
+  secretKey: "YOUR-SECRET-KEY"        # Secret key dari Minio
+  useSsl: true                        # true untuk HTTPS, false untuk HTTP
+  bucketName: 
+    - "my-app-bucket"                 # Daftar bucket yang digunakan
+    - "public-assets"
+```
+*(Catatan: Konfigurasi ini akan di-parse menggunakan package `github.com/karincake/apem` sesuai implementasi di `Connect()`)*.
+
+---
+
+## 2. Cara Inisialisasi di `main.go`
+
+Untuk mengaktifkan koneksi ke Minio saat aplikasi berjalan, Anda cukup memanggil fungsi `Connect()` dari package ini pada saat proses bootstrap di file `cmd/api/main.go`.
+
+```go
+package main
+
+import (
+    "service/internal/interfaces/minio"
+    // import lainnya...
+)
+
+func main() {
+    // 1. Load config umum (seperti DB, dll)
+    // ...
+
+    // 2. Inisialisasi Minio
+    minio.Connect()
+
+    // Jika berhasil, log "Instantiation for object storage service using Minio, status: DONE!!"
+    // akan muncul di console dan client minio.I siap digunakan.
+    
+    // ... Lanjutkan inisialisasi server (REST/gRPC)
+}
+```
+
+---
+
+## 3. Cara Penggunaan (Sinkronisasi, Upload, dan Download)
+
+Koneksi klien disimpan secara global dalam variabel pointer `minio.I`. Anda dapat memanggilnya di layer **Repository** atau **Service** Anda untuk melakukan operasi Object Storage.
+
+Berikut adalah contoh implementasi metode-metode yang bisa digunakan:
+
+### A. Upload File (Sinkronisasi File Lokal ke Minio)
+Gunakan metode `PutObject` untuk mengunggah data/file ke dalam Minio.
+
+```go
+package fileservice
+
+import (
+    "context"
+    "mime/multipart"
+    "service/internal/interfaces/minio"
+
+    miniogo "github.com/minio/minio-go/v7"
+)
+
+func UploadFile(ctx context.Context, file *multipart.FileHeader, bucketName, objectName string) error {
+    src, err := file.Open()
+    if err != nil {
+        return err
+    }
+    defer src.Close()
+
+    // Menggunakan variabel global minio.I
+    info, err := minio.I.PutObject(ctx, bucketName, objectName, src, file.Size, miniogo.PutObjectOptions{
+        ContentType: file.Header.Get("Content-Type"),
+    })
+    
+    if err != nil {
+        return err
+    }
+
+    // info.Size, info.Key bisa digunakan jika ingin dicatat ke database
+    _ = info
+    return nil
+}
+```
+
+### B. Download File dari Minio
+Gunakan metode `GetObject` untuk mengambil file stream dari storage.
+
+```go
+package fileservice
+
+import (
+    "context"
+    "io"
+    "service/internal/interfaces/minio"
+
+    miniogo "github.com/minio/minio-go/v7"
+)
+
+func DownloadFile(ctx context.Context, bucketName, objectName string) (io.ReadCloser, error) {
+    // Mengambil file stream dari minio
+    object, err := minio.I.GetObject(ctx, bucketName, objectName, miniogo.GetObjectOptions{})
+    if err != nil {
+        return nil, err
+    }
+    
+    // Ingat untuk melakukan object.Close() setelah selesai membaca di sisi HTTP Handler
+    return object, nil 
+}
+```
+
+### C. Menghasilkan Presigned URL (Untuk Download/Akses Publik Sementara)
+Jika file bersifat privat, namun Anda ingin memberikan akses baca ke *frontend* (browser) untuk jangka waktu tertentu.
+
+```go
+package fileservice
+
+import (
+    "context"
+    "time"
+    "service/internal/interfaces/minio"
+)
+
+func GetFileUrl(ctx context.Context, bucketName, objectName string) (string, error) {
+    // URL akan valid selama 24 jam
+    expiry := time.Second * 24 * 60 * 60
+
+    presignedURL, err := minio.I.PresignedGetObject(ctx, bucketName, objectName, expiry, nil)
+    if err != nil {
+        return "", err
+    }
+    
+    return presignedURL.String(), nil
+}
+```
+
+### D. Memastikan / Membuat Bucket Otomatis
+Sebelum upload, ada baiknya memastikan bucket sudah ada.
+
+```go
+package fileservice
+
+import (
+    "context"
+    "service/internal/interfaces/minio"
+
+    miniogo "github.com/minio/minio-go/v7"
+)
+
+func EnsureBucketExists(ctx context.Context, bucketName string) error {
+    exists, err := minio.I.BucketExists(ctx, bucketName)
+    if err != nil {
+        return err
+    }
+    if !exists {
+        err = minio.I.MakeBucket(ctx, bucketName, miniogo.MakeBucketOptions{Region: minio.O.Region})
+        if err != nil {
+            return err
+        }
+    }
+    return nil
+}
+```