Back to all projects

SaaS Platform / Case Study

SPOT CC

SPOT CC brings the container-storage rental journey into one platform: live availability, fixed 30-day plans, verified customer accounts, signed contracts, Stripe billing, and booking management. Location teams manage inventory, pricing, contracts, staff access, and customer operations through protected workflows.

Visit live site
SPOT CC application interface screenshot
Role

Full-Stack Developer - Product Architecture, Rental Lifecycle, Billing, and Admin Systems

Duration / status

8 months

Project type

SaaS Platform

Next.jsReactTypeScriptPrismaPostgreSQLStripeNextAuthCloudflare R2Tailwind CSS

The Challenge

Problem

A storage rental depends on physical availability, verified identity, signed commercial terms, payment events, and staff actions that do not happen at the same time. The challenge was keeping those decisions consistent from reservation through renewal or departure, including retries, cancellations, and concurrent operations.

Constraints

  • Bookings needed interval-aware availability, a start-date window of up to 15 local calendar days, and plans measured in fixed 30-day blocks rather than calendar months.
  • Pending payments and concurrent reservations could not allocate the same physical container to overlapping rentals.
  • Contract versions, legal identity, commercial terms, taxes, promotions, and guarantees needed immutable signing evidence even when settings later changed.
  • Asynchronous Stripe events, failed payments, plan changes, refunds, and provider ambiguity had to reconcile safely with internal Booking state.
  • Customer access had to respect identity and phone verification, payment, rental start, lifecycle status, and the location's PIN or own-padlock policy.
  • Location staff required scoped permissions, auditable actions, and reliable notifications without exposing sensitive customer or legal data.

Approach

  1. 01

    Model the Rental Domain and Availability

    Centralized fixed-block rental policy, date-window validation, interval-aware availability, and serialized container allocation so a Booking owns a real physical unit.

  2. 02

    Reconcile Booking and Stripe Lifecycles

    Bound pending-payment Bookings to their exact Checkout, then coordinated webhook-driven activation, recurring billing, grace periods, next-renewal changes, cancellation, and restoration paths.

  3. 03

    Bind Identity to Versioned Contract Evidence

    Combined verified email and phone, Didit KYC, personalized contract review, signature capture, immutable acceptance snapshots, and integrity-checked PDFs stored privately in Cloudflare R2.

  4. 04

    Connect Catalog, Pricing, and Guarantees

    Built location and category administration around plans, promotional terms, VAT modes, configurable guarantees, and Stripe catalog synchronization while preserving signed historical economics.

  5. 05

    Protect Location Operations and Physical Access

    Applied location-scoped RBAC and audit boundaries to inventory, staff, customer actions, and physical handover, with separate access rules for PIN and own-padlock configurations.

  6. 06

    Automate Lifecycle Communications and Recovery

    Used scheduled jobs and durable delivery ownership for customer email/SMS, reminders, cancellation notices, and repair workflows, avoiding blind retries after ambiguous provider outcomes.

Implementation Highlights

  • Availability-First Reservations

    Validated reservation intervals against real container inventory, protected allocation from concurrent claims, and supported flexible combinations of fixed 30-day rental blocks.

  • Stripe Billing and Lifecycle Recovery

    Connected initial Checkout and recurring subscriptions to Booking state, including payment failure, grace, plan changes, cancellation, and controlled reactivation or restore flows.

  • Verified Identity and Access Eligibility

    Combined email and phone verification with Didit KYC, signed-contract status, payment eligibility, rental dates, and configurable physical lock policies.

  • Location Administration and Staff RBAC

    Created protected tools for locations, physical containers, pricing, contracts, promotions, staff assignments, and operational state changes with scoped audit trails.

  • Signed Contracts and Verifiable Artifacts

    Preserved versioned legal acceptance, hash-bound evidence, signatures, signed PDF history, and private R2 document storage without rewriting earlier signed terms.

  • Reliable Automation and Notifications

    Coordinated lifecycle jobs, transactional email/SMS, delivery deduplication, and support-grade operational audit evidence across payment and rental transitions.

Screens

Tap an image to open. Pinch to zoom inside the modal.

Results

1-36 Blocks

Rental Policy

Supported fixed 30-day rental periods, interval-aware stock checks, and a complete Booking lifecycle from pending payment to physical handover.

Versioned Evidence

Contract Integrity

Bound personalized agreements, signatures, pricing, and guarantees to immutable evidence and integrity-checked legal document history.

27 Scenarios

Pre-Production Coverage

The September 2026 pre-production campaign accepted 27 validation scenarios, with 96 stable Playwright tests passing in that historical snapshot.

Next Steps

Potential future iterations include deeper operational reporting, additional supported access integrations, and more self-service tooling for location teams.

Interested in working together?

Let's discuss how I can help bring your project to life.

Get in touch