Back to Projects
Sep 2024

Pinjamin App (Campus Room Booking)

A campus booking app that handles approval, Xendit payment callbacks, realtime updates, and proof generation without mixing booking and payment status.

Overview

Pinjamin digitizes campus room borrowing from request and approval through online payment, realtime updates, and downloadable proof. I worked across the frontend, backend, relational model, Xendit integration, Pusher updates, and deployment automation.

The difficult part starts after the booking request is submitted: approval and payment finish at different times, and Xendit reports payment through a later callback.

Booking and payment are separate

Booking tracks the room request. Payment tracks the provider transaction.

The callback handler reads the current database state before applying a payment transition, so an already-finalized payment can be ignored instead of running the same fulfillment work again.

The current implementation uses application-state checks for duplicate callbacks. A stable provider event ID with a database uniqueness constraint would provide stronger protection.

Realtime updates are replaceable

Pusher tells borrowers and administrators when status changes. It does not store booking state.

If a realtime event is missed, the client can reload the current booking from the API. This keeps notification delivery separate from the actual booking workflow.

Booking collisions

The current availability flow is not a fully transactional slot-reservation system. Two simultaneous requests can still race around an availability check.

A stronger version would protect the room/time overlap rule at the database transaction or locking level.

Result

The project covers the complete campus flow from request to approval, payment, updates, and proof generation while keeping the booking and payment lifecycles separate.

Gambaran umum

Pinjamin mendigitalkan peminjaman ruangan kampus mulai dari request dan approval, pembayaran online, pembaruan realtime, hingga pembuatan bukti yang bisa diunduh. Saya mengerjakan frontend, backend, relational model, integrasi Xendit dan Pusher, serta otomatisasi deployment.

Bagian sulit muncul setelah request booking diajukan: approval dan pembayaran selesai pada waktu berbeda, sedangkan Xendit mengirimkan hasil pembayaran melalui callback belakangan.

Booking dan pembayaran terpisah

Booking menyimpan status permintaan ruangan, sementara Payment menyimpan transaksi dengan provider.

Callback handler membaca state database terkini sebelum mengubah status pembayaran. Payment yang sudah final dapat diabaikan tanpa mengulangi fulfillment.

Implementasi sekarang menggunakan pemeriksaan application state untuk menghindari duplicate callback. Perlindungan yang lebih kuat memerlukan provider event ID stabil dan database uniqueness constraint.

Realtime update dapat diganti

Pusher memberi tahu peminjam dan admin saat status berubah, tetapi tidak menyimpan booking state.

Jika client melewatkan realtime event, ia dapat memuat ulang booking terkini dari API. Ini memisahkan pengiriman notifikasi dari workflow booking sebenarnya.

Konflik booking

Alur ketersediaan saat ini belum berupa transactional slot-reservation system. Dua request bersamaan masih bisa mengalami race condition pada pemeriksaan slot.

Versi yang lebih kuat akan melindungi aturan tumpang tindih ruangan/waktu pada database transaction atau tingkat locking.

Hasil

Proyek ini mencakup seluruh alur peminjaman kampus, dari request dan approval hingga pembayaran, update, dan bukti transaksi, sambil menjaga lifecycle booking dan payment tetap terpisah.

Resumen

Pinjamin digitaliza las reservas de salas universitarias, desde solicitud y aprobación hasta pagos online, actualizaciones realtime y comprobantes descargables. Trabajé en frontend, backend, modelo relacional, integración Xendit y Pusher, y deployment automation.

La dificultad comienza después de solicitar la reserva: aprobación y pago finalizan en momentos distintos, y Xendit informa el resultado mediante un callback posterior.

Reserva y pago por separado

Booking registra la solicitud de sala; Payment registra la transacción del proveedor.

El callback handler consulta el estado actual en database antes de aplicar una transición, por lo que puede ignorar pagos finalizados sin repetir el fulfillment.

La implementación utiliza verificaciones de application state para callbacks duplicados. Un provider event ID estable con database uniqueness constraint daría protección más sólida.

Actualizaciones realtime reemplazables

Pusher notifica a usuarios y admins los cambios de estado, pero no almacena el booking state.

Si el cliente pierde un evento realtime, puede volver a consultar la reserva mediante la API. Así se separan las notificaciones del workflow real.

Conflictos de reservas

La comprobación actual no constituye un transactional slot-reservation system. Dos solicitudes simultáneas pueden competir alrededor de la validación de disponibilidad.

Una versión más robusta aplicaría las reglas de solapamiento de salas y horarios dentro de una database transaction o mediante locking.

Resultado

El proyecto cubre todo el recorrido universitario: solicitud, aprobación, pago, actualizaciones y comprobantes, manteniendo separados los lifecycles de Booking y Payment.

Présentation

