Glossary — SV-Wiki

Jump To

Business Terms
Customer Terms
Item States
Booking Statuses
Technical Terms
Metrics
Service Areas
Pricing

Business Terms

Term	Definition
Storage Valet	The company name and service. Premium concierge storage for Hudson County, NJ.
Concierge Storage	Storage service where the provider handles pickup and delivery (vs. self-storage).
As Needed	Approved language for describing delivery service. Implies 48-hour advance notice. NEVER say "on-demand."
Service Area	Geographic region where pickup/delivery is offered. Launch: 13 ZIP codes across 7 municipalities in Hudson County and the surrounding area (Hoboken, Jersey City, Weehawken, West New York, Union City, North Bergen, Edgewater).
Out of Service Area	Customer address outside launch ZIP codes. Soft gate, not rejected.
Items-First Booking	The portal booking model: customer selects items, picks a native Google Calendar slot (48-hour lead, up to 365 days out), and confirms — all inside the portal.
Entitlement Gate	Server-side membership assertion (`SV_NOT_ENTITLED`) on the RPCs that grow stored inventory (item create, pickup attach). Recovery paths (delivery, cancel, revert, reschedule) are never gated; `sv.staff` bypasses.
48-Hour Lead Time	Standard advance notice required for pickups/deliveries.
White-Glove	Premium, careful handling of customer belongings.

Customer Terms

Term	Definition
Item	A customer-owned belonging tracked in the inventory system.
Inventory	The collection of items a customer has cataloged.
Portal	Customer-facing web application at portal.mystoragevalet.com.
Booking	A scheduled service (pickup or delivery). Represented as `action` in database.
QR Code	Unique identifier for each item. Format: `SV-YYYY-NNNNNN`.

Item States

State	Definition
home	Item is at customer's address.
scheduled	Item is scheduled for a service (pickup or delivery). The type is determined by the booking's `pickup_item_ids` or `delivery_item_ids` arrays, not the item status itself. UI may display "Scheduled (pickup)" or "Scheduled (delivery)" as labels.
in_transit	Item is being moved (pickup or delivery in progress).
stored	Item is in Storage Valet facility.

Booking Statuses

Status	Definition
`pending_items`	Appointment booked but items not yet selected.
`pending_confirmation`	Items selected, awaiting ops confirmation.
`confirmed`	Ops confirmed, scheduled for execution.
`in_progress`	Service being executed.
`completed`	Service finished.
`canceled`	Booking canceled.

Technical Terms

Term	Definition
Portal	Customer-facing React web app. Hosted on Vercel at portal.mystoragevalet.com.
Edge Functions	Serverless functions on Supabase (Deno runtime). Handle webhooks.
RLS (Row Level Security)	PostgreSQL feature enforcing data isolation. Users only see their own data.
Signed URLs	Time-limited URLs for private storage bucket access. 1-hour expiry.
Magic Links	Email-based authentication (no passwords). Click link → authenticated.
Webhook	HTTP callback from external service (Stripe, Calendly).
Idempotency	Processing duplicate events only once via unique constraints.

Database Terms

Term	Definition
customer_profile	Table storing user account data. 1:1 with auth.users.
items	Table storing customer inventory.
actions	Table storing service requests (pickups, deliveries).
booking_events	Audit table logging booking lifecycle events.
inventory_events	Audit table logging item movement events.
SECURITY DEFINER	PostgreSQL function that runs with creator's permissions.

Integration Terms

Term	Definition
Stripe Checkout	Hosted payment page for subscription signup.
Stripe Customer Portal	Hosted billing management page.
Stripe Webhook	HTTP callback from Stripe for payment events.
SV Bookings	Founder-owned Google Calendar that the scheduling service account (`sv-calendar@sv-scheduling`) writes booking events to. The live scheduling layer since Jun 10, 2026.
Calendly	Legacy v1 scheduling tool. No longer the live booking layer; remains only as v1’s read-only webhook path.
Calendly Webhook	HTTP callback from Calendly for legacy v1 booking events (HMAC verification enabled, fails closed).

