first commit

2026-02-06 14:22:35 +07:00
commit bd70440c71
185 changed files with 69518 additions and 0 deletions
@@ -0,0 +1,439 @@
+# 📋 PANDUAN MIGRASI MYSQL KE POSTGRESQL - STEP BY STEP
+
+## 📌 RINGKASAN KONDISI SAAT INI
+- **Backend Framework:** Golang (Gin + GORM)
+- **Database Saat Ini:** MySQL (localhost:3306)
+- **Database Baru:** PostgreSQL (sudah dibuat di pgAdmin4)
+- **Driver Saat Ini:** `github.com/go-sql-driver/mysql` + `gorm.io/driver/mysql`
+
+---
+
+## ✅ TAHAP 1: PERSIAPAN & VERIFIKASI
+
+### Step 1.1: Verifikasi Database PostgreSQL di pgAdmin4
+**Lokasi file konfigurasi:**
+- File: `backendcareit_v4\.env`
+- File koneksi database: `backendcareit_v4\database\db.go`
+
+**Yang perlu dicek:**
+- ✓ PostgreSQL sudah berjalan dan bisa diakses dari pgAdmin4
+- ✓ Database baru sudah dibuat (catat nama databasenya)
+- ✓ User PostgreSQL sudah dibuat (catat username dan passwordnya)
+- ✓ Port PostgreSQL (default: 5432)
+- ✓ Host PostgreSQL (localhost atau IP address)
+
+**Contoh informasi yang diperlukan:**
+```
+Hostname/Address: localhost
+Port: 5432
+Username: (nama user PostgreSQL)
+Password: (password user PostgreSQL)
+Database Name: (nama database PostgreSQL)
+```
+
+---
+
+## ✅ TAHAP 2: MIGRASI DATA DARI MYSQL KE POSTGRESQL
+
+### Step 2.1: Export Data dari MySQL
+Gunakan tools berikut untuk export data:
+
+**Option A: Menggunakan MySQL Workbench**
+1. Buka MySQL Workbench
+2. Koneksi ke MySQL server (localhost:3306)
+3. Pilih database: `careit_db`
+4. Klik menu **Server** → **Data Export**
+5. Pilih tables yang ingin diekspor (semua tables di `careit_db`)
+6. Pilih opsi **Dump Structure and Data**
+7. Simpan file dengan nama: `careit_backup.sql`
+
+**Option B: Menggunakan Command Line (PowerShell)**
+```powershell
+# Jalankan command ini di PowerShell
+mysqldump -u root -p careit_db > "C:\Users\rengginang\Desktop\CAREIT_V4\careit_backup.sql"
+# Akan diminta password MySQL (tekan Enter jika tidak ada password)
+```
+
+**Hasil yang diharapkan:**
+- File SQL dengan semua struktur tabel dan data: `careit_backup.sql`
+
+---
+
+### Step 2.2: Konversi SQL MySQL ke PostgreSQL
+Beberapa perbedaan syntax yang perlu dikonversi:
+
+#### ⚠️ Perbedaan Utama MySQL vs PostgreSQL:
+
+| Aspek | MySQL | PostgreSQL |
+|-------|-------|-----------|
+| **Type AUTO_INCREMENT** | `INT AUTO_INCREMENT` | `SERIAL` atau `INT GENERATED ALWAYS AS IDENTITY` |
+| **Type DATETIME** | `DATETIME` | `TIMESTAMP` |
+| **Type TINYINT** | `TINYINT(1)` | `BOOLEAN` atau `SMALLINT` |
+| **Constraint Engine** | Bisa diabaikan | Harus ada (ENGINE=InnoDB menjadi tidak relevan) |
+| **Charset** | `CHARACTER SET utf8mb4` | `ENCODING 'UTF8'` |
+| **Function NOW()** | `NOW()` | `CURRENT_TIMESTAMP` |
+
+#### Step 2.2a: Konversi File SQL Manual
+1. Buka file `careit_backup.sql` dengan text editor (VS Code / Notepad++)
+2. Lakukan replace berikut:
+
+**Replace Pattern List:**
+```
+1. Ganti: `AUTO_INCREMENT` → `GENERATED ALWAYS AS IDENTITY`
+   Contoh:
+   DARI:   `ID_Tarif_RS` int NOT NULL AUTO_INCREMENT,
+   KE:     `ID_Tarif_RS` SERIAL PRIMARY KEY,
+
+2. Ganti: `CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci` → (hapus)
+   Contoh:
+   DARI:   CREATE TABLE `tarif_rs` (...) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+   KE:     CREATE TABLE `tarif_rs` (...);
+
+3. Ganti: `ENGINE=InnoDB` → (hapus)
+
+4. Ganti: `DATETIME` → `TIMESTAMP`
+   Contoh:
+   DARI:   `Tanggal_Dibuat` datetime DEFAULT CURRENT_TIMESTAMP,
+   KE:     `Tanggal_Dibuat` TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+
+5. Ganti: backtick (`) → double quote (")
+   Contoh:
+   DARI:   CREATE TABLE `users` (
+   KE:     CREATE TABLE "users" (
+
+6. Ganti function names:
+   - `NOW()` tetap bisa dipakai
+   - `CURDATE()` tetap bisa dipakai
+```
+
+#### Step 2.2b: Gunakan Online Tool (Opsional)
+Alternatif menggunakan online converter:
+- Kunjungi: https://www.pgloader.io/ 
+- Atau gunakan tool: https://www.vertabelo.com/
+
+---
+
+### Step 2.3: Import Data ke PostgreSQL
+
+**Option A: Menggunakan pgAdmin4**
+1. Buka pgAdmin4 di browser (default: http://localhost:5050)
+2. Login dengan credentials pgAdmin4
+3. Di sebelah kiri, klik database yang sudah dibuat
+4. Klik menu **Tools** → **Query Tool**
+5. Copy isi file SQL yang sudah dikonversi
+6. Paste ke Query Tool
+7. Klik tombol **Execute** (atau tekan F5)
+8. Tunggu sampai selesai (jika ada error, perbaiki)
+
+**Option B: Menggunakan psql Command Line**
+```powershell
+# Jalankan di PowerShell
+# Pastikan PostgreSQL sudah di PATH
+psql -U <username> -d <database_name> -f "C:\Users\rengginang\Desktop\CAREIT_V4\careit_backup.sql"
+
+# Contoh:
+psql -U postgres -d careit_db -f "C:\Users\rengginang\Desktop\CAREIT_V4\careit_backup.sql"
+```
+
+**Hasil yang diharapkan:**
+- ✓ Semua tabel sudah ter-import di PostgreSQL
+- ✓ Data sudah ter-copy ke PostgreSQL
+- ✓ Tidak ada error messages
+
+---
+
+## ✅ TAHAP 3: UPDATE BACKEND GOLANG
+
+### Step 3.1: Update Go Modules (Dependencies)
+
+**File yang perlu diubah:** `backendcareit_v4\go.mod`
+
+**Perubahan:**
+```
+Dari:  github.com/go-sql-driver/mysql v1.9.3
+Dari:  gorm.io/driver/mysql v1.6.0
+
+Ke:    github.com/lib/pq v1.10.9          (PostgreSQL driver)
+Ke:    gorm.io/driver/postgres v1.5.9      (GORM PostgreSQL driver)
+```
+
+**Di Command Line / PowerShell:**
+```powershell
+cd "c:\Users\rengginang\Desktop\CAREIT_V4\backendcareit_v4"
+
+# Hapus dependency MySQL lama
+go get -d -u
+
+# Tambah PostgreSQL driver
+go get github.com/lib/pq
+go get gorm.io/driver/postgres
+
+# Atau jalankan:
+go get -u
+go mod tidy
+```
+
+---
+
+### Step 3.2: Update File Koneksi Database
+
+**File yang perlu diubah:** `backendcareit_v4\database\db.go`
+
+**Current Code (MySQL):**
+```go
+import (
+	"fmt"
+	"os"
+
+	_ "github.com/go-sql-driver/mysql"
+	"gorm.io/driver/mysql"
+	"gorm.io/gorm"
+)
+
+func KonekDB() (*gorm.DB, error) {
+	dsn := os.Getenv("DB_DSN")
+
+	if dsn == "" {
+		user := envOrDefault("DB_USER", "root")
+		pass := envOrDefault("DB_PASSWORD", "")
+		host := envOrDefault("DB_HOST", "localhost")
+		port := envOrDefault("DB_PORT", "3306")
+		name := envOrDefault("DB_NAME", "care_it_data")
+
+		dsn = fmt.Sprintf("%s:%s@tcp(%s:%s)/%s?charset=utf8mb4&parseTime=True&loc=Local", user, pass, host, port, name)
+	}
+
+	db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
+	if err != nil {
+		return nil, fmt.Errorf("gagal membuka koneksi database: %w", err)
+	}
+
+	return db, nil
+}
+```
+
+**New Code (PostgreSQL):**
+```go
+import (
+	"fmt"
+	"os"
+
+	"gorm.io/driver/postgres"
+	"gorm.io/gorm"
+)
+
+func KonekDB() (*gorm.DB, error) {
+	dsn := os.Getenv("DB_DSN")
+
+	if dsn == "" {
+		user := envOrDefault("DB_USER", "postgres")
+		pass := envOrDefault("DB_PASSWORD", "")
+		host := envOrDefault("DB_HOST", "localhost")
+		port := envOrDefault("DB_PORT", "5432")
+		name := envOrDefault("DB_NAME", "careit_db")
+
+		fmt.Println("DB_USER:", os.Getenv("DB_USER"))
+		fmt.Println("DB_PASSWORD:", os.Getenv("DB_PASSWORD"))
+		fmt.Println("DB_HOST:", os.Getenv("DB_HOST"))
+		fmt.Println("DB_PORT:", os.Getenv("DB_PORT"))
+		fmt.Println("DB_NAME:", os.Getenv("DB_NAME"))
+		fmt.Println("HOST:", os.Getenv("HOST"))
+		fmt.Println("PORT:", os.Getenv("PORT"))
+
+		dsn = fmt.Sprintf("host=%s port=%s user=%s password=%s dbname=%s sslmode=disable", host, port, user, pass, name)
+	}
+
+	db, err := gorm.Open(postgres.Open(dsn), &gorm.Config{})
+	if err != nil {
+		return nil, fmt.Errorf("gagal membuka koneksi database: %w", err)
+	}
+
+	return db, nil
+}
+
+func envOrDefault(key, fallback string) string {
+	val := os.Getenv(key)
+	if val == "" {
+		return fallback
+	}
+	return val
+}
+```
+
+**Penjelasan Perubahan:**
+- Import berubah dari `gorm.io/driver/mysql` → `gorm.io/driver/postgres`
+- DSN format berubah dari: `user:pass@tcp(host:port)/dbname?charset=...`
+- DSN format baru: `host=... port=... user=... password=... dbname=... sslmode=disable`
+- Port default berubah dari 3306 → 5432
+- Default user berubah dari root → postgres
+
+---
+
+### Step 3.3: Update File Environment Variables
+
+**File yang perlu diubah:** `backendcareit_v4\.env`
+
+**Current (MySQL):**
+```
+DB_USER=root
+DB_PASSWORD=
+DB_HOST=localhost
+DB_PORT=3306
+DB_NAME=careit_db
+```
+
+**New (PostgreSQL):**
+```
+DB_USER=<username_postgresql>
+DB_PASSWORD=<password_postgresql>
+DB_HOST=localhost
+DB_PORT=5432
+DB_NAME=<nama_database_postgresql>
+```
+
+**Contoh:**
+```
+DB_USER=postgres
+DB_PASSWORD=password123
+DB_HOST=localhost
+DB_PORT=5432
+DB_NAME=careit_db
+```
+
+---
+
+## ✅ TAHAP 4: TESTING & VERIFIKASI
+
+### Step 4.1: Test Koneksi Database
+```powershell
+cd "c:\Users\rengginang\Desktop\CAREIT_V4\backendcareit_v4"
+
+# Jalankan backend
+go run main.go
+```
+
+**Expected Output:**
+```
+DB_USER: postgres
+DB_PASSWORD: ****
+DB_HOST: localhost
+DB_PORT: 5432
+DB_NAME: careit_db
+HOST: 0.0.0.0
+PORT: 8081
+Server berjalan di http://0.0.0.0:8081
+Akses dari jaringan lain menggunakan IP lokal komputer + port 8081
+```
+
+✓ Jika tidak ada error, koneksi berhasil!
+
+### Step 4.2: Test API Endpoints
+Gunakan Postman atau curl untuk test:
+
+```powershell
+# Contoh test GET
+curl http://localhost:8081/api/endpoint-yang-ada
+
+# Test POST dengan data
+curl -X POST http://localhost:8081/api/endpoint-yang-ada `
+  -H "Content-Type: application/json" `
+  -d '{"key":"value"}'
+```
+
+### Step 4.3: Verifikasi Data di PostgreSQL
+Buka pgAdmin4 dan cek:
+1. Database → careit_db → Schemas → Tables
+2. Klik kanan table → View/Edit Data
+3. Verifikasi bahwa data sudah ter-copy dengan benar
+
+---
+
+## ⚠️ TAHAP 5: HAL-HAL YANG PERLU DIPERHATIKAN
+
+### 5.1: Case Sensitivity
+- **MySQL:** Case-insensitive untuk nama table dan column
+- **PostgreSQL:** Case-sensitive untuk nama table dan column
+  
+**Solusi:** Pastikan nama table dan column di models.go sesuai dengan database
+
+### 5.2: Sequences (AUTO_INCREMENT equivalent)
+PostgreSQL menggunakan SEQUENCES untuk AUTO_INCREMENT
+
+**Jika ada issue dengan ID generation:**
+```sql
+-- Di PostgreSQL Query Tool, jalankan:
+SELECT * FROM pg_sequences;
+-- Jika sequence tidak ada, buat manual:
+CREATE SEQUENCE table_name_id_seq;
+```
+
+### 5.3: Type Casting
+Beberapa operasi math di Go mungkin perlu disesuaikan:
+- MySQL: TINYINT(1) → Boolean
+- PostgreSQL: BOOLEAN atau SMALLINT
+
+### 5.4: Time Zone
+PostgreSQL dan MySQL menangani timezone berbeda:
+- Pastikan environment variable untuk timezone sudah benar
+- Di DSN PostgreSQL: bisa tambah `TimeZone=Asia/Jakarta` jika perlu
+
+---
+
+## 📝 CHECKLIST PERSIAPAN MIGRASI
+
+Sebelum melakukan perubahan, pastikan:
+
+- [ ] PostgreSQL sudah terinstall dan berjalan
+- [ ] Database baru sudah dibuat di PostgreSQL (catat nama, user, password, port)
+- [ ] pgAdmin4 bisa mengakses PostgreSQL
+- [ ] Data MySQL sudah di-backup (file .sql sudah tersimpan)
+- [ ] SQL dari MySQL sudah dikonversi ke PostgreSQL format
+- [ ] Data sudah ter-import ke PostgreSQL
+- [ ] File `go.mod` sudah ter-update dengan PostgreSQL driver
+- [ ] File `database/db.go` sudah siap untuk diubah
+- [ ] File `.env` sudah siap dengan info PostgreSQL baru
+
+---
+
+## 📌 FILE-FILE YANG AKAN DIUBAH
+
+1. **`backendcareit_v4\go.mod`** - Tambah/ganti dependencies
+2. **`backendcareit_v4\database\db.go`** - Update koneksi database
+3. **`backendcareit_v4\.env`** - Update kredensial database
+
+**File-file yang TIDAK berubah:**
+- Semua models (file di folder `models/`)
+- Semua handlers (file di folder `handlers/`)
+- Semua services (file di folder `services/`)
+- Frontend code
+
+---
+
+## ⏭️ LANGKAH SELANJUTNYA
+
+Setelah Anda:
+1. ✓ Verifikasi Database PostgreSQL
+2. ✓ Export data dari MySQL
+3. ✓ Konversi SQL format
+4. ✓ Import data ke PostgreSQL
+
+**BARU SAAT ITU** kita akan:
+1. Update `go.mod` dengan PostgreSQL driver
+2. Update `database/db.go` dengan koneksi PostgreSQL
+3. Update `.env` dengan kredensial PostgreSQL
+4. Test seluruh aplikasi
+
+---
+
+## 📞 NOTES PENTING
+
+- **Jangan ubah code dulu** sampai Anda confirm sudah siap
+- **Backup data MySQL** sebelum proses migrasi
+- **Test di environment lokal** dulu sebelum production
+- **Dokumentasikan setiap step** untuk reference ke depan
+
+---
+
+**Created:** January 19, 2026
+**Status:** SIAP UNTUK MIGRASI
+**Last Updated:** Awaiting User Confirmation