Skip to main content

📋 WasteMS

Aplikasi: Waste Management System
Perusahaan: PT Sanghiang Perkasa
Tipe Project: .NET Web Application
Tim Product Terkait: Hendi Hendrasta
Tanggal Dokumentasi: Januari 2026

KN2019 Waste Management System

🔗 Akses Aplikasi​

Berikut adalah alamat akses cepat untuk environment aplikasi:

EnvironmentURL AksesDeskripsi
🚀 Productionhttps://wastems.kalbenutritionals.comEnvironment utama pengguna
🧪 Developmenthttps://wastemsdev.kalbenutritionals.web.idTesting & staging area

Deskripsi Proyek​

Waste Limbah API adalah aplikasi Web API berbasis .NET Core untuk manajemen limbah (waste management) yang dikembangkan oleh Kalbe Nutritionals. Aplikasi ini menyediakan endpoint untuk mengelola data master limbah, transaksi, dan laporan terkait pengelolaan limbah.

Teknologi yang Digunakan​

Framework & Runtime​

  • .NET 5.0 - Framework utama
  • ASP.NET Core Web API - Framework untuk membangun RESTful API

Database​

  • PostgreSQL - Database utama menggunakan Npgsql.EntityFrameworkCore.PostgreSQL
  • Oracle Database - Database sekunder untuk integrasi dengan sistem Oracle
  • Entity Framework Core 5.0.10 - ORM untuk akses database

Caching & Session​

  • Redis - Caching menggunakan StackExchange.Redis (v2.6.86)
  • Distributed Memory Cache - Session management

Lainnya​

  • Swagger/OpenAPI - Dokumentasi API (Swashbuckle.AspNetCore v5.6.3)
  • Newtonsoft.Json - JSON serialization
  • NPOI - Excel file processing (DotNetCore.NPOI v1.2.3)
  • Reporting - RDLC reports (AspNetCore.Reporting v2.1.0, ReportViewerCore.NETCore v15.1.14)
  • Docker - Containerization support

Struktur Proyek​

Proyek ini menggunakan arsitektur layered (berlapis) dengan struktur sebagai berikut:

kn2022_wastelimbahapi/
├── WasteLimbahAPI/                    # API Layer (Presentation)
│   ├── Controllers/                   # API Controllers
│   │   ├── Master/                    # Master Data Controllers
│   │   │   ├── LimbahController.cs
│   │   │   ├── PictogramController.cs
│   │   │   ├── PictogramLimbahController.cs
│   │   │   ├── PrLimbahController.cs
│   │   │   └── UomController.cs
│   │   ├── Transaction/               # Transaction Controllers
│   │   │   ├── BbkController.cs
│   │   │   ├── DashboardController.cs
│   │   │   ├── KlhkController.cs
│   │   │   ├── LineTransactionController.cs
│   │   │   ├── PrOracleController.cs
│   │   │   └── RequestLimbahController.cs
│   │   └── PrintController.cs
│   ├── ReportFiles/                   # RDLC Report Files
│   ├── Images/                        # Image Assets
│   ├── Print/                         # Print Service
│   ├── Startup.cs                     # Application Startup Configuration
│   ├── Program.cs                     # Application Entry Point
│   └── appsettings.json              # Configuration File
│
├── KN2022_WasteLimbah.BussLogic/      # Business Logic Layer
│   ├── Master/                        # Master Data Business Logic
│   │   ├── clsMLimbahBL.cs
│   │   ├── clsMPictogramBL.cs
│   │   ├── clsMPictogramLimbahBL.cs
│   │   ├── clsMPrLimbahBL.cs
│   │   └── clsMUomBL.cs
│   └── Transaction/                   # Transaction Business Logic
│       ├── clsDashboardBL.cs
│       ├── clsTrBbkBL.cs
│       ├── clsTrKlhkBL.cs
│       ├── clsTrLineTransactionBL.cs
│       ├── clsTrPrOracleBL.cs
│       └── clsTrRequestLimbahBL.cs
│
├── KN2022_WasteLimbah.DAL/            # Data Access Layer
│   ├── Context/                       # DbContext
│   │   └── WasteLimbahDBContext.cs
│   ├── Models/                        # Entity Models
│   │   ├── Mlimbah.cs
│   │   ├── Mpictogram.cs
│   │   ├── Mpictogramlimbah.cs
│   │   ├── Mprlimbah.cs
│   │   ├── Muom.cs
│   │   ├── Trbbk.cs
│   │   ├── Trbbkdetail.cs
│   │   ├── Trklhk.cs
│   │   ├── Trlinetransaction.cs
│   │   ├── Trproracle.cs
│   │   └── Trrequestlimbah.cs
│   └── EFHelper.cs                    # Entity Framework Helper
│
└── KN2022_WasteLimbah.Common/         # Common/Shared Layer
    ├── ConfigModel/                   # Configuration Models
    │   ├── AppConnectionString.cs
    │   ├── AppSettings.cs
    │   └── WSOHelperModel.cs
    ├── Entity/                        # Common Entities
    └── Library/                       # Shared Libraries & Utilities

