Database Overview

🧩 Repository Structure

Project Structure – Database Migration

📦 Git Repository:
https://gitlab.komerce.id/devops/database-migration

📁 Project Structure

Struktur repository ini digunakan untuk mengelola file-file migrasi database dari berbagai jenis database seperti MariaDB, MySQL, PostgreSQL, dan MongoDB.
Setiap folder database berisi subfolder per aplikasi atau modul (misalnya affiliate, komcards, dll).

 ├── mariadb/
 │   ├── affiliate
 │   ├── komcards/
 │   │   ├── changelogs
 │   │   │   └── 20230801000000_init.sql
 │   │   └── .gitkeep
 ├── mongodb/
 ├── mysql/
 ├── postgresql/
 ├── create-migration-file.sh
 └── readme.md

🗄️ Folder Explanation

Folder / File	Deskripsi
`mariadb/`	Menyimpan file migrasi untuk database MariaDB. Setiap subfolder mewakili project/module.
`mongodb/`	Menyimpan script migrasi atau seeding data untuk MongoDB (jika digunakan).
`mysql/`	Menyimpan migrasi untuk MySQL Database. Struktur mirip dengan folder `mariadb/`.
`postgresql/`	Menyimpan file migrasi untuk PostgreSQL.
`create-migration-file.sh`	Script shell otomatis untuk membuat file migrasi baru dengan format timestamp.
`readme.md`	Dokumentasi utama repository.

🧱 Example Migration Structure

Contoh struktur folder migrasi di dalam salah satu project (misalnya komcards):

mariadb/
└── komcards/
├── changelogs/
│ ├── 20230801000000_init.sql
│ ├── 20230915090000_add_users_table.sql
│ └── 20231020094500_alter_transactions_table.sql
└── .gitkeep

Setiap file migrasi mengikuti format:

Contoh:

20230801000000_init.sql
20230915090000_add_users_table.sql

🌿 Branching Strategy

Repository ini menggunakan strategi Git Branching Standard untuk menjaga kestabilan dan workflow development.

Branch	Tujuan	Keterangan
`master`	Production-ready	Kode yang siap dan sudah digunakan di produksi.
`staging`	Staging environment	Untuk testing sebelum masuk ke production.
`development`	Development environment	Tempat pengembangan aktif dan integrasi feature baru.
`feature/*`	Feature development	Digunakan untuk membuat fitur baru. Contoh: `feature/migration-add-user-table`
`bugfix/*`	Bug fixes	Untuk memperbaiki bug yang ditemukan di `development` atau `staging`.
`hotfix/*`	Urgent production fix	Perbaikan kritis langsung pada production (`master`).

🛠️ Migration Workflow

1. Membuat Migration Baru

Sebelum membuat file migration baru:

Pull branch master terbaru

git checkout master
git pull origin master

Buat branch baru dari master Gunakan format:

feature/migration-<nama-migration>

Contoh

git checkout -b feature/migration-add-user-table

Jalankan Skrip:
Terminal window
```
bash create-migration-file.sh
```
Ikuti Petunjuk: Skrip akan meminta Anda untuk memilih:
- Direktori Jenis Database: Pilih jenis database (misalnya, mariadb, mysql, postgresql).
- Direktori Nama Database: Pilih skema atau nama pengguna database yang relevan (misalnya komship).
- Komentar Migrasi: Masukkan deskripsi singkat tentang migrasi (contoh: create table users).
- Query SQL Lengkap: Masukkan pernyataan SQL untuk migrasi Anda (misalnya, CREATE TABLE users (id INT PRIMARY KEY, name VARCHAR(255));). Tekan Ctrl+D di baris baru setelah selesai.
- Query SQL Rollback Lengkap: Masukkan pernyataan SQL untuk mengembalikan migrasi (misalnya, DROP TABLE users). Tekan Ctrl+D di baris baru setelah selesai.
Hasil: Skrip akan secara otomatis membuat file .sql baru di dalam direktori [database_type]/[nama_db]/changelogs/ dengan nama yang diformat berdasarkan timestamp dan komentar Anda (contoh: 202507040930_create_table_mahasiswa5.sql). Contoh:
```
--liquibase formatted sql
--changeset febriyan:202506040854
--comment: create table users
create table users (
id int primary key auto_increment not null,
name varchar(50) not null,
address varchar(50),
city varchar(30)
)
--rollback DROP TABLE users;
```
Pastikan query rollbacknya hanya terdiri dari satu baris

2. Merge Request Flow

Setelah migration siap:

Push branch ke remote:

git push origin feature/migration-add-user-table

Buat Merge Request (MR) ke branch sesuai kebutuhan:

Jika untuk pengujian → merge ke development
Jika untuk staging → merge ke staging
Jika untuk produksi → merge ke master

⚠️ Catatan Penting: Jangan pernah membuat merge request dari development atau staging ke branch kamu sendiri. Semua feature baru harus berasal dari master.

📘 Last Updated: 2025-10-30 🧑‍💻 Maintained by: Backend Team – Komerce