Release readiness tasks for v0.1.0

[wauputr4]

Ringkasan

Tracking kesiapan Rute Bayar menuju release publik stabil v0.1.0.

Status Saat Ini

v0.1.0-alpha.2 sudah dipublish sebagai prerelease dengan release asset automation.

Release alpha sudah layak untuk:

• demo internal
• uji coba contributor awal
• validasi flow lokal dan sandbox provider
• feedback API/CLI/ops sebelum stable

PR hardening:

• feat: add release hardening checks and diagnostics #20
• ci: automate tagged releases #21

Release:

• https://github.com/pendig/rute-bayar/releases/tag/v0.1.0-alpha.2

Verified untuk Alpha

• GOCACHE=/tmp/go-build go test ./...
• Build binary dengan version injection
• GitHub prerelease: v0.1.0-alpha.1
• GitHub prerelease: v0.1.0-alpha.2
• CI GitHub Actions hijau di PR feat: add release hardening checks and diagnostics #20: test + build matrix
• Release workflow tag v0.1.0-alpha.2 hijau
• Release assets otomatis terupload:
  • rute-bayar-linux-amd64
  • rute-bayar-linux-arm64
  • rute-bayar-darwin-amd64
  • rute-bayar-darwin-arm64
  • rute-bayar-windows-amd64.exe
  • checksums.txt

Task List

P0 - Core Payment

• Implement refund untuk Xendit Payment Session

  • Provider adapter tersedia
  • CLI pay refund tersedia
  • Persistence refund tersedia
  • Unit test adapter/service/CLI tersedia

• Implement refund untuk Midtrans yang didukung

  • Provider adapter tersedia
  • CLI pay refund tersedia lewat service umum
  • Persistence refund tersedia
  • Unit test adapter/service tersedia

P1 - Webhook Reliability

• Idempotency webhook dasar

  • Duplicate event handling sudah lebih aman
  • Status update tidak diulang saat status sudah sama
  • Event identity sudah diperbaiki

• Implement webhook replay yang bisa dioperasikan manual

  • Replay berdasarkan webhook_event_id
  • Provider filter opsional tersedia
  • Forwarding filter tetap dihormati saat replay

• Tambahkan diagnostic command untuk forwarding

  • webhook forward attempts list
  • webhook forward attempts show <attempt-id>
  • webhook forward attempts retry <attempt-id>
  • JSON output tersedia untuk list/show

P1 - Operational

• Konsolidasi status mapping

  • Helper internal/provider.MapPaymentStatus
  • Dokumentasi docs/status-mapping.md
  • Mapping Midtrans/Xendit terdokumentasi

• CI/CD dasar

  • GitHub Actions untuk gofmt check
  • go test ./...
  • go vet ./...
  • build matrix untuk Linux, macOS, Windows

P2 - Release Engineering

• Buat CHANGELOG.md untuk alpha release
• Review README usage/install untuk alur onboarding + pembayaran + webhook + forward
• Verifikasi cepat tidak ada secret provider nyata tersimpan di source code
• Tag dan publish prerelease v0.1.0-alpha.1
• Otomasi GitHub Release asset dari CI
• Tag dan publish prerelease v0.1.0-alpha.2 lewat workflow otomatis
• Tag dan publish stable v0.1.0 setelah checklist stabil selesai

P2 - Documentation

• Tambah operations runbook

  • health check
  • webhook simulation
  • replay
  • Cloudflare tunnel testing
  • SQL diagnostics

• Tambah checklist simulasi end-to-end yang lebih formal

  • onboard provider
  • pay create
  • pay status
  • webhook verify/parse/reconcile
  • webhook forward
  • refund/reconcile

Acceptance Criteria Stable v0.1.0

• go test ./... lulus konsisten di CI
• create -> webhook -> pay status berjalan untuk Midtrans dan Xendit dengan sandbox credential terbaru
• refund dapat dijalankan end-to-end untuk provider yang didukung dengan sandbox credential terbaru
• ada observabilitas replay/diagnostic yang jelas
• CI dan release docs siap untuk dipakai user lain
• release asset automation siap untuk stable tag

Sisa Sebelum Stable

• Rotate credential sandbox/provider yang pernah keluar dari secret store.
• Jalankan checklist docs/end-to-end-smoke.md dengan credential terbaru.
• Catat hasil sandbox E2E Xendit dan Midtrans di issue/PR terpisah.
• Jika dua provider lolos E2E, siapkan tag stable v0.1.0.

[wauputr4]

Update setelah publish v0.1.0-alpha.1:

Alpha release sudah dibuat sebagai prerelease untuk early testing: https://github.com/pendig/rute-bayar/releases/tag/v0.1.0-alpha.1

Catatan status issue ini:

• Sebagian P0/P1 sudah bergerak lebih jauh dari deskripsi awal issue: refund Midtrans/Xendit, webhook verification/parsing, forwarding CLI, event filter, dan webhook replay sudah tersedia di alpha.
• Issue ini masih relevan untuk target v0.1.0 stabil, terutama karena CI/CD, release artifact automation, diagnostics lanjutan, dan end-to-end provider smoke test masih perlu dikunci.
• Alpha ini sengaja tidak diklaim production-ready. Tujuannya membuka jalur uji coba, review, dan feedback sebelum stable.

