📋 SIMANTRA - WEB

Aplikasi: SIMANTRA
Perusahaan: PT Sanghiang Perkasa
Tipe Project: .NET Web Application & Flutter Application
Tim Product Terkait: Hendi Hendrasta & Adhi Rizaldi
Tanggal Dokumentasi: Januari 2026

---

📋 Daftar Isi

• Pendahuluan
• Arsitektur Sistem
• Struktur Project
• Komponen Utama
• Teknologi & Framework
• Database & Koneksi
• API Endpoints
• Scheduler & Background Jobs
• Deployment
• Troubleshooting
• Kontak & Support

---

🔗 Akses Aplikasi

Berikut adalah alamat akses cepat untuk environment aplikasi:

Environment	URL Akses	Deskripsi
🚀 Production	https://svnet.kalbenutritionals.com	Environment utama pengguna
🧪 Development	https://svnetdev.kalbenutritionals.web.id	Testing & staging area

---

🎯 Pendahuluan

Tentang SIMANTRA (Sistem Manajemen Transportasi)

SIMANTRA adalah sistem manajemen transportasi yang terintegrasi dengan sistem B2B Kalbe Nutritionals. Sistem ini mengelola seluruh proses transportasi mulai dari perencanaan order, loading, tracking, unloading, hingga reporting.

Tujuan Dokumentasi

Dokumentasi ini dibuat untuk memudahkan proses handover dan membantu tim developer baru memahami struktur, komponen, dan cara kerja modul SMT/SIMANTRA.

Lingkup Sistem

• Manajemen Order & Planning Order
• Proses Loading & Unloading
• Tracking & Timeline Pengiriman
• Dashboard & Reporting
• Auto GRN (Goods Receipt Note)
• Integrasi dengan Oracle APPS
• Mobile Apps API

---

🏗️ Arsitektur Sistem

Pola Arsitektur

Sistem menggunakan N-Layer Architecture dengan pemisahan concerns:

┌─────────────────────────────────────┐
│     Presentation Layer (API)        │
│   KN2019_B2B.App.SMT.Api            │
└──────────────┬──────────────────────┘
               │
┌──────────────▼──────────────────────┐
│        Business Logic Layer         │
│  KN2018_B2B.Transaction.SMT.Logic   │
│  KN2018_B2B.Master.SMT.Logic        │
└──────────────┬──────────────────────┘
               │
┌──────────────▼──────────────────────┐
│       Data Access Layer (DAL)       │
│ KN2018_B2B.Transaction.SMT.DataAccess│
│ KN2018_B2B.Master.SMT.DataAccess    │
└──────────────┬──────────────────────┘
               │
┌──────────────▼──────────────────────┐
│         Models & ViewModels         │
│  KN2018_B2B.Transaction.SMT.Models  │
│  KN2018_B2B.Master.SMT.Models       │
└─────────────────────────────────────┘

Integrasi Sistem

• Oracle EBS (APPS): Integrasi untuk master data dan transaksi
• Global API: Integrasi dengan sistem global Kalbe
• Mobile Apps: API untuk aplikasi mobile transporter
• Scheduler Jobs: Background process untuk sinkronisasi dan blast order

---

📂 Struktur Project

1. KN2018_B2B.Master.SMT.DataAccess

Fungsi: Data Access Layer untuk Master Data SMT

├── Context/              # Database Context
├── Edmx/                # Entity Data Model
├── Properties/          # Assembly Info
├── App.Config           # Configuration
└── packages.config      # NuGet Packages

Teknologi:

• Entity Framework 6
• Oracle.ManagedDataAccess
• LINQ to Entities

---

2. KN2018_B2B.Master.SMT.Logic

Fungsi: Business Logic untuk Master Data SMT

├── Logic/               # Business Logic Classes
├── Properties/          # Assembly Info
├── app.config          # Configuration
└── packages.config     # NuGet Packages

Komponen Utama:

• Master data processing
• Validation rules
• Business rules implementation

---

3. KN2018_B2B.Master.SMT.Models

Fungsi: Data Models untuk Master SMT

