Getting Started

Overview

Platform Waqfuel terdiri dari beberapa microservices yang saling berkomunikasi via gRPC (internal) dan REST API (external). Panduan ini membantu kamu memahami arsitektur dasar dan cara menjalankan services secara lokal.

Langkah 1: Prerequisites

Pastikan tools berikut sudah terinstall:

# Rust toolchain (untuk backend services)
rustup --version    # >= 1.80
cargo --version     # >= 1.80

# Node.js (untuk frontend clients)
node --version      # >= 20.x LTS

# Database & cache
psql --version      # PostgreSQL 15+
redis-cli --version # Redis 7+

# Protocol Buffers compiler
protoc --version    # >= 25.x

# Docker (untuk containerized development)
docker --version    # >= 24.x

Langkah 2: Clone Repositories

# Clone semua repos ke satu folder
mkdir -p ~/Projects/Waqfuel && cd ~/Projects/Waqfuel

git clone git@github.com:paimanbandi/waqfuel-auth-api.git
git clone git@github.com:paimanbandi/waqfuel-main-api.git
git clone git@github.com:paimanbandi/waqfuel-notif-api.git
git clone git@github.com:paimanbandi/waqfuel-reference-api.git
git clone git@github.com:paimanbandi/waqfuel-proto-defs.git
git clone git@github.com:paimanbandi/waqfuel-platform-client.git
git clone git@github.com:paimanbandi/waqfuel-web.git

Setiap service yang membutuhkan proto definitions akan include waqfuel-proto-defs sebagai Git submodule. Setelah clone, jalankan:

git submodule update --init --recursive

Langkah 3: Jalankan Services

Urutan startup yang disarankan (karena dependency antar service):

# 1. Reference API (port 4000 REST, 50050 gRPC) — tidak punya dependency
cd waqfuel-reference-api
cp .env.example .env   # edit sesuai kebutuhan
cargo run

# 2. Notification API (port 50052 gRPC) — tidak punya dependency
cd waqfuel-notif-api
cp .env.example .env   # set RESEND_API_KEY
cargo run

# 3. Auth API (port 3001 REST, 50051 gRPC) — depends on: reference, notif
cd waqfuel-auth-api
cp .env.example .env   # set DATABASE_URL, JWT keys, dll
cargo run

# 4. Main API (port 8081 REST) — depends on: auth (JWKS + gRPC)
cd waqfuel-main-api
cp .env.example .env   # set DATABASE_URL, JWKS_AUTH URL, dll
cargo run

# 5. Platform Client (port 3000)
cd waqfuel-platform-client
npm install && npm run dev

# 6. Public Web (port 3001 atau 3000)
cd waqfuel-web
npm install && npm run dev

Service Dependency Graph

Urutan dependency antar services:

Service	Depends On	Port (REST)	Port (gRPC)
reference-api	PostgreSQL	4000	50050
notif-api	Resend (external)	-	50052
auth-api	reference-api, notif-api, PostgreSQL, Redis	3001	50051
main-api	auth-api, reference-api, PostgreSQL, S3	8081	-
platform-client	auth-api, main-api, reference-api	3000	-
waqfuel-web	auth-api, main-api, reference-api	3000	-

Selanjutnya

• Architecture Overview — memahami arsitektur lengkap
• Environment Variables — daftar semua env vars per service
• API Reference — endpoint documentation