Lewati ke isi

Deployment Overview

Gambaran deploy komponen ERP & pipeline data. Bukan blueprint infra cloud lengkap — merangkum apa yang ada di repo.

Topology deploy (typical)

```mermaid flowchart TB subgraph host [Server aplikasi / sic] PM2[PM2: erp-backend, clickhouse-etl, migrasi-ui] DC[Docker Compose CDC stack] end

subgraph data_services [Data] PG[(PostgreSQL erp)] CH[(ClickHouse)] end

subgraph external [Eksternal] FB[Firebase] TS[Tailscale ops] end

PM2 --> PG PM2 --> CH DC --> PG DC --> CH FL[Flutter clients] --> PM2 FL --> FB OPS[Operator] --> TS TS --> PM2 ```

Komponen & artefak deploy

Komponen Artefak Start
PostgreSQL Paket/managed — skema dari database/ddl, migrations/ psql migrasi, database/RUNBOOK
NestJS API backend/dist — npm run build pm2 / systemd, port 3001
CDC stack database/cdc/docker-compose.yml docker compose up -d
ClickHouse ETL consumer_clickhouse.py pm2 restart clickhouse-etl
migrasi-ui Python/FastAPI main.py PM2, port 5000 (var)
Flutter Store/build APK — config API URL SETUP.md

Urutan bootstrap lingkungan baru

  1. PostgreSQL: 00_init → 01–04 → 11_logika (CLAUDE.md)
  2. Buat tenant: database/scripts/buat_tenant.sql
  3. Migrasi tenant: jalankan_migrasi_tenant.sh
  4. (Opsional) ETL legacy → PG
  5. ClickHouse DDL: migrations/clickhouse/V101+
  6. Initial load CH: SOP_INITIAL_LOAD
  7. CDC: compose + Debezium connector + publication
  8. Backend: env Firebase + ERP_* URL + CH credentials
  9. Verifikasi: CHECKLIST_SERVER.md

Environment variables (inti)

Variabel Pemakai
ERP_MIGRASI_URL Migrasi DDL
DATABASE_URL / pool tenant Backend runtime
TENANT_SCHEMAS Consumer CDC
KAFKA_BROKER Consumer
CLICKHOUSE_* Consumer + Backend
Firebase service account Backend auth

Secret tidak disimpan di Git — gunakan secret manager prod (07).

CI / quality gate

  • Lint + uji per workstream (07)
  • Migrasi bernomor wajib di review PR
  • Progress dashboard: npm run progress — ONBOARDING-TEAM.md

Asumsi: Pipeline CI spesifik belum didokumentasikan terpusat di repo.

Produksi vs DEV

Aspek DEV PRODUCTION
Kafka topic reset Diizinkan (migrasi-ui) Dilarang global
Debezium Stop/recreate OK Always-on; tenant-scoped change
API destructive ops migrasi-ui Control plane + approval

OPERATING_MODEL.md.

Dokumen terkait