Skip to main content

Waste Limbah API - Dokumentasi Handover

📋 Deskripsi Project​

Project ini adalah sistem API untuk manajemen limbah (Waste Management) Kalbe Nutritionals. Sistem ini mengelola data master limbah, pictogram, dan transaksi terkait limbah termasuk integrasi dengan Oracle EBS.

🔧 Teknologi & Stack​

KomponenDetail
Framework.NET Core 5.0
IDEVisual Studio 2019 ke atas
Database PrimaryPostgreSQL
Database SecondaryOracle (EBS Integration)
CacheRedis
ORMEntity Framework Core
API DocumentationSwagger/OpenAPI
ReportingRDLC Reports

🌐 Environment & Server Information​

Development/Production Server​

  • Server IP: 10.104.1.134
  • Database: WasteLimbahDB
  • DB User: usrWasteLimbah
  • DB Password: usrWasteLimbah
  • Redis Server: redisappdev.kalbenutritionals.com

Status​

  • ✅ CI/CD - Tested & Running

📁 Struktur Project​

1. WasteLimbahAPI (Main API Project)​

Entry point utama aplikasi. Berisi controllers, configurations, dan reporting.

Key Components:

  • Program.cs - Entry point aplikasi
  • Startup.cs - Konfigurasi services dan middleware
  • appsettings.json - Konfigurasi aplikasi (connection strings, Redis, etc.)
  • Controllers/ - API endpoints
    • Master/ - Master data controllers
    • Transaction/ - Transaction controllers
  • ReportFiles/ - RDLC report templates
  • Print/ - Print service implementation

2. KN2022_WasteLimbah.BussLogic (Business Logic Layer)​

Berisi semua logika bisnis aplikasi.

Structure:

├── Master/
│   ├── clsMLimbahBL.cs              # Business logic untuk master limbah
│   ├── clsMPictogramBL.cs           # Business logic untuk master pictogram
│   ├── clsMPictogramLimbahBL.cs     # Business logic untuk relasi pictogram-limbah
│   ├── clsMPrLimbahBL.cs            # Business logic untuk PR limbah
│   └── clsMUomBL.cs                 # Business logic untuk unit of measure
│
└── Transaction/
    ├── clsDashboardBL.cs            # Business logic untuk dashboard
    ├── clsTrBbkBL.cs                # Business logic untuk transaksi BBK
    ├── clsTrKlhkBL.cs               # Business logic untuk transaksi KLHK
    ├── clsTrLineTransactionBL.cs    # Business logic untuk line transaction
    ├── clsTrPrOracleBL.cs           # Business logic untuk PR dari Oracle
    └── clsTrRequestLimbahBL.cs      # Business logic untuk request limbah

3. KN2022_WasteLimbah.DAL (Data Access Layer)​

Layer untuk akses database menggunakan Entity Framework Core.

Key Components:

  • Context/
    • WasteLimbahDBContext.cs - DbContext untuk PostgreSQL
    • OracleContext.cs - DbContext untuk Oracle EBS
    • OracleLOBContext.cs - DbContext khusus untuk Oracle LOB
  • Models/ - Entity models yang mapping ke database tables
    • Master data models (Mlimbah, Mpictogram, Muom, dll)
    • Transaction models (Trbbk, Trklhk, Trrequestlimbah, dll)
    • Oracle models (XxshpGreenwmsRequisition, XxshpWmslobV)

4. KN2022_WasteLimbah.Common (Common Library)​

Library untuk komponen yang digunakan bersama di seluruh project.

Structure:

├── ConfigModel/
│   ├── AppConnectionString.cs       # Model untuk connection strings
│   ├── AppSettings.cs               # Model untuk app settings
│   └── WSOHelperModel.cs            # Model untuk WSO configuration
│
├── Entity/
│   ├── clsPrintModel.cs             # Model untuk printing
│   ├── Master/                      # Master data entities
│   └── Oracle/                      # Oracle entities
│
└── Library/
    ├── AppServicesHelper.cs         # Helper untuk dependency injection
    ├── clsAntiXSS.cs                # Security helper untuk anti-XSS
    ├── clsGlobalClass.cs            # Global utility class
    ├── clsGlobalConstant.cs         # Global constants
    ├── clsPagingModelRequest.cs     # Paging model untuk API
    ├── clsRijndael.cs               # Encryption/Decryption helper
    ├── Cache/                       # Redis cache implementation
    ├── CustomAttribute/             # Custom attributes
    └── Interface/                   # Interface definitions

🗄️ Database​

PostgreSQL (Primary Database)​

Database utama untuk menyimpan data master dan transaksi limbah.

Main Tables:

  • Master Tables

    • mlimbah - Master data limbah
    • mpictogram - Master pictogram
    • mpictogramlimbah - Relasi pictogram dengan limbah
    • mprlimbah - Master PR limbah
    • muom - Master unit of measure

  • Transaction Tables

    • trbbk - Transaksi BBK (Buku Berita Kegiatan)
    • trbbkdetail - Detail transaksi BBK
    • trklhk - Transaksi KLHK (Kementerian Lingkungan Hidup)
    • trlinetransaction - Transaksi line
    • trproracle - Transaksi PR dari Oracle
    • trrequestlimbah - Request limbah

Oracle (Secondary Database)​

Integrasi dengan Oracle EBS untuk data PR dan WMS.

Views/Tables:

  • xxshp_greenwms_requisition - Data requisition dari WMS
  • xxshp_wmslob_v - View untuk LOB data

🔐 Security & Configuration​

