Polban DataVerse Project

Polban Dataverse is a collaborative initiative to consolidate data from various sources within the Bandung State Polytechnic into a single interactive visual portal.

---

📈 Project Stats

---

Overview

Repository superproject ini berisi:

• Semua DataVerse services sebagai git submodules:
  • Polban DataCore
  • Polban DataHub
  • Polban DataView
• Dockerfile untuk mem-build semua layanan
• Konfigurasi Docker Compose untuk penggunaan mudah

Prerequisites

• Docker
• Git (for cloning + submodules)
• Bash/sh shell

Quick Start

1. Clone repo beserta submodule:

git clone https://github.com/ikhsan3adi/polban-dataverse.git
cd polban-dataverse
git submodule update --init --recursive

2. Salin env contoh dan sesuaikan:

cp .env.example .env
# lalu edit nilai kredensial DB, KONG, app keys, dsb.

3. Jalankan semua layanan (build + up):

./run.sh
# atau: docker compose up -d --build --remove-orphans

4. Jalankan migrasi (otomatis untuk DataHub via run.sh):

• DataHub: sudah dijalankan di run.sh (php artisan migrate --force)
• DataCore (opsional, jika belum dimigrasi):

  docker compose exec dataverse-datacore bun run db:migrate

5. Akses layanan:

• DataCore API: dataverse-datacore:3000 (internal) / via Kong proxy jika diekspos
• DataCore Web (admin): dataverse-datacore_web
• DataHub: dataverse-datahub
• DataView: dataverse-dataview
• Kong Proxy/Admin/GUI: sesuai port env (KONG_PROXY_PORT_PUBLIC, KONG_API_PORT_PUBLIC, KONG_GUI_PORT_PUBLIC)

Docker Compose Lifecycle

• Start + build:

  ./run.sh

  atau

  docker compose up -d --build --remove-orphans

• Stop:

  docker compose down

• Rebuild tertentu (misal hanya datacore):

  docker compose up -d --build dataverse-datacore

• Logs (contoh DataCore):

  docker compose logs -f dataverse-datacore

Kong Gateway (deck) Export/Import

• Export konfigurasi dari Kong DB → file deklaratif (configs/kong.yml):

  ./export-kong.sh

• Import/sync konfigurasi ke Kong DB dari file deklaratif:

  ./import-kong.sh

Gunakan setelah mengubah service/route/consumer agar konsisten antara file dan database Kong.

Update Submodules

Untuk menarik perubahan terbaru dari semua layanan:

git submodule update --remote --merge services

Jika hanya ingin fetch tanpa merge otomatis, hilangkan --merge.

Troubleshooting

• Database belum siap: Pastikan kontainer dataverse-main_db dan dataverse-datacore_db healthy sebelum menjalankan migrasi.
• Port bentrok: Sesuaikan *_PORT_PUBLIC di .env dengan port kosong di host.
• Kong tidak bisa diakses: Cek docker compose logs -f dataverse_gateway; pastikan migrasi dataverse_gateway_bootstrap selesai sukses.
• Env tidak terbaca: Pastikan .env ada di root repo dan tidak ada spasi berlebih.

Authors

DataCore

• Ikhsan Satriadi - @ikhsan3adi
• Muhamad Syahid - @muhamadSyahid
• Rizky Satria Gunawan - @RizkySatria123
• Yazid Alrasyid - @yajidms

DataHub

• Alda Pujama - @Arud4Alda
• Alexandrio Vega Bonito - @AlexandrioVega
• Ersya Hasby Satria - @ErsyaHasby
• Gema Adzan Firdaus - @Gema1407
• Muhammad Raihan Abubakar - @hanzz78

DataView

• Fatimah Hawwa Alkhansa - @ftmhhwwa
• Hanifidin Ibrahim - @Hanif13579
• Muhammad Brata Hadinata - @MuhammadBrataH
• Muhammad Ihsan Ramadhan - @ihsan-ramadhan
• Varian Abidarma Syuhada - @v4rshaaa