Brain/command-center/DEPLOYMENT_CHECKLIST.md

TekDek Command Center - Deployment Checklist

Prepared for: Hephaestus, Operations Engineer
Date: 2026-04-13
Status: Ready for Production Deployment

---

Pre-Deployment Verification

Code Quality ✅

• Backend: Talos - 1,905 lines of production code
• Frontend: Icarus - ~57 KB, zero dependencies
• Tests: 95%+ coverage (19/19 tests passing on validation)
• Documentation: 5+ guides (README, API, Deployment, etc.)
• No console errors or warnings
• All endpoints implemented (10/10)

Backend Status ✅

✅ Express.js REST API
✅ PostgreSQL database schema
✅ Error handling & validation
✅ Logging & monitoring
✅ Health check endpoint
✅ CORS configured
✅ Transaction safety
✅ Connection pooling
✅ Graceful shutdown
✅ Production-ready code

Frontend Status ✅

✅ Semantic HTML5
✅ Modern CSS (Grid, Flexbox)
✅ Zero JavaScript dependencies
✅ Responsive design (mobile, tablet, desktop)
✅ Drag-and-drop functionality
✅ API integration ready
✅ Error handling
✅ Toast notifications
✅ Loading states
✅ Lighthouse 95+ score

Database Status ✅

✅ Schema ready (schema.sql)
✅ 3 tables: users, projects, tasks
✅ All indexes defined
✅ Constraints & relationships
✅ Cascade delete rules
✅ Sample data seeder included
✅ Connection pool configured

---

Deployment Phases

Phase 1: Infrastructure Preparation (1 hour)

• Node.js Setup

  # Verify Node.js 18+
  node -v  # Should show v18+
  

• PostgreSQL Setup

  # Create database
  createdb tekdek_command_center
  
  # Create user with password
  createuser -P tekdek
  
  # Grant permissions
  psql << EOF
  GRANT ALL PRIVILEGES ON DATABASE tekdek_command_center TO tekdek;
  EOF
  

• Nginx Configuration

  • Copy nginx config from DEPLOYMENT_STRATEGY.md
  • Update server_name to actual domain
  • Verify syntax: nginx -t
  • Test reload: systemctl reload nginx

• SSL Certificates

  # Let's Encrypt for HTTPS
  certbot certonly --nginx -d command-center.tekdek.dev
  certbot certonly --nginx -d api.tekdek.dev
  

• Create Deployment Directory

  mkdir -p /opt/tekdek-command-center
  mkdir -p /var/www/tekdek-command-center
  mkdir -p /var/log/tekdek-command-center
  

Phase 2: Backend Deployment (30 minutes)

• Copy Application Code

  cd /opt/tekdek-command-center
  # Copy or git clone the command-center directory
  

• Install Dependencies

  npm install
  # Should complete with 0 vulnerabilities
  

• Configure Environment

  cp .env.example .env
  # Edit .env with actual credentials
  nano .env
  

  Required Values:

  • DATABASE_URL (PostgreSQL connection string)
  • PORT (typically 3000)
  • NODE_ENV=production
  • CORS_ORIGIN (frontend domain)
  • LOG_LEVEL=info

• Initialize Database

  npm run db:setup   # Create tables and indexes
  npm run db:seed    # Add initial users
  

  Verify:

  psql -U tekdek -d tekdek_command_center -c "SELECT COUNT(*) FROM users;"
  # Should show: 2
  

• Test API Locally

  npm start
  # Should show: "Server running on port 3000"
  

  In another terminal:

  curl http://localhost:3000/health
  # Should return: {"status":"ok","db":"connected",...}
  

• Stop Local Instance

  # Press Ctrl+C in npm start terminal
  

• Start with PM2 (Production)

  npm install -g pm2
  pm2 start src/index.js --name "tekdek-api" --env production
  pm2 startup
  pm2 save
  

  Verify:

  pm2 list
  pm2 logs tekdek-api
  

Phase 3: Frontend Deployment (15 minutes)

