@provis/provis-common-be-module 2.6.66 → 2.6.67

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@provis/provis-common-be-module",
-  "version": "2.6.66",
+  "version": "2.6.67",
   "description": "This common module for Provis internal backend use lib",
   "main": "dist/index.js",
   "scripts": {

package/ICCB-INV-IMPACT-ANALYSIS.md

@@ -1,177 +0,0 @@
-# Impact Analysis: Adding `ICCB-INV` Insurance Type (Institute Cargo Clause B)
-
-> Analisis dampak penambahan tipe asuransi baru `ICCB-INV` (Institute Cargo Clause B) ke seluruh ekosistem Provi/Polismall.
->
-> Tanggal analisis: 2026-07-17
-
-## Ringkasan Eksekutif
-
-Saat ini sistem hanya mendukung 4 tipe clause: `ICCA-INV`, `ICCC-INV`, `ICCA-FLB`, `ICCC-FLB` (Clause A dan C). Penambahan `ICCB-INV` berdampak ke banyak project karena **logika clause diduplikasi secara lokal** di tiap konsumen (bukan memakai satu sumber tunggal).
-
-Temuan penting:
-
-- `ICCB-INV` **sudah ada** di shared library `provis-common-be-module` (TYPE map), tetapi **belum ada** di sebagian besar konsumen yang punya konstanta/switch lokal sendiri.
-- **Tidak ada satu pun validasi DTO (`IsEnum`/`IsIn`)** di semua backend. Artinya `ICCB-INV` akan lolos diam-diam tanpa error, dan bug hanya muncul sebagai **data kosong/salah** di output (sertifikat, PDF, premi), bukan sebagai error yang mudah terdeteksi.
-- Terdapat **dua vocabulary clause yang berbeda** di codebase: format `ICCA-INV` (exim/dashboard/common-module) vs format `ICC A` (provis-invoice, provis-meratus-api). Tidak ada single source of truth.
-
-Dua hal yang harus dikonfirmasi sebelum implementasi:
-
-1. **Nilai rate ICCB** — dipakai di perhitungan premi (`pdf.ts`, `provis-invoice`, `provis-meratus-api`). Tidak bisa ditebak.
-2. **Apakah butuh varian `ICCB-FLB`** juga, atau cukup `ICCB-INV`.
-
----
-
-## Project yang WAJIB Diubah (ada logika clause)
-
-### 1. provis-common-be-module (shared, source of truth)
-
-| File | Lokasi | Keterangan |
-|---|---|---|
-| `src/constants/product/cargo/cargo.ts` | TYPE map | `ICCB-INV` **sudah ada**. Namun **belum ada `ICCB-FLB`** → gap kalau butuh varian First Loss Basis. |
-| `src/helpers/getCargoType.ts:3` | `getCargoType()` | Data-driven (lookup by code di TYPE map), otomatis resolve. Tidak perlu ubah kode. |
-
-### 2. polismall-exim-api
-
-| File | Lokasi | Keterangan |
-|---|---|---|
-| `src/common/constants/cargo.ts` | `CARGO_TYPE_ICC_*` | Hanya A & C, wajib tambah konstanta ICCB. |
-| `src/common/constants/pdf.ts:7` | `RATE_RULES` | **KRITIS** — wajib tambah rate `ICCB` untuk perhitungan premi. `getRate()` ambil prefix `code.split('-')[0]`; tanpa entry `ICCB` akan return `null`. |
-| `src/service/booking.service.ts:1305` | `convertInsuranceTypeDesc` | Tambah case ICCB. |
-| `src/service/declarationBundle.service.ts:387` | `convertInsuranceTypeDesc` | Tambah case ICCB. |
-| `src/service/internal.declaration.service.ts:1516` | `convertInsuranceType` | Matching by text "Institute Cargo Clause (A/C)". |
-| `src/service/internal.declaration.service.ts:1527` | `convertInsuranceTypeNamingConv` | Tambah case ICCB. |
-| `src/service/internal.declaration.service.ts:1541` | `convertInsuranceTypeDesc` | ⚠️ **Tanpa `default`** → return `undefined` untuk tipe tak dikenal. |
-| `src/service/internal.declaration.service.ts:2587` | `convertIdCoverage` | Tambah case ICCB. |
-| `src/service/internal.declaration.service.ts:2602` | `convertInsuranceTypeNamingConvReverse` | Tambah case ICCB. |
-| `src/service/retry.service.ts:112` | `convertInsuranceTypeNamingConv` | Duplikat, default return `''`. |
-
-### 3. provis-invoice (KRITIS — rate hardcode)
-
-| File | Lokasi | Keterangan |
-|---|---|---|
-| `src/service/cargoMeratus.service.ts:298` | `checkInsuranceType()` | Tanpa case ICC B akan masuk `default` → **throw error** di `:384`/`:447`. |
-| `src/service/cargoMeratus.service.ts:302,309,325,341` | description strings | Butuh string clause B sendiri. |
-| `src/service/cargoMeratus.service.ts:504` | render conditions | Mengalir dari string di atas. |
-| `src/common/constants/cargoMeratus.ts:34-37` | konstanta `ICC A`/`ICC C`/`FLB A`/`FLB C` | Tambah `ICC B`. ⚠️ Pakai vocabulary beda (`ICC A`, bukan `ICCA-INV`). |
-
-### 4. provis-meratus-api (core mapping)
-
-| File | Lokasi | Keterangan |
-|---|---|---|
-| `src/common/constants/config.ts:35-38` | konstanta clause | Tambah `ICC B`/`FLB B`. |
-| `src/service/meratus.service.ts:681-692` | `getInsuranceTypeDesc()` | Tambah case Clause B. |
-| `src/service/meratus.service.ts:702-711` | `getInsuranceGoodType()` | Butuh keputusan good type untuk Clause B. |
-| `src/service/meratus.service.ts:721-732` | `getInsuranceTypeCode()` | Tambah case `ICCB-INV`/`ICCB-FLB`. |
-
-### 5. polismall-dashboard-api
-
-> Catatan: saat ini bahkan **hanya ICCA** yang ter-wire (belum ada ICCC).
-
-| File | Lokasi | Keterangan |
-|---|---|---|
-| `src/common/constants/excelRead.ts:13-14` | `TYPE_ICCA_INV`, `TYPE_ICCA_FLB` | Tambah entry ICCB. |
-| `src/controller/excelRead.controller.ts:165-172` | dropdown `insuranceTypes` | Dibangun via `getCargoType()`. |
-| `src/service/excelRead.service.ts:228,305,324,346-352` | sumInsured / `detectInsuranceType()` | Logika keyed pada `TYPE_ICCA_INV.code`. |
-
-### 6. provis-back-office
-
-| File | Lokasi | Keterangan |
-|---|---|---|
-| `src/service/excel.service.ts:221-227` | switch clause | ⚠️ line 227 kemungkinan bug: `ICCC-INV` di posisi label `ICCA-FLB`. |
-| `src/common/constants/excelUpload.ts:74` | header "RISK COVER" | Enumerasi kode yang diperbolehkan. |
-| `src/common/constants/excelUploadBundleCargo.ts:84` | header "RISK COVER" | Enumerasi kode yang diperbolehkan. |
-
-### 7. bolier-plate-go-rest
-
-| File | Lokasi | Keterangan |
-|---|---|---|
-| `app/constants/ppnp_constants.go:5-8` | konstanta clause Go + contoh rate | Tambah konstanta ICCB. |
-
----
-
-## Frontend / Microsite (dropdown & label)
-
-### 8. temas-microsite
-
-| File | Lokasi | Keterangan |
-|---|---|---|
-| `views/index.ejs:259-262` | dropdown user | Satu-satunya tempat user memilih clause. Tambah `<option value="ICCB-INV">`. |
-| `src/service/micrositeService.ts:782-788` | switch mapping | Tambah case ICCB-INV. |
-| `public/js/function-detail.js:294-315` | rate switch + cap sum insured | Tambah case ICCB-INV. |
-| `public/js/function-index.js:374-395` | rate switch (mirror) | Tambah case ICCB-INV. |
-| `public/js/function-index.js:284-285` | option-hide logic | Review apakah ICCB perlu di-hide kondisional. |
-| `public/js/common/upload.js:18-198` | bulk-upload code mapping | ⚠️ Juga referensi `ICCA-SEC`, `ICCC-NEW`, `ICCC-SEC` → universe clause ternyata lebih luas. |
-| `locales/id.json:25,28`, `locales/en.json:26,29` | teks i18n | Update copy untuk menyebut Clause B. |
-
-### 9. polismall-exim-microsite
-
-| File | Lokasi | Keterangan |
-|---|---|---|
-| `src/constants/index.js:22` | `INSURANCE_TYPES` array | `["ICCA-INV","ICCC-INV","ICCA-FLB","ICCC-FLB"]` → tambah `ICCB-INV`. |
-| `src/components/Detail/Detail.js:144` | label hardcode | Teks statis "Institute Cargo Clause (A)...", perlu varian B / dinamis. |
-| `src/pages/Booking/BookingNext.js:266` | default fallback | Review default value. |
-
-### 10. polismall-dashboard-web
-
-| File | Lokasi | Keterangan |
-|---|---|---|
-| `src/constants/index.js:38-47` | `INSURANCE_TYPE_YUDHA_OPTIONS` | Hanya ICCA-INV & ICCA-FLB. Tambah opsi ICCB. |
-| `src/pages/Tanto/UploadTransaction/index.js:91` | `orderedCodes` | `["ICCA-INV","ICCC-INV","ICCA-FLB","ICCC-FLB"]` → tambah ICCB. |
-
-### 11. provis-internal-web
-
-| File | Lokasi | Keterangan |
-|---|---|---|
-| `src/components/FileUpload/FileUpload.js:610-621` | dropdown MenuItem | Tambah item ICCB. |
-| `src/pages/Upload/Gemilang/Component/CreateData.js:205-215` | dropdown MenuItem | Tambah item ICCB. |
-| `src/pages/Upload/Gemilang/Component/DataTableExcel.js:514-524` | dropdown MenuItem | Tambah item ICCB. |
-| `src/components/Forms/UpdateForm.js:349-366` | switch label | Dead code (commented out). Tidak perlu aksi kecuali diaktifkan. |
-
-### 12. provis-internal-web-v2
-
-| File | Lokasi | Keterangan |
-|---|---|---|
-| `src/lib/constants.js:71-76` | `CARGO_TYPE` | Copy dari shared module. Tambah `TYPE_ICCB_INV`. |
-| `src/lib/constants.js:81-85` | `cargoTypeLabel()` | Iterasi `CARGO_TYPE`, auto-resolve entry baru. |
-
----
-
-## Project TANPA Impact (pass-through / DB-driven)
-
-| Project | Alasan |
-|---|---|
-| **marine-cargo** | DB-driven via tabel `rate_group`. Cukup tambah record DB, **tidak ada perubahan kode**. |
-| **marine-cargo..** | Sama seperti marine-cargo (DB-driven). |
-| **provis-generate-pdf** | Hanya render string `insuranceType`/`insuranceTypeDesc` yang diterima. Switch keyed pada `productType`/`productCode`, bukan clause. |
-| **provis-generate-excel** | Tidak ada referensi clause sama sekali. |
-| **provis-claim-api** | `insuranceType`/`insuranceTypeName` hanya pass-through string. |
-| **provis-payment** | Tidak ada referensi clause. |
-| **polismall-cargo-container-api** | `insuranceType` pass-through, tidak pernah diinspeksi. |
-| **polismall-cargo-claim-microsite** | Tidak ada referensi clause. |
-| **polismall-otto-api** | Keyed pada `productCode`, bukan clause. |
-| **polismall-kca-api** | `insuranceType` plain string, no clause logic. |
-| **polismall-invoice-microsite** | Tidak ada logika clause (match hanya false positive). |
-
----
-
-## Matriks Prioritas
-
-| Prioritas | Project | Alasan |
-|---|---|---|
-| **KRITIS** | provis-invoice | `default` case → throw error, premi gagal |
-| **KRITIS** | polismall-exim-api | rate `RATE_RULES` + 6 fungsi konversi |
-| **KRITIS** | provis-meratus-api | 3 switch core mapping |
-| **TINGGI** | dashboard-api, back-office | rate/excel logic |
-| **SEDANG** | temas-microsite, exim-microsite, dashboard-web, internal-web, internal-web-v2 | dropdown + label |
-| **RENDAH** | provis-common-be-module | `ICCB-INV` sudah ada, cek perlu `ICCB-FLB` |
-| **NONE** | marine-cargo (DB), generators, pass-through services | tinggal data DB |
-
----
-
-## Catatan Risiko
-
-1. **Silent failure**: Tanpa validasi DTO, input `ICCB-INV` tidak ditolak. Field turunan (deskripsi, premi) akan `undefined`/`null`/kosong tanpa error.
-2. **Duplikasi logika**: `convertInsuranceTypeDesc` ada di 3 service dengan behavior default berbeda (return value asli / `''` / `undefined`). Harus disinkronkan.
-3. **Dua vocabulary**: `ICCA-INV` vs `ICC A`. Update di satu format tidak otomatis memperbaiki format lain.
-4. **Universe clause lebih luas dari perkiraan**: `temas-microsite/upload.js` menyebut `ICCA-SEC`, `ICCC-NEW`, `ICCC-SEC`. Konfirmasi daftar clause otoritatif lengkap sebelum implementasi.
-5. **Rate ICCB belum diketahui**: harus dikonfirmasi dari tim bisnis/aktuaria.

package/dist/constants/product/cargo.d.ts

@@ -1,39 +0,0 @@
-declare const cargo: {
-    STATUS: {
-        DRAFT: string;
-        SUBMITED: string;
-        PAID: string;
-        CANCEL: string;
-    };
-    TYPE: {
-        TYPE_ICCA_INV: {
-            code: string;
-            desc: {
-                id: string;
-                en: string;
-            };
-        };
-        TYPE_ICCC_INV: {
-            code: string;
-            desc: {
-                id: string;
-                en: string;
-            };
-        };
-        TYPE_ICCA_FLB: {
-            code: string;
-            desc: {
-                id: string;
-                en: string;
-            };
-        };
-        TYPE_ICCC_FLB: {
-            code: string;
-            desc: {
-                id: string;
-                en: string;
-            };
-        };
-    };
-};
-export default cargo;

package/dist/constants/product/cargo.js

@@ -1,41 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const cargo = {
-    STATUS: {
-        DRAFT: '0',
-        SUBMITED: '100',
-        PAID: '200',
-        CANCEL: '300',
-    },
-    TYPE: {
-        TYPE_ICCA_INV: {
-            code: 'ICCA-INV',
-            desc: {
-                id: '',
-                en: 'Institute Cargo Clause (A) 01/01/09 - Invoice value +10%',
-            },
-        },
-        TYPE_ICCC_INV: {
-            code: 'ICCC-INV',
-            desc: {
-                id: '',
-                en: 'Institute Cargo Clause (C) 01/01/09 - Invoice value +10%',
-            },
-        },
-        TYPE_ICCA_FLB: {
-            code: 'ICCA-FLB',
-            desc: {
-                id: '',
-                en: 'Institute Cargo Clause (A) 01/01/09 - First Loss Basis',
-            },
-        },
-        TYPE_ICCC_FLB: {
-            code: 'ICCC-FLB',
-            desc: {
-                id: '',
-                en: 'Institute Cargo Clause (C) 01/01/09 - First Loss Basis',
-            },
-        },
-    }
-};
-exports.default = cargo;