Persyaratan Sistem​

Development Environment​

  • .NET 5.0 SDK atau lebih tinggi
  • Visual Studio 2019/2022 atau Visual Studio Code
  • PostgreSQL (untuk database utama)
  • Oracle Database Client (untuk koneksi ke Oracle)
  • Redis Server (untuk caching)

Runtime Requirements​

  • .NET 5.0 Runtime
  • PostgreSQL Database
  • Oracle Database (opsional, jika diperlukan)
  • Redis Server

Konfigurasi​

1. Connection Strings​

Edit file WasteLimbahAPI/appsettings.json untuk mengkonfigurasi connection strings:

{
  "ConnectionStrings": {
    "LimbahConnection": "<encrypted_postgresql_connection_string>",
    "OracleConnection": "<encrypted_oracle_connection_string>"
  },
  "RedisConnection": "redisappdev.kalbenutritionals.com,abortConnect=false"
}

Catatan: Connection strings menggunakan enkripsi. Pastikan untuk menggunakan connection string yang sesuai dengan environment (Local/Dev/Prod).

2. App Settings​

{
  "AppSettings": {
    "Secret": "THIS IS USED TO SIGN AND VERIFY JWT TOKENS, REPLACE IT WITH YOUR OWN SECRET"
  }
}

3. Environment Configuration​

  • Development: appsettings.Development.json
  • Production: appsettings.json (default)

Instalasi & Setup​

1. Clone Repository​

git clone <repository-url>
cd kn2022_wastelimbahapi

2. Restore NuGet Packages​

dotnet restore

Atau melalui Visual Studio:

  • Klik kanan pada solution → Restore NuGet Packages

3. Build Solution​

dotnet build

Atau melalui Visual Studio:

  • Build → Build Solution (Ctrl+Shift+B)

4. Update Database Connection​

Edit appsettings.json dengan connection string yang sesuai dengan environment Anda.

5. Run Application​

cd WasteLimbahAPI
dotnet run

Atau melalui Visual Studio:

  • Tekan F5 atau klik Run

Aplikasi akan berjalan di:

  • HTTP: http://localhost:5000
  • HTTPS: https://localhost:5001

6. Akses Swagger Documentation​

Setelah aplikasi berjalan, akses Swagger UI di:

https://localhost:5001/swagger

Database Schema​

Master Tables​

  • mlimbah - Master data limbah
  • mpictogram - Master pictogram
  • mpictogramlimbah - Relasi pictogram dengan limbah
  • mprlimbah - Master PR limbah
  • muom - Master Unit of Measurement

Transaction Tables​

  • trklhk - Transaksi KLHK
  • trbbk - Transaksi BBK (Berita Acara)
  • trlinetransaction - Transaksi line detail
  • trproracle - Transaksi PR Oracle
  • trrequestlimbah - Transaksi request limbah

API Endpoints​

Master Data APIs​

Limbah​

  • POST /api/Limbah/GetAllPaging - Get all limbah dengan paging
  • POST /api/Limbah/Get - Get limbah by ID
  • POST /api/Limbah/GetAllActive - Get all active limbah
  • POST /api/Limbah/Save - Save/Update limbah
  • POST /api/Limbah/Delete - Delete limbah
  • POST /api/Limbah/GetAllByType - Get limbah by type

