Skip to main content

E-RPS (AVATAR)

Aplikasi: Avatar / ERPS (Advance Transaction Planning Reliability)
Perusahaan: PT Sanghiang Perkasa
Tipe Project: .NET Web Application
Versi: 3.3.0
Tim Product Terkait: Sigit Prianto Tjokronolo
Tanggal Dokumentasi: Januari 2026

🔗 Akses Aplikasi​

Berikut adalah alamat akses cepat untuk environment aplikasi:

EnvironmentURL AksesDeskripsi
🚀 Productionhttps://erps.kalbenutritionals.comEnvironment utama pengguna
🧪 Developmenthttps://erpsdev.kalbenutritionals.web.idTesting & staging area
⚙️ Hangfirehttps://erps.kalbenutritionals.com/hangfireDashboard Background Jobs

Deskripsi Proyek​

KN2021 E-RPS adalah sistem aplikasi web berbasis ASP.NET MVC yang dikembangkan untuk Kalbe Nutritionals. Sistem ini dirancang untuk mengelola perencanaan produksi, master data produk, dan transaksi terkait proses produksi di lingkungan manufaktur.

Arsitektur Aplikasi​

Proyek ini menggunakan arsitektur Multi-Layer Architecture dengan pemisahan yang jelas antara layer-layer berikut:

1. KN2021_E_RPS.MVC (Presentation Layer)​

  • Aplikasi web berbasis ASP.NET MVC 5
  • Menangani UI/UX dan interaksi pengguna
  • Menggunakan Bootstrap 4.6.2 untuk styling
  • Mengintegrasikan Hangfire untuk background jobs
  • Menggunakan Elmah untuk error logging

2. KN2021_E_RPS.BussLogic (Business Logic Layer)​

  • Berisi logika bisnis aplikasi
  • Menangani validasi dan aturan bisnis
  • Custom Business Logic untuk berbagai modul

3. KN2021_E_RPS.DAL (Data Access Layer)​

  • Layer untuk mengakses database
  • Menggunakan Entity Framework 6.4.4
  • Mendukung multiple database providers:
    • SQL Server (Entity Framework)
    • Oracle (Oracle Managed Data Access)
  • Berisi EDMX models dan database context

4. KN2021_E_RPS.Common (Common/Shared Layer)​

  • Berisi class-class yang digunakan bersama
  • Entity classes
  • DTO (Data Transfer Objects)
  • Interface definitions
  • Utility classes dan helper functions
  • Authentication dan authorization classes

5. Console Applications​

  • KN2021-E_RPS.Console.BoRPS: Console application untuk sinkronisasi data BO dari Oracle
  • KN2021-E_RPS.Console.ITEM: Console application untuk proses batch terkait item

Teknologi yang Digunakan​

Framework & Libraries​

  • ASP.NET MVC 5.2.7
  • Entity Framework 6.4.4
  • .NET Framework 4.7.2 / 4.8
  • Hangfire 1.8.14 - Background job processing
  • Elmah 1.2.2 - Error logging
  • AutoMapper - Object mapping
  • Dapper 2.0.123 - Micro ORM
  • Newtonsoft.Json 13.0.1 - JSON serialization

Database​

  • SQL Server - Database utama
  • Oracle Database - Database terintegrasi (untuk sinkronisasi data)

Frontend​

  • Bootstrap 4.6.2
  • jQuery 3.7.0
  • jQuery Validation 1.17.0

Reporting​

  • Microsoft Report Viewer 2015
  • EPPlus 7.4.1 - Excel file generation
  • NPOI 2.5.5 - Office file manipulation

Authentication & Security​

  • BotDetect Captcha 4.4.2
  • DotNetOpenAuth - OAuth/OpenID support

Struktur Proyek​

rps/
├── KN2021_E_RPS.MVC/              # Web Application (Presentation Layer)
│   ├── Controllers/                # MVC Controllers
│   │   ├── Master/                 # Master Data Controllers
│   │   ├── Transaction/           # Transaction Controllers
│   │   ├── System/                 # System Management Controllers
│   │   └── Avatar/                 # Avatar Module Controllers
│   ├── Views/                      # Razor Views
│   ├── Models/                     # View Models
│   ├── Content/                    # CSS, Images
│   ├── Scripts/                    # JavaScript files
│   └── App_Start/                  # Application startup configuration
│
├── KN2021_E_RPS.BussLogic/         # Business Logic Layer
│   └── CustomBL/                   # Custom Business Logic classes
│
├── KN2021_E_RPS.DAL/               # Data Access Layer
│   ├── Context/                    # Entity Framework Context
│   ├── Edmx/                       # Entity Data Models
│   ├── EFClientUtility.cs          # EF Helper
│   ├── OracleClientUtility.cs      # Oracle Helper
│   └── SqlClientUtility.cs         # SQL Server Helper
│
├── KN2021_E_RPS.Common/            # Common/Shared Layer
│   ├── Entity/                     # Entity classes
│   ├── Dto/                        # Data Transfer Objects
│   ├── Interface/                  # Interface definitions
│   ├── Library/                    # Utility libraries
│   └── Constant/                   # Constants
│
├── KN2021-E_RPS.Console.BoRPS/     # Console App - BO Synchronization
├── KN2021-E_RPS.Console.ITEM/     # Console App - Item Processing
│
├── sql/                            # Database scripts
├── packages/                       # NuGet packages
└── KN2021_E_RPS.sln               # Visual Studio Solution file

