╔══════════════════════════════════════════════════════════════════════╗
║                  BaseCloud UTM Tracker                                ║
║              🚀 Quick Deployment Reference Card                       ║
╚══════════════════════════════════════════════════════════════════════╝

┌──────────────────────────────────────────────────────────────────────┐
│ ✅ CURRENT STATUS (February 12, 2026)                                │
├──────────────────────────────────────────────────────────────────────┤
│ Plugin Version:      3.0.1                                           │
│ Stable Tag:          3.0.1                                           │
│ Package Version:     3.0.1                                           │
│ SVN Tags:            2 tags (1.1.0, 3.0.1)                           │
│ Available Slots:     3 more tags                                     │
│ Status:              🟢 READY FOR DEPLOYMENT                         │
└──────────────────────────────────────────────────────────────────────┘

┌──────────────────────────────────────────────────────────────────────┐
│ 🚀 DEPLOY NEW VERSION (3 Commands)                                  │
├──────────────────────────────────────────────────────────────────────┤
│                                                                      │
│ Bug Fixes / Small Updates (3.0.1 → 3.0.2)                           │
│ ➜  .\deploy.ps1 patch                                                │
│                                                                      │
│ New Features (3.0.1 → 3.1.0)                                         │
│ ➜  .\deploy.ps1 minor                                                │
│                                                                      │
│ Major Changes (3.0.1 → 4.0.0)                                        │
│ ➜  .\deploy.ps1 major                                                │
│                                                                      │
│ Specific Version (3.0.1 → 3.0.5)                                     │
│ ➜  .\deploy.ps1 3.0.5                                                │
│                                                                      │
└──────────────────────────────────────────────────────────────────────┘

┌──────────────────────────────────────────────────────────────────────┐
│ 📝 WHAT HAPPENS WHEN YOU DEPLOY                                     │
├──────────────────────────────────────────────────────────────────────┤
│ 1. ✓ Updates version in basecloud-utm-tracker.php                   │
│ 2. ✓ Updates stable tag in readme.txt                               │
│ 3. ✓ Creates changelog entry template                               │
│ 4. ⏸ PAUSES - Edit changelog with your changes                      │
│ 5. ✓ Commits all changes to Git                                     │
│ 6. ✓ Creates version tag (e.g., v3.0.2)                             │
│ 7. ✓ Pushes to GitHub                                               │
│ 8. 🤖 GitHub Actions deploys to WordPress.org                       │
└──────────────────────────────────────────────────────────────────────┘

┌──────────────────────────────────────────────────────────────────────┐
│ ✅ FIXES COMPLETED TODAY                                            │
├──────────────────────────────────────────────────────────────────────┤
│ ✓ Removed old SVN tags (5→2, freed 3 slots)                         │
│ ✓ Synchronized all version numbers to 3.0.1                         │
│ ✓ Fixed CHANGELOG.md date formatting                                │
│ ✓ Secured GitHub workflow (removed hard-coded credentials)          │
│ ✓ Created comprehensive deployment documentation                    │
└──────────────────────────────────────────────────────────────────────┘

┌──────────────────────────────────────────────────────────────────────┐
│ 📋 BEFORE NEXT DEPLOYMENT - CHECKLIST                               │
├──────────────────────────────────────────────────────────────────────┤
│ □ Make code changes                                                 │
│ □ Test thoroughly in local environment                              │
│ □ Prepare changelog notes                                           │
│ □ Run deployment script                                             │
│ □ Edit changelog when prompted                                      │
│ □ Monitor GitHub Actions                                            │
│ □ Verify on WordPress.org                                           │
└──────────────────────────────────────────────────────────────────────┘

┌──────────────────────────────────────────────────────────────────────┐
│ 🔍 QUICK VERIFICATION COMMANDS                                      │
├──────────────────────────────────────────────────────────────────────┤
│ Check current version:                                              │
│ php -r "require 'version-helper.php'; echo                          │
│        basecloud_utm_get_plugin_version();"                         │
│                                                                      │
│ View Git status:                                                    │
│ git status                                                          │
│                                                                      │
│ List available tags:                                                │
│ git tag -l                                                          │
│                                                                      │
│ Check SVN tags:                                                     │
│ dir svn-repo\tags                                                   │
└──────────────────────────────────────────────────────────────────────┘

┌──────────────────────────────────────────────────────────────────────┐
│ 📚 DOCUMENTATION FILES                                              │
├──────────────────────────────────────────────────────────────────────┤
│ DEPLOYMENT_GUIDE.md  →  Complete deployment instructions           │
│ FIXES_SUMMARY.md     →  All fixes applied today                    │
│ DEPLOYMENT.md        →  Original deployment guide                  │
│ CHANGELOG.md         →  Full version history                       │
│ README.md            →  Plugin information                         │
└──────────────────────────────────────────────────────────────────────┘

┌──────────────────────────────────────────────────────────────────────┐
│ ⚠️ IMPORTANT REMINDERS                                              │
├──────────────────────────────────────────────────────────────────────┤
│ • Update BOTH readme.txt AND CHANGELOG.md                           │
│ • Use date format: YYYY-MM-DD (e.g., 2026-02-12)                    │
│ • You have 3 tag slots left before cleanup needed                   │
│ • GitHub secrets must be set: WP_ORG_USERNAME, WP_ORG_PASSWORD      │
│ • Deployment triggers on git tag push (automatic)                   │
└──────────────────────────────────────────────────────────────────────┘

┌──────────────────────────────────────────────────────────────────────┐
│ 🌐 USEFUL LINKS                                                     │
├──────────────────────────────────────────────────────────────────────┤
│ GitHub Repo:                                                        │
│ https://github.com/BaseCloudGlobal/BaseCloudUTMTracker              │
│                                                                      │
│ GitHub Actions:                                                     │
│ https://github.com/BaseCloudGlobal/BaseCloudUTMTracker/actions      │
│                                                                      │
│ WordPress.org Plugin:                                               │
│ https://wordpress.org/plugins/basecloud-utm-tracker/                │
│                                                                      │
│ Readme Validator:                                                   │
│ https://wordpress.org/plugins/developers/readme-validator/          │
└──────────────────────────────────────────────────────────────────────┘

┌──────────────────────────────────────────────────────────────────────┐
│ 🆘 TROUBLESHOOTING                                                  │
├──────────────────────────────────────────────────────────────────────┤
│ "Version not found"      → Check plugin file header format         │
│ "Git push failed"        → Verify GitHub authentication            │
│ "Workflow failed"        → Check GitHub secrets configuration      │
│ "WP.org deploy failed"   → Validate readme.txt format              │
│                                                                      │
│ See DEPLOYMENT_GUIDE.md for detailed troubleshooting                │
└──────────────────────────────────────────────────────────────────────┘

╔══════════════════════════════════════════════════════════════════════╗
║ 🎯 DEPLOYMENT SYSTEM STATUS: 🟢 FULLY OPERATIONAL                   ║
║                                                                      ║
║ All issues resolved. Ready for deployment!                          ║
║                                                                      ║
║ Last Updated: February 12, 2026                                     ║
╚══════════════════════════════════════════════════════════════════════╝