├── Models/             # Entity Models
├── ModelsAPPS/         # Oracle APPS Models
├── ViewModel/          # View Models
├── Properties/         # Assembly Info
└── packages.config    # NuGet Packages

Jenis Models:

• Entity Models: Mapping dari database tables
• View Models: Data transfer objects untuk UI/API
• APPS Models: Integration models dengan Oracle APPS

---

4. KN2018_B2B.Transaction.SMT.DataAccess

Fungsi: Data Access Layer untuk Transaksi SMT

├── Context/            # Database Context
├── Dal/                # Data Access Layer Classes
│   ├── DalAutoGrn.cs
│   ├── DALChecker.cs
│   ├── DALLoading.cs
│   ├── DALSecurity.cs
│   ├── DalSMTTransaction.cs
│   ├── DalSmtTScheduler.cs
│   └── DALUnloading.cs
├── Edmx/              # Entity Data Model
├── SMTOracleADO.cs    # Oracle ADO.NET Helper
├── App.Config         # Configuration
└── packages.config    # NuGet Packages

DAL Classes:

• DalAutoGrn: Auto Goods Receipt Note processing
• DALChecker: Checker/security guard operations
• DALLoading: Loading process data access
• DALSecurity: Security & authentication
• DalSMTTransaction: General SMT transactions
• DalSmtTScheduler: Scheduler operations
• DALUnloading: Unloading process data access

---

5. KN2018_B2B.Transaction.SMT.Logic

Fungsi: Business Logic untuk Transaksi SMT

├── clsEmail/          # Email notification classes
├── Logic/             # Business Logic Classes
│   ├── SMT_AutoGRNLogic.cs
│   ├── SMT_DashboardLogic.cs
│   ├── SMT_ExpeditionLogic.cs
│   ├── SMT_FillLogic.cs
│   ├── SMT_OrderLogic.cs
│   ├── SMT_PlanningOrderLogic.cs
│   ├── SMT_ReportingLogic.cs
│   ├── SMT_SchedulerLogic.cs
│   ├── SMT_SIMONS.cs
│   ├── SMT_SPMLogic.cs
│   └── SMT_TimelineLogic.cs
├── Properties/        # Assembly Info
├── App.config        # Configuration
└── packages.config   # NuGet Packages

Logic Classes:

• SMT_AutoGRNLogic: Automatic GRN creation & processing
• SMT_DashboardLogic: Dashboard data aggregation
• SMT_ExpeditionLogic: Expedition management
• SMT_FillLogic: Data filling operations
• SMT_OrderLogic: Order management
• SMT_PlanningOrderLogic: Order planning & scheduling
• SMT_ReportingLogic: Report generation
• SMT_SchedulerLogic: Background scheduler operations
• SMT_SIMONS: Integration dengan SIMONS system
• SMT_SPMLogic: SPM (Supplier Performance Management)
• SMT_TimelineLogic: Timeline tracking & monitoring

---

6. KN2018_B2B.Transaction.SMT.Models

Fungsi: Models & ViewModels untuk Transaksi SMT

├── Auto_GRN_Enhancement/     # Auto GRN enhancement models
├── Constant/                 # Constants & enumerations
├── Models/                   # Entity Models
├── request_vm/              # Request ViewModels
├── response_vm/             # Response ViewModels
├── scheduler/               # Scheduler models
├── smt_enhancement_2023/    # Enhancement 2023 models
├── ViewModels/              # General ViewModels
├── SMTTransactionUtilFunc.cs # Utility functions
├── app.config               # Configuration
└── packages.config          # NuGet Packages

Jenis Models:

• Request ViewModels: Input models untuk API
• Response ViewModels: Output models dari API
• Entity Models: Database entity mapping
• Scheduler Models: Background job models
• Enhancement Models: New features models

---

7. KN2019_B2B.App.SMT.Api ⭐ (Main API Project)

Fungsi: RESTful API untuk SIMANTRA

