[{TASK_ID}]

Modul: {Single Billing / Pengangkut / SIPT/PAB} | Tipe: {Bugfix / Hotfix / Feature / Change Request / Refactoring} | Stage Saat Ini: DEVELOPMENT | Tanggal Dokumen:

---

1. Informasi Tugas & Referensi Bisnis

• Task ID / Nomor Referensi: {TASK_ID}

• Sumber Instruksi:

• Dokumen Referensi / Lampiran: {nama_file.pdf} (jika ada lampiran ND/PDF)

• Task / Dependensi Terkait (Cross-Service): {RELATED_TASK_ID} (jika ada integrasi antar-service)

• Modul Terkait: {Single Billing / Pengangkut / SIPT/PAB}

• Service / Repository: {Nama service backend}

• PIC Pengembang:

• Latar Belakang & Ringkasan Kebutuhan:

• Ruang Lingkup & Rincian Sub-Pekerjaan (Technical Scope & Milestones):

  • [x]
  • [x]
  • [ ]

---

2. Deployment Lifecycle

#	Environment	Tanggal & Waktu	PIC	Status	Catatan
1	Development			DEPLOYED	Branch: {nama-branch}
2	Staging (UAT)	—	—	PENDING	—
3	Production	—	—	PENDING	—

Riwayat Update Log

Tanggal	Environment	Perubahan	PIC
	Development	Initial log created

---

3. Analisis Teknis & Rincian Perubahan

• Alur Logika & Bisnis:

• Perubahan Database (DDL / DML):

  -- Tuliskan script SQL PostgreSQL yang dieksekusi
  -- Contoh: ALTER TABLE, CREATE INDEX, UPDATE backfill data

• Kontrak API & Response Payload:(Jika tidak ada perubahan API, tulis: Tidak ada penambahan atau perubahan kontrak API.)

  [METHOD] {/path/to/endpoint}

  • Deskripsi:
  • Autentikasi / Guard: Bearer Token ({MiddlewareGuard}) | Public | Internal Service
  • Request Header / Query / Params:
    • Header: Authorization: Bearer <token>
    • Query: {key=value}
  • Request Body:

    {
      "field_name": "tipe_data / contoh_nilai"
    }

  • Response Payload (200 OK / 201 Created):

    {
      "data": {},
      "message": "Pesan sukses",
      "statusCode": 200,
      "success": true
    }

  • Response Error (400 Bad Request / 403 Forbidden / 404 Not Found):

    {
      "data": null,
      "message": "Validation Failed / Error message",
      "statusCode": 400,
      "success": false,
      "errors": []
    }

---

4. Bukti Teknis (Technical Proof & Audit Trail)

• Repository: {link-repo-atau-nama-repo}
• Branch Utama: {nama-branch}
• Merge Request / PR: !{nomor_MR} (jika ada)

Daftar Commit Terkait (Multi-Commit Trail)

Commit ID	Branch	Author	Tanggal & Jam	Ringkasan Perubahan
{commit_hash_1}	{branch}	{author}	{YYYY-MM-DD HH:mm}	{pesan commit / milestone 1}
{commit_hash_2}	{branch}	{author}	{YYYY-MM-DD HH:mm}	{pesan commit / milestone 2}

Cuplikan Kode / Query Migration

-- Contoh: query DDL atau DML yang dieksekusi di database

---

5. Bukti Verifikasi Pengujian (QA / Unit Test / API Verification)

A. Verifikasi Unit Test (Development Stage)

(Opsional: Dilampirkan jika task mencakup penambahan/perubahan unit test)

• Test Suite File: {path_file_test}
• Status Eksekusi CLI: {PASSED / SKIPPED / TIDAK ADA}

// Cuplikan code unit test kunci (opsional)

// Bukti empiris output CLI runner (npm test / vitest / jest)

B. Panduan Pengujian QA & Verifikasi Staging (QA Playbook)

Diisi saat development sebagai panduan eksekusi pengujian QA, kemudian dilengkapi bukti response JSON saat verifikasi di Staging.

• Cakupan / Surface Pengujian: {API / Postman Only | Full E2E (UI + Backend) | B2B Webhook + UI Verification | Worker / DB / Cron Only}
• Kebutuhan Akses / Role Akun: {Role Admin / PPJK / Internal Token / Data Uji Khusus}
• Hasil Pengujian UAT: PENDING →
• Catatan QA: —

Skenario Pengujian QA (Test Scenarios)

1. Skenario 1 — [Nama Skenario Utama / Happy Path]:

   • Pre-kondisi:
   • Trigger / Request: [METHOD] {/endpoint} dengan payload contoh
   • Ekspektasi Response: HTTP {200 OK}, {keterangan: "..."}
   • Verifikasi Database / Log:

2. Skenario 2 — [Nama Skenario Negative / Edge Case / Failure Handling]:

   • Pre-kondisi:
   • Trigger / Request: [METHOD] {/endpoint}
   • Ekspektasi Response: HTTP {Status}, payload error
   • Verifikasi Database / Log:

Bukti Response Verifikasi Staging (Diisi saat UAT)

{
  "status": "PENDING",
  "note": "Menunggu deployment ke environment Staging untuk eksekusi skenario uji QA."
}