# Deployment launch plan for LeaseOps Portal

A production handoff plan for taking Property Management Pipeline Portal 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: property-management.ideas-realized.com
Production domain: property-management.ideas-realized.com
JSON manifest: /demo-library/property-management/deployment-launch.json
OpenAPI implementation spec: /demo-library/property-management/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://property-management.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://property-management.ideas-realized.com
Status: queued
Purpose: Property management onboarding software pilot package launch for the first buyer cohort.
Data mode: Import a small cohort of new-owner records, reconcile property identifiers with the PMS, then invite internal managers before owner-facing portal access.

## Domain And DNS Records

- [ready] CNAME property-management.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 property-management.ideas-realized.com -> Client DNS points to the approved Netlify site alias. Owner: Client DNS owner. Use owners.clientdomain.com or onboarding.clientdomain.com for the live portal, with property-management.ideas-realized.com retained as the sales preview.
- [needs client] TXT _netlify.property-management.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://property-management.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. Email invitation for owners and staff during pilot, with Microsoft Entra or Google Workspace SSO as the production path.
- [template] NOTIFICATION_SENDER (Runtime secret). Owner: Implementation lead. Email: A few onboarding items still need attention
- [template] ANALYTICS_WRITE_KEY (Runtime secret). Owner: Growth lead. Instrument landing CTA, owner packet review, document status changes, rent-ready task completion, export preflight, and implementation-spec download.

## Release Gates

- [complete] Move a property from intake to rent-ready. Owner: Portfolio manager. Evidence: Pipeline stage, launch checklist, and owner queue reflect the same property.
- [in progress] Route an owner document exception. Owner: Leasing coordinator. Evidence: Exception queue exists; document type mapping needs final labels.
- [complete] Export owner onboarding launch spec. Owner: Sales lead. Evidence: Spec includes roles, document objects, integrations, and launch assets.
- [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: LeaseOps Portal 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.
- Properties moved from owner packet started to rent-ready without unresolved accounting blockers: 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 document storage and retention policy.: 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 property-management.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 Property management onboarding software and route launch CTAs to the canonical demo landing page.

## Support Handoff

- Pilot support scope: $1.2k-$4k/month recurring for hosting, support, and workflow tuning.
- Owner packet import template
- Rent-ready checklist
- Accounting export field map
- Confirm owner invite wording: Client sponsor; Brand owner-facing request and reminder copy before invitations.
- Map document types: Operations lead; Separate lease, insurance, HOA, inspection, and rent-ready artifacts.

## SEO Launch Checks

- /demo-library/property-management remains the canonical landing page for property management onboarding software.
- https://property-management.ideas-realized.com remains app-only and noindex for thin duplicate prevention.
- Confirm internal links mention owner packet portal.
- Confirm internal links mention property management document workflow.
- Confirm internal links mention lease onboarding dashboard.
- Answer target: How do property managers collect owner onboarding documents?
- Answer target: What should an owner packet portal include?