├── ActionFilter/      # Custom action filters
├── App_Data/         # Application data files
├── App_Start/        # Application startup configs
│   ├── WebApiConfig.cs
│   ├── RouteConfig.cs
│   ├── FilterConfig.cs
│   ├── BundleConfig.cs
│   └── AutoMapperConfig.cs
├── Areas/            # MVC Areas
├── Common/           # Common utilities
├── Content/          # CSS, images, etc.
├── Controllers/      # API Controllers
│   ├── Simantra/    # SMT-specific controllers
│   │   ├── SMTAuthController.cs
│   │   ├── SMTBaseController.cs
│   │   ├── SMTCheckerController.cs
│   │   ├── SMTLoadingController.cs
│   │   ├── SMTMosTransController.cs
│   │   ├── SMTNCBACController.cs
│   │   ├── SMTScanRouteController.cs
│   │   ├── SMTSecurityController.cs
│   │   ├── SMTUnloadingController.cs
│   │   └── SMTV2MasterController.cs
│   ├── HomeController.cs
│   ├── LogController.cs
│   ├── MasterController.cs
│   └── TransactionsController.cs
├── Data/             # Data files
├── DataUpload/       # Upload storage
├── Models/           # API models
├── Providers/        # Custom providers
├── Reports/          # Report templates
├── Results/          # Result files
├── Scripts/          # JavaScript files
├── USER_DATA/        # User uploaded data
├── Views/            # MVC Views
├── Global.asax       # Application entry point
├── Startup.cs        # OWIN startup
├── Web.config        # Web configuration
└── packages.config   # NuGet packages

API Controllers (Simantra):

• SMTAuthController: Authentication & authorization
• SMTBaseController: Base controller dengan common functions
• SMTCheckerController: Checker operations (security guard)
• SMTLoadingController: Loading process API
• SMTMosTransController: MOS transaction
• SMTNCBACController: NCBAC operations
• SMTScanRouteController: Route scanning
• SMTSecurityController: Security operations
• SMTUnloadingController: Unloading process API
• SMTV2MasterController: Master data v2

---

8. KN2023_B2B.SMTTransporter.Scheduler

Fungsi: Background Scheduler untuk SMT Transporter

├── SMTTransporter.BlastOrder.Scheduler/
│   ├── Program.cs
│   ├── App.config
│   ├── Properties/
│   └── packages.config
└── SMTTransporter.SyncOracle.Scheduler/
    ├── Program.cs
    ├── App.config
    ├── Properties/
    └── packages.config

Scheduler Jobs:

• BlastOrder.Scheduler: Blast order otomatis ke transporter
• SyncOracle.Scheduler: Sinkronisasi data dengan Oracle APPS

---

💻 Teknologi & Framework

Backend

• .NET Framework 4.7.2+
• ASP.NET Web API 2
• ASP.NET MVC 5
• Entity Framework 6
• LINQ

Database

• Oracle Database (Primary)
  • Oracle EBS (APPS)
  • Custom SIMANTRA tables
• SQL Server (Logging & Monitoring)

Libraries & Packages

• AutoMapper: Object-to-object mapping
• Newtonsoft.Json: JSON serialization
• Oracle.ManagedDataAccess: Oracle database connectivity
• Elmah: Error logging
• BotDetect: Captcha implementation
• Hangfire: Background job scheduling (if used)

Authentication

• OAuth 2.0
• Bearer Token Authentication
• Custom Authorization Provider

---

🗄️ Database & Koneksi

Connection Strings

Connection strings didefinisikan di Web.config:

<!-- Master & Transaction Entities -->
<add name="MasterEntities" 
     connectionString="..." 
     providerName="System.Data.EntityClient" />

<add name="SystemsEntities" 
     connectionString="..." 
     providerName="System.Data.EntityClient" />

<add name="TransactionEntities" 
     connectionString="..." 
     providerName="System.Data.EntityClient" />

Database Servers

Development:

• Service: SHPDEV2
• Schema: APPS

Production:

• (Update sesuai environment production)

Entity Framework Context

• MasterEntities: Master data context
• SystemsEntities: System configuration context
• TransactionEntities: Transaction data context

---

🔌 API Endpoints

Base URL

• Development: http://localhost:[port]/api/
• Production: https://appgw.kalbenutritionals.com/api/simantra/

Authentication Endpoints

POST   /api/Simantra/SMTAuth/Login
POST   /api/Simantra/SMTAuth/Logout
POST   /api/Simantra/SMTAuth/RefreshToken
GET    /api/Simantra/SMTAuth/ValidateToken