Pinjamin numérise la réservation de salles universitaires, de la demande et l’approbation au paiement en ligne, aux mises à jour realtime et aux justificatifs téléchargeables. J’ai travaillé sur le frontend, le backend, le modèle relationnel, les intégrations Xendit/Pusher et l’automatisation du deployment.

La difficulté survient après la demande : validation et paiement finissent à des moments différents, et Xendit transmet ensuite le résultat par callback.

Booking et Payment séparés

Booking suit la demande de salle ; Payment représente la transaction du fournisseur.

Le callback handler relit l’état actuel en database avant la transition. Un paiement déjà finalisé peut ainsi être ignoré sans répéter le fulfillment.

La solution utilise des contrôles d’application state contre les doublons. Un provider event ID stable avec une database uniqueness constraint serait plus robuste.

Mises à jour realtime remplaçables

Pusher informe les emprunteurs et admins des changements, mais ne stocke pas le booking state.

Si un client rate un événement realtime, il peut relire la réservation depuis l’API. La notification reste distincte du workflow réel.

Conflits de réservation

Le contrôle de disponibilité actuel n’est pas un transactional slot-reservation system. Deux requêtes simultanées peuvent subir une race condition lors de la vérification.

Une version renforcée appliquerait les règles de chevauchement de salles et horaires au niveau database transaction ou locking.

Résultat

Le projet couvre demande, approbation, paiement, mise à jour et génération de justificatifs tout en séparant les lifecycles de Booking et Payment.

Überblick

Pinjamin digitalisiert Campus-Raumbuchungen vom Antrag und der Genehmigung über Online-Zahlungen und Realtime-Updates bis zu herunterladbaren Belegen. Ich entwickelte Frontend, Backend, relationales Modell, Xendit- und Pusher-Integrationen sowie Deployment-Automation.

Die Schwierigkeit beginnt nach der Buchungsanfrage: Genehmigung und Zahlung erfolgen zu unterschiedlichen Zeiten, das Ergebnis meldet Xendit später per Callback.

Booking und Payment getrennt

Booking hält die Raumanfrage fest; Payment die Provider-Transaktion.

Der Callback Handler liest vor einer Änderung den aktuellen Datenbankzustand. Bereits abgeschlossene Zahlungen können übersprungen werden, ohne das Fulfillment erneut auszuführen.

Die Implementierung nutzt Application-State-Prüfungen gegen doppelte Callbacks. Ein stabiler Provider Event ID mit Database Uniqueness Constraint wäre zuverlässiger.

Austauschbare Realtime-Updates

Pusher informiert Nutzer und Admins bei Änderungen, speichert aber keinen Booking State.

Verpasst ein Client ein Event, kann er die aktuelle Buchung erneut über die API laden. So bleibt die Benachrichtigung vom eigentlichen Workflow getrennt.

Buchungskonflikte

Die aktuelle Verfügbarkeitsprüfung ist noch kein transactional slot-reservation system. Gleichzeitige Requests können bei der Prüfung eine Race Condition auslösen.

Eine robuste Version würde die Überschneidungsregel für Raum und Zeit in einer Database Transaction oder durch Locking sichern.

Ergebnis

Das Projekt deckt den gesamten Campus-Ablauf vom Antrag bis zu Genehmigung, Zahlung, Updates und Belegen ab und hält Booking- und Payment-Lifecycles getrennt.

概要

Pinjaminは大学の教室予約を、申請と承認からOnline決済、Realtime更新、証明書のダウンロードまでデジタル化します。私はFrontend、Backend、Relational Model、Xendit・Pusher Integration、Deployment Automationを担当しました。

難しいのは予約Request後です。承認と支払いが異なる時点で完了し、Xenditは後からCallbackで決済結果を通知します。

BookingとPaymentを分離

Bookingは教室の予約Requestを保持し、PaymentはProviderとの取引を保持します。

Callback Handlerは状態変更前に現在のDatabase Stateを読み直します。すでに確定済みのPaymentはFulfillmentを繰り返さずに無視できます。

現在はApplication Stateの確認で重複Callbackを防いでいますが、安定したProvider Event IDとDatabase Uniqueness Constraintの方が強力です。

交換可能なRealtime Update

Pusherは予約者とAdminに状態変更を通知しますが、Booking State自体は保存しません。

ClientがRealtime Eventを受け取れなくても、APIから最新の予約を再取得できます。これにより通知配送とBooking Workflowを分離します。

予約競合

現在の空き状況確認は完全なTransactional Slot Reservation Systemではありません。同時RequestによるRace Conditionが発生する可能性があります。

より強固な設計では、Database TransactionやLockingで教室と時間帯の重複ルールを保護します。

成果

申請から承認、支払い、更新、証明書発行まで大学の予約フローを網羅し、BookingとPaymentのLifecycleを独立して管理しました。