page:blueprints:equipment rental:inventory manager:next js

Equipment rental: inventory manager using Next.js

Summary

A inventory manager blueprint for equipment rental built with Next.js on Ample. Domain schema: equipment (sku, name, category, day_rate, serial_tracked): rental catalog; stock_movements (sku, unit_serial, delta, reason, moved_at): check-outs, returns and maintenance; rentals (rental_no, period_start, period_end, status): rentals with status transitions; rental_lines (rental_no, sku, unit_serial, rate): rental contents; events (seq, record_type, record_id, kind, at): application-owned history written in the same transaction. Public information: equipment catalog and rates, availability calendar, deposit and insurance terms. Kept out of scope until handling is reviewed: renter identity documents, payment and deposit details. Identity verification and deposits are outside these flows; only availability and rental status are modeled. Technical basis verified on Next.js: an optimistic version check and an event row written in the same transaction, a stale update rejected, and a history query over the application-owned events (history=2 conflict=rejected).

Representative Queries

Requirements

Resource Requirements

Infrastructure Requirements

  1. Compute: Apps run in isolated x86_64 Firecracker microVMs that auto-pause when idle and wake on request; sizes are the priced VM sizes.
  2. Postgres: Managed PostgreSQL 16 runs in its own microVM and is auto-provisioned when an app needs a database and no DATABASE_URL is supplied.
  3. S3-compatible object storage: Buckets are S3-compatible with issued credentials; PutObject and GetObject are verified by canary. Other S3 operations are not verified.

Prerequisites

Workflow Steps

  1. Model the equipment rental domain: Create the tables equipment, stock_movements, rentals, rental_lines, events. Rental catalog lives in equipment; keep the sensitive classes out of this schema.
  2. Workflow step 1: Model SKUs and stock movements; derive stock from movements.
  3. Workflow step 2: Apply movements transactionally with an optimistic version check on the SKU.
  4. Workflow step 3: Record an event per movement for history.
  5. Workflow step 4: Deploy and verify history and rejected stale updates.
  6. Deploy: Run the synchronous deploy once and read the result.
  7. Verify: Run the pattern self-test(s) from the example and your own acceptance checks for the equipment rental workflow.

Cost Estimate

Limitations

Evidence Summary