CompanySite/DEPLOYMENT-HANDOFF.md

Deployment Handoff - Domain Migration Complete

Date: 2026-03-21 Migration: workroot.com → workroot.in Status: ✅ Code Complete - Ready for Infrastructure Deployment

---

📦 What's Included

This handoff package contains all necessary documentation and configurations for deploying the domain migration from workroot.com to workroot.in.

Documentation Files Created

Document	Purpose	Audience
DOMAIN-MIGRATION-CHECKLIST.md	Comprehensive step-by-step deployment checklist	DevOps, Technical Lead
MIGRATION-SUMMARY.md	Executive summary and change overview	Product Owner, Management
QUICK-DEPLOY.md	Fast deployment reference (15-min guide)	DevOps, On-call Engineers
DEPLOYMENT-HANDOFF.md	This file - handoff summary	All stakeholders
CHANGELOG.md	Version history and change log	All teams

Updated Documentation

Document	Changes
DEPLOYMENT.md	Added migration references, updated nginx config
README.md	Added migration documentation links

---

✅ Code Changes Complete

All application code has been updated and tested:

Files Modified (Source Code)

✅ Configuration Files

• astro.config.mjs - Site URL updated to https://workroot.in
• tsconfig.json - Documentation updated

✅ API Routes

• src/pages/api/sitemap.xml.ts - Generates sitemap with workroot.in URLs
• src/pages/api/health.json.ts - Verified domain-agnostic

✅ SEO Components

• src/components/SEO.astro - Canonical and OG metadata updated
• All layouts use updated SEO component

✅ Content Schemas

• src/content/config.ts - Examples updated

✅ Documentation

• All markdown files updated with new domain references

Testing Completed

✅ Build Tests

• Production build successful
• No build errors or warnings
• Build artifacts verified to contain workroot.in

✅ Security Audit

• No hardcoded domains in security configurations
• CSP headers properly configured
• CORS settings verified
• Middleware supports new domain

✅ API Tests

• Health endpoint tested: /api/health.json
• Sitemap tested: /api/sitemap.xml
• All URLs in sitemap use workroot.in

✅ Performance Tests

• SSR response times within acceptable range
• No performance degradation from migration

---

🚧 What's NOT Done (Infrastructure Required)

The following tasks require infrastructure access and should be completed by DevOps:

Critical Path (Required Before Go-Live)

1. DNS Configuration ⏳

   • Update A records for workroot.in and www.workroot.in
   • Point to production server IP
   • Wait for propagation (24-48 hours)

2. SSL Certificate ⏳

   • Obtain SSL certificate for workroot.in
   • Install on production server
   • Configure nginx/apache for HTTPS

3. Server Configuration ⏳

   • Update nginx virtual host (config provided in docs)
   • Set up 301 redirects from workroot.com
   • Enable security headers (HSTS, etc.)

4. Application Deployment ⏳

   • Pull latest code
   • Run production build
   • Restart application server

5. Old Domain Redirects ⏳

   • Configure 301 redirects for all workroot.com URLs
   • Keep workroot.com SSL valid for HTTPS redirects

Post-Deployment (Within 7 Days)

6. Search Engine Updates ⏳

   • Google Search Console - Add property, submit sitemap
   • Set up Change of Address in GSC
   • Bing Webmaster Tools updates

7. Third-Party Services ⏳

   • Update analytics (GA, Tag Manager)
   • Update monitoring services
   • Update social media profiles

---

📋 Deployment Checklist Quick Links

For DevOps Team:

1. Start here: QUICK-DEPLOY.md - 15-minute deployment guide
2. Reference: DOMAIN-MIGRATION-CHECKLIST.md - Complete checklist

For Management:

1. Overview: MIGRATION-SUMMARY.md - Executive summary

For All Teams:

1. Changes: CHANGELOG.md - What changed
2. General deployment: DEPLOYMENT.md - Deployment guide

---

🎯 Success Criteria

The deployment will be considered successful when:

• New domain (workroot.in) loads correctly with valid SSL
• All pages load without errors (200 status)
• All old domain URLs redirect properly (301 status)
• Health check endpoint responds: https://workroot.in/api/health.json
• Sitemap accessible: https://workroot.in/api/sitemap.xml
• No increase in error rates (404s, 500s)
• Security headers passing: https://securityheaders.com
• Performance maintained (no degradation)

