MERICA (Managed Engine for Robust Ingestion & Cloud Airflow) adalah platform visual low-code mandiri khusus Data Engineer untuk merancang, mengonfigurasi, dan menyusun task DAG Apache Airflow secara deklaratif tanpa menulis boilerplate Python manual.

Paket rilis ini adalah Clean Production Appliance yang dapat dijalankan secara mandiri (standalone) dan langsung dihubungkan ke kluster Apache Airflow eksternal yang sudah ada.

⚡ Panduan Cepat Memulai (Quick Start 2 Menit)

1. Salin Berkas Konfigurasi Lingkungan

cp .env.example .env

Sesuaikan AIRFLOW_WEB_URL mengarah ke alamat server Apache Airflow existing Anda (default: http://host.docker.internal:14080).

2. Jalankan Script Setup Sekali Klik

bash ./setup.sh

Atau jalankan manual:

docker compose up -d

3. Akses Antarmuka Web

Setelah kontainer aktif dan sehat (healthy):

MERICA Canvas UI: http://localhost:14000
Kredensial Default: Username: admin | Password: admin

🏛️ Pilihan Mode Deployment

Mode Deployment	Berkas Compose	Keterangan
1. Standalone Appliance (Default)	`docker-compose.yml`	Hanya 1 kontainer `merica` (Port 14000, RAM ~100MB). Terhubung ke kluster Apache Airflow, PostgreSQL, dan MinIO eksternal.
2. All-in-One Appliance (Demo)	`docker-compose.all-in-one.yml`	Menjalankan MERICA bersama Apache Airflow 3 tertanam (Webserver: 14080, Scheduler, DAG Processor) untuk evaluasi lokal di 1 mesin.

Untuk menjalankan mode All-in-One (dengan Airflow lokal):

docker compose -f docker-compose.all-in-one.yml up -d

📚 Dokumentasi Lengkap

Seluruh panduan teknis tersedia terstruktur di dalam direktori docs/:

🗺️ Pusat Dokumentasi & Alur Membaca (Index Hub): Peta panduan lengkap dan rekomendasi alur membaca dokumen.
🏛️ Arsitektur Sistem: Topologi Single-Port Appliance (Port 14000), isolasi perimeter loopback, modul backend stateless, dan integrasi GitOps Airflow 3.
📦 Panduan Deployment & Build: Spesifikasi hardware ultra-ringan (~100MB RAM), instalasi cepat setup.sh, build image mandiri, dan upgrade runbook.
📘 Panduan Integrasi External Airflow: Dua metode penyiapan Airflow existing (Metode 1: Tanpa Rebuild dan Metode 2: Build Ulang Image Resmi) serta pengelolaan starter pipelines.
🎨 Panduan Penggunaan Canvas (User Guide): Tata cara merancang pipeline visual, database introspection & safe preview, Google Workspace discovery, dlt REST API, dan Shift-Left dbt testing.

🛑 Menghentikan Layanan

docker compose down

Untuk menghentikan dan membersihkan volume data:

docker compose down -v