Skip to main content

Arsitektur Sistem Codeverta ERP

Halaman ini menjelaskan struktur teknis, alur data, komponen infrastruktur, dan skema arsitektur yang digunakan oleh Codeverta ERP Core.

Topologi Infrastruktur​

                               ┌─────────────────────────┐
                               │   Client / Web Browser  │
                               └────────────┬────────────┘
                                            │
                                            ▼
                               ┌─────────────────────────┐
                               │     HAProxy Router      │
                               │ (TLS, Tenant Subdomain) │
                               └────────────┬────────────┘
                                            │
                      ┌─────────────────────┴─────────────────────┐
                      ▼                                           ▼
          ┌───────────────────────┐                   ┌───────────────────────┐
          │  apps/admin (Frontend)│                   │ apps/backend (Gin API)│
          │  React 19 + Vite App  │                   │   Go REST microservice│
          └───────────────────────┘                   └───────────┬───────────┘
                                                                  │
                                            ┌─────────────────────┼─────────────────────┐
                                            ▼                     ▼                     ▼
                                  ┌──────────────────┐  ┌──────────────────┐  ┌──────────────────┐
                                  │ PostgreSQL DB    │  │ Redis Cache/Limit│  │ Tencent Cloud SES│
                                  │ (Tenant Schemas) │  │ (Sessions & Logs)│  │ (Email Delivery) │
                                  └──────────────────┘  └──────────────────┘  └──────────────────┘

Backend Application Layer (apps/backend)​

Backend ditulis dalam bahasa Go (Golang) menggunakan framework Gin dan ORM GORM. Struktur aplikasi mengadopsi pemisahan berbasis modul:

apps/backend/
├── cmd/                # Entrypoints tambahan & CLI helpers
├── common/             # Redis client, Zap logger, global DB instances
├── controller/         # Core controllers (Auth, User, Tenant, Order, Finance, dll)
├── database/           # Database setup, GORM connection, migration engines
├── dto/                # Data Transfer Objects untuk payload validasi
├── middleware/         # Auth, Tenant Resolver, Rate Limiter, Audit Plugin
├── model/              # Core GORM struct models (Tenant, User, Order, AuditLog, dll)
├── modules/            # Isolated business domain modules
│   ├── buying/         # Controller, Model, Routes untuk Pembelian
│   ├── selling/        # Controller, Model, Routes untuk Penjualan & POS
│   └── stock/          # Controller, Model, Routes untuk Inventoris & Stok
├── repository/         # Data access abstractions
├── router/             # Gin Router definitions (api-router, admin-router, crm-router, dll)
└── services/           # External service wrappers (Tencent SES, Payment Gateways, dll)

Multi-Tenancy Engine & Middleware​

1. Tenant Resolver Middleware (middleware.TenantResolver)​

  • Setiap request yang masuk ke grup API bertandatangan tenant dievaluasi oleh TenantResolver.
  • Resolver mendeteksi tenant dari header HTTP, subdomain URL, atau token klaim JWT.
  • tenant_id disimpan ke dalam gin.Context dan diinjeksikan ke dalam GORM plugin scope.

2. GORM Plugins Automatically Scoped​

  • Tenant Plugin (middleware.RegisterTenantPlugin): Menambahkan klausa filter tenant_id = ? secara otomatis pada query SELECT, UPDATE, dan DELETE.
  • Audit Plugin (middleware.RegisterAuditPlugin): Mencatat setiap perubahan data (INSERT, UPDATE, DELETE) ke tabel audit_logs secara transparan tanpa mengganggu logika bisnis.

Frontend Application Layer (apps/admin)​

Dashboard admin menggunakan React 19 yang dibundel oleh Vite:

  • State & Router: React Router v6 / Desk Navigation System.
  • Styling: Vanilla CSS Modules & Utility Classes dengan tema yang terkurasi.
  • Feature Modules: Terorganisir di src/modules/ (selling, buying, stock, crm, accounting, administration, settings).

Proxy & Routing Layer (haproxy/)​

HAProxy bertindak sebagai pintu gerbang (edge gateway) untuk perutean lalu lintas web:

  • erp.codeverta.com: Diteruskan ke container frontend apps/admin.
  • erp-api.codeverta.com: Diteruskan ke container backend apps/backend.
  • WebSocket Pass-through: Mendukung upgrade koneksi HTTP ke WebSocket untuk /api/ws/activity.