Rekomendasi follow-up sebelum stable v0.1.0:

1. Tambah GitHub Actions untuk gofmt, go test ./..., go vet, dan build matrix.
2. Tambah diagnostic command untuk forwarding failed attempts dan retry detail.
3. Tambah end-to-end smoke checklist untuk Xendit dan Midtrans dari onboard -> pay create -> pay status -> webhook -> forward -> refund/reconcile.
4. Rapikan issue checklist ini agar item yang sudah selesai dari alpha ditandai done dan sisa task dipisah ke issue kecil.

[wauputr4]

Update dari PR #20: CI dasar, forwarding attempt diagnostics, status mapping docs/helper, dan end-to-end smoke checklist/script sudah dikerjakan. CI PR #20 sudah hijau. Sisa sebelum stable v0.1.0 terutama validasi sandbox end-to-end dengan credential terbaru dan otomasi release asset dari CI.

[wauputr4]

Update: v0.1.0-alpha.2 sudah berhasil dipublish lewat release workflow otomatis. Release assets dan checksums sudah terupload. Sisa menuju stable sekarang fokus ke sandbox E2E dengan credential provider terbaru/rotated.

[wauputr4]

Update E2E prep:

• Local smoke test berhasil setelah memperbaiki readiness receiver di PR fix: wait for smoke forwarding receiver #22.
• Sandbox E2E runner sudah ditambahkan dan merged di PR chore: add sandbox e2e runner #23: scripts/e2e-sandbox.sh.
• Runner memvalidasi env credential tanpa mencetak secret, lalu menjalankan migrate, onboard, provider test, pay create, pay status, dan refund optional untuk transaksi yang sudah paid/settled/refundable.
• E2E provider real belum dijalankan karena credential rotated belum tersedia di env lokal (XENDIT_SECRET_KEY, MIDTRANS_MERCHANT_ID, MIDTRANS_CLIENT_KEY, MIDTRANS_SERVER_KEY).

Next: set credential rotated sebagai env lokal atau .env, lalu jalankan ./scripts/e2e-sandbox.sh.

[wauputr4]

Update roadmap pencatatan: untuk provider berikutnya, kita tetapkan Flip Business (ganti DANA/Tripay).

Task roadmap yang belum tercatat sekarang sudah saya pindahkan ke issue berikut: #29

Silakan lanjutkan dari issue #29 untuk scope onboarding + adapter + webhook + e2e Flip Business.

[wauputr4]

Issue 10 status update: task issue 10 kita lanjutkan eksekusinya hari ini.

Eksekusi Hari Ini

• scripts/e2e-sandbox.sh dijalankan dengan .env yang berisi credential sandbox (masked)
• Provider test + pay create + pay status untuk Xendit: pass
• Provider test + pay create + pay status untuk Midtrans: pass
• scripts/smoke-local.sh (daemon + local webhook simulation + forward attempt): pass

Hasil Ringkas

• Xendit: create/status berjalan, status sementara pending/ACTIVE; payment session tetap bisa dibuat.
• Midtrans: create/status berjalan (bank_transfer), status pending dan status_code 201.
• Forward attempt lokal untuk event payment_session.created sukses.

Sisa yang masih perlu untuk close issue 10

• Satu kali validasi webhook real provider (Xendit/Midtrans) end-to-end via tunnel agar checklist create -> webhook -> pay status benar-benar lengkap di lingkungan sandbox.
• Refund e2e penuh dengan reference yang sudah settled/refundable (RUTE_BAYAR_E2E_XENDIT_REFUND_REFERENCE dan RUTE_BAYAR_E2E_MIDTRANS_REFUND_REFERENCE) agar acceptance criteria refund end-to-end tercentang.
• Jika dua poin di atas tervalidasi, lanjut tag stable v0.1.0.

Catatan: credential tidak ditampilkan ulang demi keamanan.

[wauputr4]

Issue 10 completion log sudah disimpan di docs/release/issue-10-execution-log.md untuk review tim.

Ringkasannya:

• Sandbox E2E create/status untuk Xendit dan Midtrans sukses.
• Webhook + forwarding lokal sukses via smoke-local.
• Sisa untuk close issue 10: webhook real (via tunnel) dan refund e2e yang bisa dieksekusi pada reference settled/refundable.

[wauputr4]

Update final untuk issue 10 setelah PR #35 merged:

• commit readiness log sudah masuk main di 8cfe203.
• Eksekusi yang sudah selesai (dan sudah divalidasi sebelumnya):
  • sandbox create/status Xendit
  • sandbox create/status Midtrans
  • local webhook + forwarding diagnostics smoke

Sisa blocker untuk close issue dan siapkan stable v0.1.0 sekarang tercatat detail di:
#36

Saya rekomendasikan lanjutkan checklist blocker tersebut 1x run dari sandbox public tunnel + transaksi settled/refundable untuk merapikan acceptance criteria.

[wauputr4]

Release blocker tracking update:\n\nIssue #36 was auto-closed by PR #37 because it was a documentation PR, but the operational blockers are still not done. I split the remaining stable blockers into focused issues:\n\n- #39 Stable blocker: prove real provider webhook callbacks end-to-end\n- #40 Stable blocker: complete successful sandbox refund E2E\n\nCurrent release status remains alpha/testing until #39 and #40 are resolved or stable scope is explicitly narrowed.