Fitur Utama​

Master Data Management​

  • Product Management: Pengelolaan data produk dan varian
  • Item Management: Manajemen item/material
  • Brand Management: Pengelolaan brand
  • Production Line: Manajemen line produksi
  • Shift Management: Pengelolaan shift kerja
  • Change Over Management:
    • Material Change Over
    • Metode Change Over
    • Production Line Change Over Detail
  • Alergen Management: Pengelolaan data alergen
  • Auger Management: Manajemen auger
  • Plan Down Time: Perencanaan downtime

Transaction Management​

  • RPS Transaction: Transaksi Request Planning System
  • Document Management: Manajemen dokumen transaksi
  • Adjustment Direct: Penyesuaian langsung

System Management​

  • User Management: Manajemen pengguna
  • Role & Access Control: Manajemen role dan akses
  • Menu Management: Konfigurasi menu aplikasi
  • Module Management: Manajemen modul
  • System Configuration: Konfigurasi sistem
  • Parameter Management: Manajemen parameter
  • Notification System: Sistem notifikasi
  • Language Management: Manajemen bahasa/translasi
  • Developer Panel: Panel untuk developer

Integration​

  • Oracle Integration: Sinkronisasi data dengan Oracle ERP
  • Background Jobs: Proses batch menggunakan Hangfire
  • Report Generation: Generate laporan dalam berbagai format

Prasyarat​

Software Requirements​

  • Visual Studio 2019 atau lebih baru
  • .NET Framework 4.7.2 atau lebih tinggi
  • SQL Server (versi yang didukung Entity Framework 6)
  • Oracle Client (jika menggunakan integrasi Oracle)
  • IIS (untuk deployment)

Database Setup​

  1. Restore database dari script SQL di folder sql/
  2. Konfigurasi connection string di Web.config
  3. Update Entity Framework models jika diperlukan

Konfigurasi​

Connection Strings​

Konfigurasi connection string dapat ditemukan di:

  • KN2021_E_RPS.MVC/Web.config - Untuk aplikasi web
  • KN2021_E_RPS.DAL/App.config - Untuk data access layer
  • KN2021_E_RPS.BussLogic/App.config - Untuk business logic layer

Environment Configuration​

Aplikasi mendukung beberapa environment:

  • Development
  • Testing
  • Production

Connection string dapat dikonfigurasi per environment dengan mengubah komentar di Web.config.

Cara Menjalankan Aplikasi​

Development Mode​

  1. Buka solution file KN2021_E_RPS.sln di Visual Studio
  2. Restore NuGet packages: 
    Tools > NuGet Package Manager > Package Manager Console
    PM> Update-Package -reinstall
  3. Pastikan connection string sudah dikonfigurasi dengan benar
  4. Build solution (Ctrl+Shift+B)
  5. Set KN2021_E_RPS.MVC sebagai startup project
  6. Jalankan aplikasi (F5)

Console Applications​

Untuk menjalankan console applications:

  1. Set project console sebagai startup project
  2. Jalankan aplikasi (F5) atau build dan jalankan executable

Deployment​

Web Application​

  1. Build solution dalam mode Release
  2. Publish aplikasi ke IIS:
    • Pilih project KN2021_E_RPS.MVC
    • Right-click > Publish
    • Pilih target deployment (IIS, File System, dll)
  3. Konfigurasi IIS:
    • Pastikan Application Pool menggunakan .NET Framework 4.x
    • Set identity dengan akses ke database
  4. Update connection strings di Web.config sesuai environment production

Console Applications​

  1. Build console applications dalam mode Release
  2. Deploy executable ke server
  3. Setup Windows Task Scheduler untuk menjalankan secara berkala (jika diperlukan)

Background Jobs (Hangfire)​

Aplikasi menggunakan Hangfire untuk menjalankan background jobs. Dashboard Hangfire dapat diakses melalui:

http://your-domain/hangfire

Catatan: Pastikan untuk mengkonfigurasi autentikasi untuk dashboard Hangfire di production.

Error Logging​

Aplikasi menggunakan Elmah untuk error logging. Log errors dapat diakses melalui:

http://your-domain/elmah

Database Scripts​

Script SQL untuk membuat tabel-tabel sistem dapat ditemukan di folder sql/:

  • mUser.Table.sql - Tabel user
  • mRole.Table.sql - Tabel role
  • mMenu.Table.sql - Tabel menu
  • mModule.Table.sql - Tabel modul
  • Dan lainnya...

Dependencies​

Semua dependencies dikelola melalui NuGet packages. File packages.config di setiap project berisi daftar package yang digunakan.

Untuk restore packages:

nuget restore KN2021_E_RPS.sln

Common Issues & Troubleshooting​