Repositori ini berisi boilerplate yang siap pakai untuk membangun REST API modern dengan Go. Proyek ini sudah dilengkapi dengan fitur-fitur penting seperti routing, autentikasi JWT, interaksi database, dokumentasi API, dan alur kerja pengembangan yang efisien menggunakan Make dan Docker.

• Routing Cepat: Menggunakan Chi, router yang ringan, cepat, dan idiomatis.
• Autentikasi JWT: Sistem autentikasi lengkap dengan endpoint untuk registrasi, login, dan middleware untuk melindungi route.
• Database PostgreSQL: Integrasi dengan PostgreSQL menggunakan driver pgx yang modern dan berperforma tinggi.
• Repository Pattern: Struktur kode yang memisahkan logika bisnis dari logika akses data.
• Dokumentasi API Otomatis: Generate dokumentasi interaktif secara otomatis dari komentar kode menggunakan Swagger (swag).
• Manajemen Database: Setup database untuk development yang mudah dan konsisten menggunakan Docker Compose.
• Otomatisasi Tugas: Dilengkapi Makefile untuk menyederhanakan perintah-perintah umum seperti menjalankan, membangun, dan migrasi database.
• Konfigurasi Berbasis Environment: Membaca konfigurasi dari file .env untuk fleksibilitas antar lingkungan (development, production).
• Respon JSON Standar: Utilitas untuk memastikan semua respon API memiliki format yang konsisten.

• Bahasa: Go
• Web Framework/Router: Chi v5
• Database: PostgreSQL
• Driver Database: pgx v5
• Autentikasi: JSON Web Tokens (JWT)
• Dokumentasi: Swagger / OpenAPI
• Development Environment: Docker, Docker Compose
• Build/Task Runner: Makefile

/gochi-boilerplate
├── /cmd/server/
│   └── main.go           # Titik masuk aplikasi (setup server, router, db)
├── /db/
│   └── /migrations/
│       └── 001_init_schema.sql # Skema dan migrasi database
├── /docs/
│   └── ...                 # File yang di-generate oleh Swagger
├── /internal/
│   ├── /handler/           # Layer HTTP (logika request/response)
│   ├── /middleware/        # Middleware kustom (misal: autentikasi)
│   ├── /model/             # Struct untuk data (request, response, entitas)
│   ├── /repository/        # Layer akses data (interaksi dengan database)
│   └── /utils/             # Fungsi helper (JWT, respon JSON, config, dll.)
├── .env.example            # Contoh file konfigurasi environment
├── docker-compose.yml      # Konfigurasi Docker untuk database
├── go.mod                  # Manajemen dependensi Go
├── Makefile                # Shortcut untuk perintah-perintah development
└── README.md               # Dokumentasi proyek

Ikuti langkah-langkah ini untuk menjalankan proyek di lingkungan lokal Anda.

Pastikan Anda sudah menginstal perangkat lunak berikut:

• Go (versi 1.21 atau lebih baru)
• Docker dan Docker Compose
• Make
• psql (opsional, untuk koneksi manual ke database)

1. Clone repositori ini:

   git clone https://github.com/username/gochi-boilerplate.git
   cd gochi-boilerplate

2. Konfigurasi Environment: Salin file .env.example menjadi .env dan sesuaikan nilainya jika perlu.

   cp .env.example .env

3. Instal Dependensi Go: Perintah ini akan mengunduh semua library yang dibutuhkan.

   go mod tidy

4. Jalankan Database: Perintah ini akan memulai container PostgreSQL di latar belakang menggunakan Docker Compose.

   make db-up

5. Jalankan Migrasi Database: Perintah ini akan membuat tabel users dan products sesuai skema di file .sql.

   make db-migrate

Untuk menjalankan server dengan hot-reload (memerlukan instalasi air), atau cukup jalankan dengan perintah standar:

make run

Server akan berjalan di http://localhost:8080.

Untuk meng-kompilasi aplikasi menjadi satu file binary yang siap di-deploy:

make build

Hasilnya akan berada di folder bin/.

Dokumentasi API yang lengkap dan interaktif tersedia melalui Swagger UI. Setelah server berjalan, buka URL berikut di browser Anda:

➡️ http://localhost:8080/swagger/index.html