• Copy UI Files

  cd /var/www/tekdek-command-center
  # Copy all files from command-center/ui/
  cp /opt/tekdek-command-center/ui/* ./
  

  Verify Files:

  ls -la
  # Should show: index.html, styles.css, api.js, ui.js, app.js
  

• Configure API URL

  # Edit api.js to point to correct backend
  nano api.js
  
  # Change line 1 from:
  # const BASE_URL = 'http://localhost:3000/api/v1';
  # To:
  const BASE_URL = 'https://api.tekdek.dev/api/v1';
  

• Set Correct Permissions

  chmod 755 /var/www/tekdek-command-center
  chmod 644 /var/www/tekdek-command-center/*
  chown -R www-data:www-data /var/www/tekdek-command-center
  

• Test Nginx Configuration

  nginx -t
  # Should show: syntax is ok, test is successful
  

• Reload Nginx

  systemctl reload nginx
  systemctl status nginx
  

Phase 4: Verification (15 minutes)

Backend Verification

• Health Check

  curl https://api.tekdek.dev/health
  

  Expected response:

  {
    "status": "ok",
    "db": "connected",
    "uptime_ms": 12345,
    "timestamp": "2026-04-13T..."
  }
  

• Test All 10 API Endpoints

  1. Create Project

  curl -X POST https://api.tekdek.dev/api/v1/projects \
    -H "Content-Type: application/json" \
    -d '{
      "name": "Test Project",
      "description": "Deployment test",
      "color_hex": "#3498db"
    }'
  

  Expected: 201, project data with ID

  2. List Projects

  curl https://api.tekdek.dev/api/v1/projects
  

  Expected: 200, array of projects

  3. Get Project

  curl https://api.tekdek.dev/api/v1/projects/1
  

  Expected: 200, single project

  4. Update Project

  curl -X PUT https://api.tekdek.dev/api/v1/projects/1 \
    -H "Content-Type: application/json" \
    -d '{"name": "Updated Name"}'
  

  Expected: 200, updated project

  5. Create Task

  curl -X POST https://api.tekdek.dev/api/v1/projects/1/tasks \
    -H "Content-Type: application/json" \
    -d '{
      "title": "Test Task",
      "status": "backlog"
    }'
  

  Expected: 201, task with ID

  6. List Tasks

  curl https://api.tekdek.dev/api/v1/projects/1/tasks
  

  Expected: 200, array of tasks

  7. Get Task

  curl https://api.tekdek.dev/api/v1/projects/1/tasks/1
  

  Expected: 200, single task

  8. Update Task

  curl -X PUT https://api.tekdek.dev/api/v1/projects/1/tasks/1 \
    -H "Content-Type: application/json" \
    -d '{"status": "in_progress"}'
  

  Expected: 200, updated task

  9. Delete Task

  curl -X DELETE https://api.tekdek.dev/api/v1/projects/1/tasks/1
  

  Expected: 204, no content

  10. Delete Project

  curl -X DELETE https://api.tekdek.dev/api/v1/projects/1
  

  Expected: 204, no content

Frontend Verification

• Page Loads

  curl -s https://command-center.tekdek.dev | head -20
  # Should show HTML starting with <!DOCTYPE html>
  

• CSS Loads

  curl -s https://command-center.tekdek.dev/styles.css | head
  # Should show CSS rules
  

• JavaScript Loads

  curl -s https://command-center.tekdek.dev/ui.js | head
  # Should show JavaScript code
  

• API Client Configured

  curl -s https://command-center.tekdek.dev/api.js | grep BASE_URL
  # Should show correct API URL
  

• Manual Browser Test

  1. Open https://command-center.tekdek.dev
  2. Should see clean, responsive UI
  3. No console errors (F12 → Console)
  4. Create test project - should work
  5. Create test task - should work
  6. Drag task between columns - should work
  7. Update task - should work
  8. Delete task - should work

Integration Verification

• CORS Headers Correct

  curl -i -X OPTIONS https://api.tekdek.dev/api/v1/projects \
    -H "Origin: https://command-center.tekdek.dev"
  

  Expected: Headers include Access-Control-Allow-Origin: https://command-center.tekdek.dev

• End-to-End Workflow

  1. Create project via UI (POST /api/v1/projects)
  2. Create multiple tasks (POST /api/v1/projects/{id}/tasks)
  3. Drag task to different column (PUT /api/v1/projects/{id}/tasks/reorder)
  4. Edit task details (PUT /api/v1/projects/{id}/tasks/{taskId})
  5. Delete task (DELETE /api/v1/projects/{id}/tasks/{taskId})
  6. Delete project (DELETE /api/v1/projects/{id})
  7. Verify no errors in console or logs

Phase 5: Monitoring Setup (30 minutes)

• Configure Logging

  # Create log directory
  mkdir -p /var/log/tekdek-command-center
  chown -R nobody:nogroup /var/log/tekdek-command-center
  
  # View real-time logs
  tail -f /var/log/tekdek-command-center/api.log
  

• Setup Log Rotation

  cat > /etc/logrotate.d/tekdek-command-center << EOF
  /var/log/tekdek-command-center/*.log {
    daily
    rotate 14
    compress
    delaycompress
    missingok
    notifempty
    create 0640 nobody nogroup
  }
  EOF
  

• Database Backup Script

  mkdir -p /backups/tekdek
  cat > /usr/local/bin/backup-tekdek-db.sh << 'EOF'
  #!/bin/bash
  BACKUP_DIR="/backups/tekdek"
  pg_dump -U tekdek tekdek_command_center | \
    gzip > $BACKUP_DIR/db-$(date +%Y%m%d-%H%M%S).sql.gz
  find $BACKUP_DIR -mtime +30 -delete
  EOF
  chmod +x /usr/local/bin/backup-tekdek-db.sh
  

• Schedule Backup (Daily 2 AM)

  crontab -e
  # Add: 0 2 * * * /usr/local/bin/backup-tekdek-db.sh
  

• Monitor Process Health

  # Check PM2 process
  pm2 status
  
  # View logs
  pm2 logs tekdek-api
  
  # Setup monitoring
  pm2 monit
  

• Database Performance Monitoring

  # Connect to database
  sudo -u postgres psql -d tekdek_command_center
  
  # Check table sizes
  \dt+
  
  # Check indexes
  \di
  
  # Exit
  \q
  

Phase 6: Documentation (15 minutes)

• Create Deployment Record

  cat > /opt/tekdek-command-center/DEPLOYED.md << EOF
  # Deployment Record
  
  - Date: $(date)
  - Deployer: Hephaestus
  - Version: 1.0.0
  - Frontend URL: https://command-center.tekdek.dev
  - Backend URL: https://api.tekdek.dev
  - Database: tekdek_command_center
  - Status: ✅ LIVE
  EOF
  

• Update DNS/Load Balancer

  • Point command-center.tekdek.dev to UI server
  • Point api.tekdek.dev to API server

• Notify Team

  echo "✅ Command Center deployed successfully
  Frontend: https://command-center.tekdek.dev
  Backend: https://api.tekdek.dev
  All 10 endpoints verified working" | mail -s "Command Center Live" ops@tekdek.dev
  

• Update Status Pages

  • Mark Command Center as "Live" on status dashboard
  • Add to service catalog
  • Document runbook for ops team

---

Deployment Timeline

Phase	Task	Time	Total
1	Infrastructure Prep	1h	1h
2	Backend Deployment	30m	1.5h
3	Frontend Deployment	15m	1.75h
4	Verification	30m	2.25h
5	Monitoring	30m	2.75h
6	Documentation	15m	2.9h
Total			~3 hours

---

Rollback Plan

If critical issue found:

# 1. Stop services
pm2 stop tekdek-api
systemctl reload nginx

# 2. Revert to previous version
cd /opt/tekdek-command-center
git revert HEAD
npm install
pm2 restart tekdek-api

# 3. Restore database if corrupted
pg_restore < /backups/tekdek/db-YYYYMMDD.sql.gz

# 4. Notify team
echo "⚠️ Rolled back due to [REASON]" | mail ops@tekdek.dev

Time to rollback: ~10 minutes

---

Post-Deployment (First 24 Hours)

Every Hour

• Check PM2 process status: pm2 monit
• Review error logs: tail -20 /var/log/tekdek-command-center/api.log
• Test health check: curl https://api.tekdek.dev/health

Every 6 Hours

• Check disk space: df -h
• Check database connections: SELECT * FROM pg_stat_activity;
• Review Nginx access logs: tail -100 /var/log/nginx/access.log

End of Day 1

• Performance report (response times, error rates)
• User feedback review
• Database backup verification
• Final sign-off

---

Success Criteria

✅ All items below must be true for deployment to be considered successful:

• Backend API running and responding to requests
• Database connected and initialized with schema
• Frontend UI loads without errors
• All 10 API endpoints return correct responses
• Drag-and-drop functionality works end-to-end
• CORS properly configured (no browser errors)
• SSL certificates valid and enforced (HTTPS)
• Logging working (JSON format, file persisted)
• Database backups running and verified
• No console errors in browser or server logs
• Performance meets targets (<300ms endpoints)
• Team notified of successful deployment

---

Sign-Off

Deployment Prepared By: Hephaestus, Operations Engineer
Date: 2026-04-13
Status: READY FOR DEPLOYMENT ✅

Next Step: Execute deployment checklist phases in order. Estimate ~3 hours total.

---

Support Contacts

• Backend Issues: Talos (Technical Coder)
• Frontend Issues: Icarus (Frontend Designer)
• Architecture Questions: Daedalus (Chief Architect)
• Emergency On-Call: ops-oncall@tekdek.dev

---

All systems ready. Waiting for deployment authorization. 🚀