# Deployment launch plan for PipeStock Pro A production handoff plan for taking Plumbing Supply Inventory from sales preview to a client-owned launch domain with Netlify hosting, environment gates, monitoring, rollback, and canonical SEO/AEO checks. Repository: Idea-R/ideas-realized-page Preview domain: plumbing-supply.ideas-realized.com Production domain: plumbing-supply.ideas-realized.com JSON manifest: /demo-library/plumbing-supply/deployment-launch.json OpenAPI implementation spec: /demo-library/plumbing-supply/openapi.json ## Hosting Model Single Next.js application deployed from GitHub to Netlify, with demo subdomains rewritten into app-only routes and canonical SEO pages kept on ideas-realized.com. ## Branch Strategy Ship from a reviewed feature branch into the existing Netlify production site, then attach the selected client subdomain as a named domain alias after acceptance gates pass. ## Environments ### Sales preview URL: https://plumbing-supply.ideas-realized.com Status: complete Purpose: App-only demo surface used in sales calls and embedded from the canonical landing page. Data mode: Seeded client-side preview data only; no tenant secrets or live customer records. ### Deploy preview URL: Netlify deploy preview URL from the feature branch Status: in progress Purpose: Review branch before domain aliasing, schema checks, browser QA, and stakeholder sign-off. Data mode: Seeded demo data plus import template samples. ### Pilot production URL: https://plumbing-supply.ideas-realized.com Status: queued Purpose: Trade supply inventory software pilot package launch for the first buyer cohort. Data mode: Run a read-only SKU import, validate bin and on-hand values with counter staff, then enable receiving and will-call status updates for the pilot category. ## Domain And DNS Records - [ready] CNAME plumbing-supply.ideas-realized.com -> Ideas Realized Netlify site alias or wildcard domain. Owner: Ideas Realized technical lead. Keeps the app-only demo available as the sales URL while the canonical page remains on ideas-realized.com. - [needs client] CNAME plumbing-supply.ideas-realized.com -> Client DNS points to the approved Netlify site alias. Owner: Client DNS owner. Use inventory.clientdomain.com or branch.clientdomain.com for production and keep plumbing-supply.ideas-realized.com as the demo subdomain. - [needs client] TXT _netlify.plumbing-supply.ideas-realized.com -> Netlify verification token issued during domain setup. Owner: Client DNS owner. Required before SSL issuance and production cutover when the domain is client-owned. ## Environment Variables - [template] NEXT_PUBLIC_SITE_URL (Build and runtime). Owner: Ideas Realized technical lead. Set to https://plumbing-supply.ideas-realized.com for pilot production and keep canonical demo routes pointed at ideas-realized.com. - [ready] NEXT_DISABLE_IMAGE_OPTIMIZATION (Netlify runtime). Owner: Ideas Realized technical lead. Use when the host requires unoptimized Next images for generated poster assets and demo previews. - [needs client] AUTH_PROVIDER_CONFIG (Runtime secret). Owner: Implementation lead. Staff email login for the pilot branch, with optional SSO after ERP and directory ownership are confirmed. - [template] NOTIFICATION_SENDER (Runtime secret). Owner: Implementation lead. In-app: Receiving variance needs review - [template] ANALYTICS_WRITE_KEY (Runtime secret). Owner: Growth lead. Instrument inventory landing CTA, app preview, SKU search, scanner lookup, receiving variance, reorder alert, will-call status, export, and spec download. ## Release Gates - [in progress] Scan SKU into receiving session. Owner: Warehouse lead. Evidence: Scanner history and PO receipt panel update; hardware test pending. - [complete] Resolve cycle count variance. Owner: Branch manager. Evidence: Count task exposes expected, counted, variance, and adjustment status. - [complete] Confirm will-call readiness from counter view. Owner: Counter manager. Evidence: Pickup board surfaces staged, picking, waiting, and customer-ready states. - [complete] Canonical and noindex routing verified. Owner: Technical lead. Evidence: Main-domain landing pages remain canonical while app-only routes are used for subdomain launch URLs. - [queued] Client proposal and implementation spec approved. Owner: Client sponsor. Evidence: PipeStock Pro pilot proposal and JSON/Markdown implementation spec are reviewed before production domain cutover. ## Monitoring Signals - Demo app availability: Homepage and app route return 200 from production domain after DNS cutover. Owner: Technical lead. Response: Rollback DNS alias to preview or pause launch announcement until the route passes. - Branch exceptions reviewed before ERP posting: Pilot usage is visible in the buyer dashboard within the first review cycle. Owner: Growth lead. Response: Review analytics key, event mapping, and privacy guardrails before widening access. - Confirm ERP item ID and on-hand quantity source of truth.: No open launch blocker can affect first user workflow. Owner: Implementation lead. Response: Hold go-live and keep the app in preview mode until the blocker has owner-approved evidence. ## Rollback Plan - Keep the sales preview subdomain live until the client production domain passes route, SSL, auth, and acceptance checks. - If client DNS or SSL fails, remove the production alias and route users back to the preview subdomain. - If data import fails, restore the last approved seed/import snapshot and hold workflow edits until the exception report is reviewed. - If notification or integration credentials fail, disable outbound automation and continue with manual review queues. - Document the rollback decision in the operations ledger and add the next action to the live ops command center. ## Go-Live Sequence - Merge the reviewed branch after typecheck, lint, build, schema validation, and browser QA pass. - Create or confirm the Netlify domain alias for the sales preview subdomain. - Request client DNS records for plumbing-supply.ideas-realized.com and verify ownership before SSL issuance. - Load tenant brand tokens, roles, launch assets, import templates, and acceptance evidence. - Run release gates, verify monitoring signals, and approve the first pilot user cohort. - Publish SEO/AEO links for Plumbing supply inventory software and route launch CTAs to the canonical demo landing page. ## Support Handoff - Pilot support scope: $1k-$3.5k/month recurring for hosting, support, and workflow tuning. - SKU import template - Scanner test script - Receiving variance export - Choose pilot category: Branch manager; Start with valves, fittings, or high-turn PEX inventory. - Validate scanner input: Technical lead; Run acceptance test with wedge scanner and browser focus behavior. ## SEO Launch Checks - /demo-library/plumbing-supply remains the canonical landing page for plumbing supply inventory software. - https://plumbing-supply.ideas-realized.com remains app-only and noindex for thin duplicate prevention. - Confirm internal links mention trade counter inventory app. - Confirm internal links mention plumbing parts inventory system. - Confirm internal links mention will call pickup software. - Answer target: How do plumbing supply houses track will-call orders? - Answer target: What should trade counter inventory software include?