Glossary
Terminology reference for all audiences
Last updated: Sep 11, 2026
Jump To
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. Currently 19 ZIP codes across 15 municipalities: all 12 Hudson County towns (Hoboken, Jersey City, Weehawken, Union City, West New York, Guttenberg, North Bergen, Secaucus, Kearny, Harrison, East Newark, Bayonne) plus Edgewater, Cliffside Park, and Fairview in Bergen County. Note 07029 covers Harrison and East Newark; 07093 covers West New York and Guttenberg. |
| 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. It is operating procedure, not an acquisition selling benefit; state it in booking, FAQ, terms, and operational contexts. |
| Price-Lock Promise | The standard rate protection every member gets: the rate is held for the first 12 months. Any later adjustment is modest, at most annual, inflation-aligned, and announced 30 days ahead; a member may cancel before it takes effect with a free final delivery. Codified in Terms of Service §3. |
| Membership rate guarantee | The partner-property benefit: a resident of a participating property keeps the $299 rate for as long as they live at that address. It is tied to the building and does not expire, unlike the retired four-month resident discount it replaced (DEC-025, Sep 11, 2026). Implementation pending: a Terms line beside the Price-Lock Promise, and a tag on partner subscriptions so a future price change never touches them. |
| 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. |
| Schedule a Return | The canonical customer-facing action for a stored item (founder-ratified Jul 20, 2026; supersedes "Schedule Delivery," retires "Request Delivery"). Label only — the DB/transition vocabulary stays schedule_delivery/redelivery. |
| 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_confirmation | Items attached, awaiting the customer’s confirmation. Confirming creates the Google Calendar event. |
confirmed | Confirmed by the customer; calendar event live. Cancel and reschedule remain available. |
completed | Service finished. |
canceled | Booking canceled; items reverted. |
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. Links land at /auth/confirm?token_hash=… (prefetch-safe, works across browser contexts). |
| Custody | An item is “in custody” when it is physically in Storage Valet’s hands — stored, or scheduled for delivery. Custody drives the capacity and coverage meters (fn_v2_item_in_custody). |
| 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 |
|---|---|
| Bayonne | 07002 |
| Cliffside Park | 07010 |
| Edgewater | 07020 |
| Fairview | 07022 |
| Harrison / East Newark | 07029 |
| Hoboken | 07030 |
| Jersey City | 07302, 07304, 07305, 07306, 07307, 07310, 07311 |
| Kearny | 07032 |
| North Bergen | 07047 |
| Secaucus | 07094 |
| Union City | 07087 |
| Weehawken | 07086 |
| West New York / Guttenberg | 07093 |
Total: 19 active ZIPs across 15 municipalities — all 12 Hudson County towns plus Edgewater, Cliffside Park and Fairview in Bergen County. Expanded Aug 26, 2026 (DEC-024); public.service_areas is the source of truth. Fort Lee (07024) is deliberately excluded.
Pricing
| Term | Value |
|---|---|
| Monthly Price | $299/month |
| Trial Period | Complimentary first month (30 days) 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 (W4, live Jul 2026)
| Reward | Amount |
|---|---|
| Friend (referee) | Not live. Designed as $100 off the first month via a personal member code on Stripe coupon REFERRAL100, auto-applied through the share link. That coupon was not found in live Stripe on Sep 7, 2026, and a first-month discount is worth $0 under the complimentary first month — what the reward becomes is an open founder decision. |
| Referrer | $100 account credit, applied manually by ops on the friend’s first payment (Phase 1) |
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 founder-ratified Storage Valet brand system (v6.2, Jul 20, 2026). v6.1 is the editorial foundation; v6.2 adds controlled marketing energy without changing the locked palette or typography. See Brand Identity. |
| Visual implementation authority | /Users/zacharybrown/Documents/storagevalet/Brand/Brand System (Operation Midnight Teal)/claude-design-system/theme.css. It governs visual primitives, semantic tokens, components, patterns, and motion; repository stylesheets are downstream adapters. |
| Design master | A brand-package template containing placeholders and implementation guidance. It is not a production-ready print or send export until every fact, offer, URL, promo code, QR destination, media asset, accessibility requirement, and output specification has been validated. |
| 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. |