Master Data Endpoints

GET    /api/Simantra/SMTV2Master/GetMasterData
GET    /api/Simantra/SMTV2Master/GetVehicles
GET    /api/Simantra/SMTV2Master/GetDrivers
GET    /api/Simantra/SMTV2Master/GetRoutes
POST   /api/Simantra/SMTV2Master/UpdateMasterData

Loading Endpoints

GET    /api/Simantra/SMTLoading/GetLoadingList
GET    /api/Simantra/SMTLoading/GetLoadingDetail/{id}
POST   /api/Simantra/SMTLoading/StartLoading
POST   /api/Simantra/SMTLoading/CompleteLoading
POST   /api/Simantra/SMTLoading/ScanItem
PUT    /api/Simantra/SMTLoading/UpdateLoadingStatus

Unloading Endpoints

GET    /api/Simantra/SMTUnloading/GetUnloadingList
GET    /api/Simantra/SMTUnloading/GetUnloadingDetail/{id}
POST   /api/Simantra/SMTUnloading/StartUnloading
POST   /api/Simantra/SMTUnloading/CompleteUnloading
POST   /api/Simantra/SMTUnloading/ScanItem
PUT    /api/Simantra/SMTUnloading/UpdateUnloadingStatus

Checker/Security Endpoints

GET    /api/Simantra/SMTChecker/GetCheckpointList
POST   /api/Simantra/SMTChecker/CheckIn
POST   /api/Simantra/SMTChecker/CheckOut
GET    /api/Simantra/SMTSecurity/GetSecurityCheckList
POST   /api/Simantra/SMTSecurity/ValidateSecurity

Tracking & Monitoring

GET    /api/Simantra/SMTScanRoute/GetCurrentLocation
POST   /api/Simantra/SMTScanRoute/UpdateLocation
GET    /api/Simantra/SMTScanRoute/GetRouteHistory

MOS Transaction

GET    /api/Simantra/SMTMosTrans/GetMOSList
POST   /api/Simantra/SMTMosTrans/CreateMOS
PUT    /api/Simantra/SMTMosTrans/UpdateMOS
DELETE /api/Simantra/SMTMosTrans/DeleteMOS

---

⚙️ Scheduler & Background Jobs

1. SMTTransporter.BlastOrder.Scheduler

Fungsi: Mengirim blast order secara otomatis ke transporter

Proses:

1. Membaca order yang ready untuk di-blast
2. Memfilter berdasarkan kriteria blast
3. Mengirim notifikasi ke transporter
4. Update status order

Schedule: Setiap 30 menit (configurable)

Configuration (App.config):

<appSettings>
  <add key="BlastOrderInterval" value="30" />
  <add key="EnableBlastOrder" value="true" />
</appSettings>

2. SMTTransporter.SyncOracle.Scheduler

Fungsi: Sinkronisasi data dengan Oracle APPS

Proses:

1. Pull data master dari Oracle APPS
2. Update local database
3. Push transaction data ke Oracle
4. Logging & error handling

Schedule: Setiap 1 jam (configurable)

Configuration (App.config):

<appSettings>
  <add key="SyncOracleInterval" value="60" />
  <add key="EnableSyncOracle" value="true" />
</appSettings>

Running Scheduler

Development:

# Run dari Visual Studio atau Console
cd KN2023_B2B.SMTTransporter.Scheduler\SMTTransporter.BlastOrder.Scheduler
dotnet run

Production:

• Deploy sebagai Windows Service
• Atau gunakan Task Scheduler
• Monitoring melalui logs

---

🚀 Deployment

Prerequisites

1. .NET Framework 4.7.2+ installed di server
2. IIS 8.5+ untuk Web API
3. Oracle Client installed & configured
4. SQL Server untuk logging (optional)

Deploy Web API (KN2019_B2B.App.SMT.Api)

Step 1: Build Project

# Di Visual Studio
1. Right-click project > Publish
2. Pilih profile atau buat baru
3. Target: File System / IIS / Azure
4. Configuration: Release
5. Klik Publish

Step 2: IIS Configuration

