LNSW Backend — Audit Log Registry

Repositori ini adalah Single Source of Truth (SSOT) untuk seluruh technical change record, audit trail, dan dokumentasi perubahan backend Lembaga National Single Window (LNSW).

Setiap perubahan yang menyentuh database schema (DDL/DML), kontrak API, atau business logic kritikal wajib didokumentasikan di sini sebelum atau segera setelah naik ke Production.

---

Struktur Repositori

lnsw-backend-audit-logs/
├── README.md                          # Master catalog & audit log registry (file ini)
├── init_context.md                    # Panduan konteks, prinsip teknis, & aturan LNSW
├── templates/
│   └── audit_log_template.md          # Template Markdown siap pakai
└── logs/
    ├── pengangkut/                    # Aktif — service: pengangkut-backend
    │   └── 2026/
    ├── single-billing/                # Aktif — service: single-billing-be
    │   └── 2026/
    ├── sipt/                          # Aktif — service: sipt-backend
    │   └── 2026/
    ├── pengangkut-udara/              # Reserved — modul baru, belum rilis production
    └── pengangkut-worker/             # Reserved — modul baru, belum rilis production

---

Alur Pengisian & Update Log (Lifecycle)

Satu audit log tidak diisi sekaligus. Pengisian dilakukan bertahap mengikuti posisi deployment aktual.

Tahap 1 — Development (Buat Log Awal)

1. Salin template dari templates/audit_log_template.md.
2. Simpan file:

   logs/<modul>/<YYYY>/[TASK_ID]-[deskripsi-singkat].md

3. Isi semua section (informasi tugas, analisis teknis, bukti teknis).
4. Pada tabel Deployment Lifecycle: isi baris Development, biarkan Staging & Production tetap PENDING.
5. Header dokumen: Stage Saat Ini: DEVELOPMENT.
6. Daftarkan di tabel Registry di bawah dengan status DEV.
7. Commit:

   docs(<modul>): [TASK_ID] create audit log — development stage

Tahap 2 — Staging / UAT (Update Log)

1. Buka file log yang sudah ada.
2. Isi baris Staging (UAT) pada tabel Deployment Lifecycle (tanggal, PIC, status DEPLOYED).
3. Ubah Stage Saat Ini di header menjadi STAGING.
4. Isi section Bukti Verifikasi Pengujian dengan hasil UAT.
5. Tambahkan baris baru pada Riwayat Update Log di dalam file.
6. Update kolom Stage di tabel Registry menjadi STAGING.
7. Commit:

   docs(<modul>): [TASK_ID] update audit log — staging deployed

Tahap 3 — Production (Update Final)

1. Buka file log yang sudah ada.
2. Isi baris Production pada tabel Deployment Lifecycle (tanggal, PIC, release version).
3. Ubah Stage Saat Ini di header menjadi PRODUCTION.
4. Tambahkan baris baru pada Riwayat Update Log di dalam file.
5. Update kolom Stage di tabel Registry menjadi PROD dan Status menjadi CLOSED.
6. Commit:

   docs(<modul>): [TASK_ID] update audit log — production released

Format Task ID

Sumber Instruksi	Format	Contoh
Nota Dinas Resmi	ND-[NomorDokumen]-[TopikSingkat]	ND-104-IKP-VIII-2026-split-billing
WhatsApp / Bug Report / Urgent Fix	WA-YYYYMMDD-[TopikSingkat]	WA-20260824-split-billing-admin

---

Audit Log Registry

Urutkan berdasarkan tanggal dokumen terbaru di atas (descending). Kolom Stage menunjukkan posisi deployment aktual saat ini.

Task ID	Modul	Tipe	Tanggal	Stage	Status	Dokumen
FIX-RECEIVE-NOMOR-AJU-SITOLAUT-HANGING-AND-OBSERVABILITY	SIPT	Bugfix	2026-08-28	DEV	OPEN	link
TASK-SET-EXPIRED-BILLING-V3	Single Billing	Feature	2026-08-27	DEV	OPEN	link
TASK-SPLIT-BILLING-202608	Pengangkut	Feature	2026-08-26	DEV	OPEN	link
ND-319/LNSW.34/2026	SIPT	Bugfix	2026-08-24	DEV	OPEN	link
ND-256/LNSW.34/2026	Pengangkut	Change Request	2026-08-24	DEV	OPEN	link
ND-183/LNSW.34/2026	Pengangkut	Bugfix	2026-08-24	DEV	OPEN	link

Nilai Stage: DEV → STAGING → PRODNilai Status: OPEN (masih berjalan) · CLOSED (sudah production)

---

Referensi

• Panduan Konteks & Prinsip Teknis LNSW
• Template Audit Log