Metrics

Metric	Definition
CUM	Containers Under Management — count of active containers.
IUM	Items Under Management — count of cataloged items.
DVUM	Declared Value Under Management — sum of customer-declared item values.
Contribution Margin	Revenue minus variable costs per customer.
CAC	Customer Acquisition Cost — all-in cost to acquire a customer.
LTV	Lifetime Value — contribution margin × average customer lifetime.
Golden Ratio	(Revenue per sqft leased) ÷ (Cost per sqft leased).

Subscription Statuses

Status	Definition
`active`	Subscription current, full portal access.
`past_due`	Payment failed, grace period. Limited access.
`canceled`	Subscription ended. Read-only inventory.
`trialing`	Trial period. Full access.
`inactive`	Not yet subscribed.

Service Area ZIP Codes

City	ZIP Codes
Edgewater	07020
Hoboken	07030
Jersey City	07302, 07304, 07305, 07306, 07307, 07310, 07311
North Bergen	07047
Union City	07087
Weehawken	07086
West New York	07093

Total: 13 active ZIPs (verified Jan 2026)

Pricing

Term	Value
Monthly Price	$299/month
Trial Period	14-day complimentary trial on all new subscriptions
Setup Fee	NONE — eliminated for simplicity
Included Coverage	$2,000 baseline insurance per subscription
Plan Capacity	200 cubic feet included per subscription

Trial Purpose

Gives customers time to explore the portal, create their digital inventory, and schedule their first pickup before billing begins.

Container Catalog

Container	Cubic Feet	Price
Storage Bin	1.25	$15
Storage Tote	2.67	$20
Storage Crate	5.56	$25

Referral Program

Reward	Amount
Referrer Reward	$50 account credit
Referee Reward	$25 account credit

Service Types

Type	Code	Definition
Pickup	`pickup`	Collect items from customer, transport to storage.
Redelivery	`redelivery`	Return stored items to customer.
Container Delivery	`container_delivery`	Deliver empty containers (future feature).

Repository Terms

Term	Definition
sv-portal	v1 customer portal (Vite 5 / React 18, Calendly-era). Decommissioned + archived Jun 29, 2026 (DEC-021): frontend retired, v1-only edge fns/RPCs/views removed; ops moved to the v2 `/ops` surface.
sv-portal-2026	LIVE customer portal at portal.mystoragevalet.com since Jun 10, 2026 (Vite 8 / React 19 / Tailwind 4, v6 Midnight Teal, native Google Calendar, RPC-only writes); frontend-only, reuses sv-edge + sv-db.
sv-edge	Supabase Edge Functions repository (shared backend for both portals).
sv-db	Database migrations repository (shared backend for both portals).
sv-docs	Operational scripts, runbooks, and documentation archive.
sv-website	Static marketing site; calls sv-edge functions for signup/partnership (not standalone).
sv-wiki	Internal team wiki (static HTML, hosted on Vercel at wiki.mystoragevalet.com).
CLAUDE.md	AI agent context file in each repository.

Brand Terms

Term	Definition
Operation Midnight Teal	The Storage Valet brand system (v6). Dark-first, 12-color, WCAG AA+, CBO reviewed, 6-agent validated. See Brand Identity.
Electric Teal	The accent color (#00D4AA). CTA fills (both modes); icons, focus, accent text on dark surfaces only.
Midnight	Primary dark surface (#0A1628). Cards, nav, footer, CTA button text.
Storm / Mist	Full-opacity body text tokens. Storm (#3D4F54) on light surfaces; Mist (#8BA4A8) on dark. They never cross modes.
Link Teal	Text links and interactive text on light backgrounds (#007A62). The light-mode counterpart to Electric Teal.
Semantic token	A CSS custom property that resolves to different palette values based on mode — e.g., `--sv-accent-text` resolves to Electric Teal in dark mode and Link Teal in light mode.
Palette lock	The rule that the brand palette contains exactly 12 colors (3 dark + 4 teal + 5 neutral). No new hex values may be added.