Pictogram​

  • POST /api/Pictogram/* - CRUD operations untuk pictogram

UOM (Unit of Measurement)​

  • POST /api/Uom/* - CRUD operations untuk UOM

Transaction APIs​

KLHK​

  • POST /api/Klhk/* - Transaksi KLHK operations

BBK (Berita Acara)​

  • POST /api/Bbk/* - Transaksi BBK operations

Request Limbah​

  • POST /api/RequestLimbah/* - Request limbah operations

Dashboard​

  • POST /api/Dashboard/* - Dashboard data operations
  • POST /api/Print/* - Print report operations

Request/Response Format​

Semua API menggunakan format request standar:

{
  "objRequestData": {
    // Request parameters sesuai endpoint
  },
  "txtUsername": "username",
  "bitError": false,
  "txtErrorMessage": null,
  "objData": null
}

Response format:

{
  "bitError": false,
  "txtErrorMessage": null,
  "objData": {
    // Response data
  }
}

Docker Support​

Proyek ini mendukung containerization dengan Docker. File Dockerfile sudah tersedia di folder WasteLimbahAPI/.

Build Docker Image​

docker build -t wastelimbah-api .

Run Docker Container​

docker run -p 8080:80 wastelimbah-api

Reporting​

Aplikasi menggunakan RDLC reports untuk generate laporan:

  • BBK.rdlc - Laporan Berita Acara
  • LabelKuning.rdlc - Label Kuning
  • Pictogram.rdlc - Laporan Pictogram

Report files berada di folder WasteLimbahAPI/ReportFiles/.

Caching​

Aplikasi menggunakan Redis untuk caching:

  • Redis Connection: Dikonfigurasi di appsettings.json
  • Cache Service: Implementasi di KN2022_WasteLimbah.Common

Dependencies​

NuGet Packages​

API Layer​

  • AspNetCore.Reporting (v2.1.0)
  • DotNetCore.NPOI (v1.2.3)
  • Microsoft.AspNetCore.Mvc.NewtonsoftJson (v3.1.2)
  • ReportViewerCore.NETCore (v15.1.14)
  • StackExchange.Redis (v2.6.86)
  • Swashbuckle.AspNetCore (v5.6.3)
  • System.Drawing.Common (v5.0.2)
  • System.Text.Encoding.CodePages (v5.0.0)

DAL Layer​

  • Microsoft.EntityFrameworkCore.SqlServer (v5.0.10)
  • Microsoft.EntityFrameworkCore.Design (v5.0.10)
  • Microsoft.EntityFrameworkCore.Tools (v5.0.10)
  • Npgsql.EntityFrameworkCore.PostgreSQL (v5.0.10)
  • Npgsql.EntityFrameworkCore.PostgreSQL.Design (v1.1.0)
  • Oracle.EntityFrameworkCore (v5.21.1)

Common Layer​

  • Microsoft.AspNetCore.Hosting (v2.2.7)
  • Microsoft.AspNetCore.Http (v2.2.2)
  • Microsoft.Extensions.Options (v5.0.0)
  • StackExchange.Redis (v2.6.86)

External DLLs​

  • KN2021_GlobalClient-NetCore.dll - Global client library (berada di WasteLimbahAPI/AdditionalDLL/)

Security​

  • Connection strings dienkripsi untuk keamanan
  • JWT token support (dikonfigurasi di AppSettings)
  • CORS policy dikonfigurasi untuk allow all origins (perlu disesuaikan untuk production)

Development Guidelines​

Code Structure​

  • Menggunakan naming convention PascalCase untuk class dan method
  • Menggunakan prefix cls untuk business logic classes
  • Menggunakan prefix M untuk master entities
  • Menggunakan prefix Tr untuk transaction entities

Best Practices​

  1. Separation of Concerns: Setiap layer memiliki tanggung jawab yang jelas
  2. Dependency Injection: Menggunakan DI untuk loose coupling
  3. Error Handling: Semua endpoint memiliki try-catch untuk error handling
  4. Configuration: Menggunakan strongly-typed configuration models