Verification Period: 48-72 hours of close monitoring

---

⚡ Quick Start for DevOps

Pre-requisites

• DNS access to update A records
• SSL certificate authority access (Let's Encrypt or other)
• Production server SSH access
• nginx/apache configuration access
• Application deployment permissions

Deployment Time Estimate

• DNS Setup: 5 minutes (+ 24-48h propagation)
• SSL Certificate: 10 minutes
• Server Config: 15 minutes
• Application Deploy: 15 minutes
• Testing: 30 minutes
• Total Active Time: ~75 minutes (+ DNS propagation wait)

Start Here

# 1. Verify DNS is ready
dig workroot.in +short

# 2. Follow QUICK-DEPLOY.md for step-by-step commands

# 3. Test everything per checklist

# 4. Monitor for 48-72 hours

---

🆘 Rollback Plan

If critical issues occur:

Estimated Rollback Time: 15-30 minutes

Rollback Steps

1. Revert DNS to old configuration
2. Restore previous nginx configuration
3. Deploy previous code version
4. Notify stakeholders

Detailed rollback instructions: See QUICK-DEPLOY.md section "Quick Rollback"

---

📊 Monitoring

First 48 Hours - Close Monitoring

Monitor these metrics:

• Error rate (should be < 1%)
• Response times (should be < 500ms avg)
• Redirect success rate (should be 100%)
• SSL certificate validity
• Server resources (CPU, memory, disk)

First 30 Days - SEO Monitoring

• Organic traffic levels
• Search engine rankings for key terms
• Google Search Console crawl errors
• Indexation status

Monitoring commands: See QUICK-DEPLOY.md section "Health Monitoring"

---

👥 Team Responsibilities

Team	Responsibility	Timeline
DevOps	DNS, SSL, server config, deployment	Day 0-1
Backend	Monitor API, fix any code issues	Day 0-7
Frontend	Monitor UI, test cross-browser	Day 0-7
SEO	Search engine updates, monitor rankings	Day 1-30
QA	End-to-end testing, redirect verification	Day 1-3
Product	Stakeholder communication, sign-off	Day 0-30

---

📞 Support & Escalation

Normal Business Hours

• DevOps Lead: [Contact Info]
• Technical Lead: [Contact Info]
• Product Owner: [Contact Info]

After Hours / Emergency

• On-Call Engineer: [Contact Info]
• Escalation: [Contact Info]

Issue Reporting

• Slack: #workroot-deployment
• Email: engineering@workroot.in
• Incident: [Incident Management Tool]

---

📝 Sign-Off Checklist

Development Team

• Code changes complete and committed
• All tests passing
• Documentation created
• Security audit complete
• Performance verified
• Handoff documentation prepared

Signed: AI Documentation Writer Date: 2026-03-21

DevOps Team (To be completed)

• DNS configured
• SSL certificate installed
• Server configuration updated
• Application deployed
• Redirects configured and tested
• Monitoring configured

Signed: _________________ Date: _________________

QA Team (To be completed)

• End-to-end testing complete
• Cross-browser testing complete
• Mobile testing complete
• Redirect testing complete
• Performance testing complete

Signed: _________________ Date: _________________

Product Owner (To be completed)

• Review changes approved
• Go-live approved
• Stakeholders notified
• Success criteria defined
• Monitoring period complete

Signed: _________________ Date: _________________

---

🎉 Next Steps

1. DevOps Team: Review QUICK-DEPLOY.md and schedule deployment
2. Set Deployment Date: Coordinate with all teams
3. Run Deployment: Follow checklist step-by-step
4. Monitor: Watch systems for 48-72 hours
5. Complete Post-Deployment Tasks: SEO updates, service updates
6. Final Sign-Off: Mark deployment complete after 7 days

---

📚 Additional Resources

• Astro Documentation: https://docs.astro.build
• Let's Encrypt: https://letsencrypt.org
• Nginx Documentation: https://nginx.org/en/docs/
• Google Search Console: https://search.google.com/search-console
• SecurityHeaders.com: https://securityheaders.com

---

Questions? Contact the development team or refer to the documentation files listed above.

Last Updated: 2026-03-21 Version: 1.0