Skip to main content
George Santana / krakenserv.dev
Back to Case Studies
Full-Stack Web & FinTech 2026 Private repository · Anonymized client

01 — The Problem

Planning international hardware or inventory purchases using only base USD sticker prices leads to cash shortfalls by overlooking per-pound courier freight, membership discounts, and customs tax jumps above the US$200 FOB threshold.

02 — Architecture & Flow

Dockerized TypeScript full-stack service backed by interchangeable persistence (zero-setup SQLite by default or MariaDB 11 via Compose override) paired with a streamlined single-screen interface.

01 True Landed-Cost Math

Computes discounted courier freight by weight plus customs duties whenever FOB exceeds US$200.

02 In-Transit Commitment

Moving an item to IN_TRANSIT deducts item cost and locks estimated freight + taxes.

03 Waterfall Allocation

Allocates free liquidity down the priority queue and flags affordable lower-queue items.

04 Pickup Reconciliation

Marking Picked Up records actual courier payment and settles remaining liquidity.

03 — Technical Solution

Built a waterfall funding engine that locks committed freight and tax reserves for in-transit shipments, allocates remaining free liquidity strictly down the priority queue, and reconciles real courier receipts via a two-step state flow (WISHLIST → IN_TRANSIT → PICKED_UP).

04 — Production Results

  • Instant visibility into true landed cost before committing cash to any purchase.
  • Clean reconciliation between estimated transit reserves and actual courier invoices upon pickup.
  • Portable self-hosted deployment with persistent Docker volumes and health-checked API endpoints.

Single-Screen Financial Clarity

Zero accounting bloat, maximum decision speed

BudgetTracker strips away multi-page dashboards to answer one practical question: what can be ordered today without starving incoming shipments at pickup?

  • Committed vs. free liquidity: Items marked IN_TRANSIT isolate their estimated shipping and customs obligations immediately so available cash is never double-counted.
  • Out-of-order affordability hints: While preserving strict top-priority funding, the waterfall highlights lower-priority items that fit comfortably inside remaining free balance.
  • Drop-in persistence: Starts in seconds on local SQLite or swaps cleanly to MariaDB via Docker Compose overlays and automated healthchecks.

Interactive engineering demo

LIVE INTERACTIVE DEMO // REACT ISLAND

Test the engineering logic live

Simulate available liquidity and the customs tax threshold jump above US$200 FOB (with a 20% courier freight discount).

Courier freight (-20% disc.)

$20.16

Customs duty & tax

$60.20

Taxed above US$200 FOB

Total Landed Cost

$295.36

Remaining free liquidity

$154.64

Affordable with current balance

05 — CONTACT & SCOPE

Shall we talk about your next system?

Share a short brief of what you want to launch or fix. You will get a clear technical approach, realistic timeline, and next steps.

Project type

Estimated budget

Target timeline

Spam-protected with Zod boundary validation and Cloudflare Turnstile.

Direct technical reply within 24 business hours.

GitHub ↗ LinkedIn ↗