Encryption​

  • Connection strings di-encrypt menggunakan Rijndael algorithm
  • Implementasi ada di clsRijndael.cs

Anti-XSS Protection​

  • Proteksi input dari XSS attack
  • Implementasi di clsAntiXSS.cs

CORS Policy​

  • Configured untuk allow any origin (development)
  • Bisa dikustomisasi di Startup.cs

📡 API Endpoints​

Master Data APIs​

1. Limbah Controller (/api/Limbah)​

  • Manajemen master data limbah

2. Pictogram Controller (/api/Pictogram)​

  • Manajemen master pictogram

3. Pictogram Limbah Controller (/api/PictogramLimbah)​

  • Manajemen relasi pictogram dengan limbah

4. PR Limbah Controller (/api/PrLimbah)​

  • Manajemen PR limbah

5. UOM Controller (/api/Uom)​

  • Manajemen unit of measure

Transaction APIs​

1. BBK Controller (/api/Bbk)​

  • Transaksi Buku Berita Kegiatan (BBK)
  • Generate laporan BBK

2. KLHK Controller (/api/Klhk)​

  • Transaksi KLHK
  • Pelaporan ke Kementerian Lingkungan Hidup

3. Request Limbah Controller (/api/RequestLimbah)​

  • Request pengelolaan limbah
  • Approval workflow

4. Line Transaction Controller (/api/LineTransaction)​

  • Transaksi per line produksi

5. PR Oracle Controller (/api/PrOracle)​

  • Integrasi PR dengan Oracle EBS

6. Dashboard Controller (/api/Dashboard)​

  • Data untuk dashboard analytics

Utility APIs​

  • Generate PDF reports
  • Print labels dan dokumen

📊 Reporting​

Report Templates (RDLC)​

Located in ReportFiles/ folder:

  1. BBK.rdlc

    • Template untuk laporan BBK

  2. Pictogram.rdlc

    • Template untuk print pictogram

  3. LabelKuning.rdlc

    • Template untuk label kuning limbah
  • Implementasi: WasteLimbah.Print.PrintService
  • Support: PDF generation
  • Library: AspNetCore.Reporting

🚀 Setup & Installation​

Prerequisites​

  1. Visual Studio 2019 atau lebih baru
  2. .NET Core 5.0 SDK
  3. PostgreSQL Client
  4. Oracle Client (untuk Oracle connectivity)
  5. Redis (optional, untuk caching)

Step-by-Step Installation​

  1. Clone Repository

    git clone <repository-url>
    cd kn2022_wastelimbahapi

  2. Restore NuGet Packages

    dotnet restore

  3. Update Connection Strings

    • Edit WasteLimbahAPI/appsettings.json
    • Update LimbahConnection (PostgreSQL)
    • Update OracleConnection (jika diperlukan)
    • Update RedisConnection (jika menggunakan Redis)

  4. Database Migration (jika ada)

    dotnet ef database update --project KN2022_WasteLimbah.DAL

  5. Build Solution

    dotnet build

  6. Run Application

    cd WasteLimbahAPI
    dotnet run

  7. Access Swagger UI

    • URL: https://localhost:5001/swagger
    • atau http://localhost:5000/swagger

🐳 Docker Deployment​

Project sudah include Dockerfile untuk containerization.

Build Docker Image​

docker build -t wastelimbah-api:latest .

Run Container​

docker run -p 8080:80 -p 8443:443 wastelimbah-api:latest

🔄 CI/CD​

Status: ✅ Tested & Running

Pipeline Configuration​

  • CI/CD sudah dikonfigurasi dan tested
  • Automated deployment tersedia
  • Detail pipeline tergantung platform yang digunakan (GitLab CI, Azure DevOps, dll)

📦 Dependencies​

Main Packages​

  • Entity Framework Core - ORM
  • Oracle.EntityFrameworkCore - Oracle provider
  • Npgsql.EntityFrameworkCore.PostgreSQL - PostgreSQL provider
  • StackExchange.Redis - Redis client
  • Swashbuckle.AspNetCore - Swagger/OpenAPI
  • AspNetCore.Reporting - RDLC reporting
  • Microsoft.VisualStudio.Web.CodeGeneration.Design - Code generation

🧪 Testing​

API Testing​

  • Gunakan Swagger UI untuk testing endpoints
  • URL: /swagger

📝 Naming Conventions​

Classes​

  • BL suffix = Business Logic (e.g., clsMLimbahBL)
  • cls prefix = Class (legacy naming)
  • Tr prefix = Transaction entities
  • M prefix = Master entities

Database​

  • Lowercase naming untuk tables dan columns
  • Prefix conventions:
    • m = Master tables
    • tr = Transaction tables
    • xxshp_ = Oracle custom tables/views

🔍 Troubleshooting​

Common Issues​

  1. Oracle Connection Failed

    • Pastikan Oracle Client terinstall
    • Verify Oracle connection string
    • Check network connectivity ke Oracle server

  2. Report Generation Failed

    • Pastikan RDLC files ada di folder ReportFiles/
    • Check CopyToOutputDirectory property di csproj
    • Verify AspNetCore.Reporting package installed

📚 Additional Resources​

Documentation Locations​

  • API Documentation: Swagger UI (/swagger)
  • Database Schema: Check scaffoldingBD.txt in DAL project

Code References​

  • Connection String Management: AppConnectionString.cs
  • Global Settings: clsGlobalClass.cs, clsGlobalConstant.cs
  • Cache Implementation: Cache/ folder in Common project
  • Security Utils: clsAntiXSS.cs, clsRijndael.cs