1. Buka IIS Manager
2. Create New Application Pool
   - Name: SMT_API_Pool
   - .NET CLR Version: v4.0
   - Managed Pipeline: Integrated
3. Create New Website/Application
   - Site Name: SIMANTRA_API
   - Application Pool: SMT_API_Pool
   - Physical Path: [Published folder path]
   - Binding: http/*:80 atau https
4. Set Permissions
   - App Pool Identity: Read & Execute
   - Network Service: Full Control (jika diperlukan)

Step 3: Web.config Settings

Update connection strings & app settings untuk production:

<appSettings>
  <add key="txtImosApi_Url" value="https://appgw.kalbenutritionals.com/api/simantra/" />
  <!-- Update production URLs -->
</appSettings>

Deploy Scheduler (KN2023_B2B.SMTTransporter.Scheduler)

Option 1: Windows Service

# Install sebagai Windows Service
sc create "SMT Blast Order Scheduler" binPath= "[path]\SMTTransporter.BlastOrder.Scheduler.exe"
sc create "SMT Sync Oracle Scheduler" binPath= "[path]\SMTTransporter.SyncOracle.Scheduler.exe"

# Start services
sc start "SMT Blast Order Scheduler"
sc start "SMT Sync Oracle Scheduler"

Option 2: Task Scheduler

1. Buka Task Scheduler
2. Create Basic Task
3. Trigger: Schedule (sesuai kebutuhan)
4. Action: Start a Program
5. Program: [path]\SMTTransporter.BlastOrder.Scheduler.exe
6. Ulangi untuk SyncOracle.Scheduler

Logging & Monitoring

Elmah Error Logging

// View errors
https://[your-domain]/elmah.axd

// Log custom errors
ErrorSignal.FromCurrentContext().Raise(new Exception("Error message"));

Application Logs

• Location: App_Data/Logs/ atau database
• Review untuk troubleshooting
• Monitor error patterns

---

📝 Notes & Best Practices

Coding Standards

1. Follow C# naming conventions
2. Use async/await untuk I/O operations
3. Implement proper error handling
4. Add XML documentation comments
5. Write unit tests untuk business logic

Security Guidelines

1. Validate all user inputs
2. Use parameterized queries
3. Implement rate limiting
4. Enable HTTPS only (production)
5. Regular security audits
6. Keep dependencies updated

Performance Tips

1. Use .AsNoTracking() untuk read-only queries
2. Implement caching strategy
3. Optimize database indexes
4. Use pagination
5. Compress responses (gzip)
6. Minimize API calls

Database Best Practices

1. Use transactions untuk multi-step operations
2. Implement proper indexing
3. Regular database maintenance
4. Monitor query performance
5. Backup strategy

---

🔄 Version History

Version	Date	Description	Author
1.0	2023	Initial SIMANTRA implementation	-
1.1	2023	Enhancement 2023 features	-
2.0	2024	V2 Master Controller & API improvements	-
2.1	2025	Current version	-

---

📄 Appendix

A. Database Schema Overview

• Lihat diagram ER di dokumentasi database terpisah
• Table naming convention: SMT_[Module]_[Entity]
• Stored procedures: SP_SMT_[Operation]

B. API Response Format

{
  "success": true,
  "message": "Operation successful",
  "data": {},
  "errors": [],
  "timestamp": "2025-01-06T10:30:00Z"
}

D. Useful SQL Queries

-- Check active orders
SELECT * FROM SMT_ORDER WHERE STATUS = 'ACTIVE';

-- View loading status
SELECT * FROM SMT_LOADING WHERE LOADING_DATE = TRUNC(SYSDATE);

-- Monitor scheduler jobs
SELECT * FROM SMT_SCHEDULER_LOG 
WHERE LOG_DATE >= TRUNC(SYSDATE);

---

📚 Referensi

• Microsoft .NET Documentation
• ASP.NET Web API Documentation
• Entity Framework 6 Documentation
• Oracle .NET Documentation

---

Dokumentasi ini dibuat pada: 6 Januari 2026
Untuk Project: KN2018_B2B SIMANTRA Module
Maintenance: Update dokumentasi ini saat ada perubahan signifikan