Environment Setup Checklist: E-Commerce Checkout System¶

Project: ShopFlow E-Commerce Platform - Checkout Module Enhancement
Version: 1.0
Prepared By: DevOps Team & QA Infrastructure
Date: 2024-01-22
Environment: QA Testing Environment
Status: Ready for Testing

Overview¶

This checklist provides comprehensive steps to set up and validate the QA test environment for the ShopFlow Checkout Module Enhancement project. The environment replicates production configuration to ensure accurate testing results.

Environment Purpose: System testing, integration testing, and UAT for checkout functionality

Target Completion: January 29, 2024

Table of Contents¶

1. Hardware Infrastructure
2. Software Installation
3. Application Deployment
4. Database Setup
5. Network Configuration
6. Third-Party Integrations
7. Test Data Preparation
8. Security Configuration
9. Monitoring and Logging
10. Test Tool Configuration
11. Environment Validation
12. Access and Credentials

1. Hardware Infrastructure¶

1.1 Application Servers¶

Configuration Details: - IP Addresses: - qa-app-01: 10.50.10.101 - qa-app-02: 10.50.10.102 - qa-lb-01: 10.50.10.100 (VIP: 10.50.10.200)

• Resource Allocation:
• CPU Allocation: Dedicated cores, no oversubscription
• Memory: Non-swappable, 4GB reserved for OS
• Storage: RAID 10 configuration

1.2 Database Servers¶

Configuration Details: - IP Addresses: - qa-db-01 (Primary): 10.50.10.111 - qa-db-02 (Replica): 10.50.10.112

• Replication:
• Type: Streaming replication (asynchronous)
• Lag Target: <5 seconds

1.3 Cache and Message Queue¶

1.4 Test Client Machines¶

2. Software Installation¶

2.1 Operating System and Base Software¶

2.2 Runtime Environments¶

Verification Commands:

node --version  # Expected: v18.19.0
npm --version   # Expected: 10.2.3
pm2 --version   # Expected: 5.3.0

2.3 Database Software¶

2.4 Cache and Message Queue Software¶

2.5 Web Browsers (Test Clients)¶

3. Application Deployment¶

3.1 Source Code and Build¶

Build Artifacts: - Frontend Build: /opt/shopflow/frontend/dist/ - Backend Build: /opt/shopflow/backend/build/ - Version File: /opt/shopflow/VERSION (contains: 3.5.0-RC1)

3.2 Application Configuration¶

Key Configuration Parameters:

Backend Config (qa.json):

{
  "env": "qa",
  "port": 3000,
  "database": {
    "host": "10.50.10.111",
    "port": 5432,
    "database": "shopflow_qa",
    "pool": {"min": 5, "max": 20}
  },
  "redis": {
    "host": "10.50.10.121",
    "port": 6379,
    "ttl": 3600
  },
  "session": {
    "secret": "[REDACTED]",
    "timeout": 900000
  },
  "payment": {
    "paypal_mode": "sandbox",
    "stripe_mode": "test"
  }
}

Frontend Config (.env.qa):

REACT_APP_API_URL=https://qa-api.shopflow.example.com
REACT_APP_ENV=qa
REACT_APP_GOOGLE_PAY_MERCHANT_ID=[TEST_MERCHANT_ID]
REACT_APP_APPLE_PAY_MERCHANT_ID=[TEST_MERCHANT_ID]

3.3 Application Services¶

Service Management:

# Check service status
pm2 status
pm2 logs shopflow-api
pm2 logs shopflow-workers

# Service restart
pm2 restart shopflow-api
pm2 restart shopflow-workers

4. Database Setup¶

4.1 Database Creation and Schema¶

Database Connection Details: - Host: qa-db-01.internal (10.50.10.111) - Port: 5432 - Database: shopflow_qa - Application User: shopflow_app - Read-Only User: shopflow_readonly - Schema Version: 3.5.0 (verified via schema_version table)

4.2 Database Configuration¶

4.3 Database Replication¶

Replication Verification:

-- On Primary
SELECT client_addr, state, sync_state, replay_lag 
FROM pg_stat_replication;

-- Expected: Replica IP, streaming, async, <5 seconds

5. Network Configuration¶

5.1 Load Balancer Setup¶

Load Balancer Configuration: - Frontend: https://qa.shopflow.example.com (10.50.10.200:443) - Backend Pool: - qa-app-01:3000 (Active) - qa-app-02:3000 (Active) - Algorithm: Least connections with sticky sessions - Health Check: GET /health every 5s, 2 failures trigger removal

5.2 DNS Configuration¶

DNS Verification:

nslookup qa.shopflow.example.com
# Expected: 10.50.10.200

curl -I https://qa.shopflow.example.com
# Expected: HTTP/2 200

5.3 Firewall Rules¶

6. Third-Party Integrations¶

6.1 Payment Gateway - PayPal¶

PayPal Configuration: - Environment: Sandbox - API Endpoint: https://api.sandbox.paypal.com - Client ID: [Stored in secrets vault] - Test Accounts: - Buyer: testbuyer@paypal.com / test1234 - Seller: sandbox-shopflow@paypal.com

6.2 Payment Gateway - Apple Pay¶

Apple Pay Configuration: - Merchant ID: merchant.com.shopflow.qa - Verified Domains: qa.shopflow.example.com - Test Environment: Sandbox - Supported Networks: Visa, Mastercard, Amex

6.3 Payment Gateway - Google Pay¶

Google Pay Configuration: - Environment: TEST - Merchant ID: 12345678901234567890 - Gateway: stripe (test mode) - Allowed Card Networks: MASTERCARD, VISA, AMEX

6.4 Shipping Carriers¶

Shipping API Configuration: - FedEx: - Environment: Test - API Endpoint: https://wsbeta.fedex.com - Account: [Test Account] - Meter: [Test Meter]

• UPS:
• Environment: Test
• API Endpoint: https://wwwcie.ups.com
• Access Key: [Test Key]

• Account: [Test Account]

• USPS:

• Environment: Test
• API Endpoint: https://stg-secure.shippingapis.com
• User ID: [Test User]

6.5 Email Service¶

Email Configuration: - SMTP Host: qa-mail-01.internal (10.50.10.130) - SMTP Port: 1025 - Authentication: None (test environment) - Web Interface: http://10.50.10.130:8025 - From Address: noreply@shopflow.example.com

7. Test Data Preparation¶

7.1 User Accounts¶

Sample Test Accounts: - Regular User: testuser001@example.com / TestPass123! - Premium User: premium001@example.com / TestPass123! - Admin User: admin.qa@shopflow.example.com / AdminQA2024!

Test Data Files: - /test-data/user-accounts.csv - 500 user credentials - /test-data/guest-emails.txt - 100 guest email addresses

7.2 Product Catalog¶

Product Categories: - Electronics (40 products) - Clothing (35 products) - Home & Garden (30 products) - Sports & Outdoors (25 products) - Books & Media (20 products)

Price Ranges: - Low: $5.99 - $29.99 (50 products) - Medium: $30.00 - $99.99 (60 products) - High: $100.00 - $999.99 (40 products)

7.3 Promotional Codes¶

Promo Code File: /test-data/promo-codes.xlsx

7.4 Address Data¶

Address File: /test-data/addresses.json

7.5 Payment Test Data¶

Test Credit Cards (from payment gateway): - Visa: 4111 1111 1111 1111 (CVV: any 3 digits, any future date) - Mastercard: 5555 5555 5555 4444 (CVV: any 3 digits, any future date) - Amex: 3782 822463 10005 (CVV: any 4 digits, any future date) - Declined: 4000 0000 0000 0002 - Insufficient Funds: 4000 0000 0000 9995

8. Security Configuration¶

8.1 SSL/TLS Certificates¶

SSL Configuration: - TLS Version: TLS 1.2, TLS 1.3 - Cipher Suites: Strong ciphers only (A+ rating target) - HSTS: Enabled - Certificate Type: DigiCert Test Certificate

8.2 Security Hardening¶

8.3 Access Controls¶

9. Monitoring and Logging¶

9.1 Application Monitoring¶

Monitored Metrics: - CPU usage (per server) - Memory usage (per server) - Disk I/O - Network traffic - API response times - Error rates - Active sessions - Database connections

9.2 Logging Configuration¶

Log Management: - Format: JSON (structured logging) - Level: INFO (can be changed to DEBUG) - Rotation: Daily, compressed after 7 days - Centralized: All logs shipped to ELK stack

9.3 Database Monitoring¶

10. Test Tool Configuration¶

10.1 Test Management Tools¶

TestRail Configuration: - Project: ShopFlow Checkout Enhancement v3.5 - Test Suites: Imported and organized - Integrations: Jira integration configured - Users: All QA team members added with appropriate roles

10.2 Automation Tools¶

Automation Framework: - Location: /opt/shopflow-automation/ - Framework: Page Object Model (POM) - CI Integration: Jenkins configured - Test Reports: Allure reports configured

10.3 API Testing Tools¶

API Documentation: - Swagger URL: https://qa-api.shopflow.example.com/api-docs - Postman Collections: Imported and organized - Environment: QA environment variables configured

10.4 Performance Testing Tools¶

Load Testing Configuration: - Test Plans: 5 scenarios prepared - Load Generators: 3 VMs (qa-load-01, 02, 03) - Capacity: Up to 5,000 concurrent users

10.5 Security Testing Tools¶

11. Environment Validation¶

11.1 Smoke Tests¶

11.2 Integration Tests¶

11.3 Performance Baseline¶

12. Access and Credentials¶

12.1 Environment URLs¶

12.2 Test Accounts¶

Note: All passwords should be obtained from the shared password manager (LastPass Enterprise). The following are account usernames only.

12.3 Server Access¶

SSH Access: Key-based authentication only

VPN Required: All SSH access requires connection to QA VPN (OpenVPN)

12.4 Database Access¶

Database Tools: - pgAdmin 4: Installed on QA workstations - psql CLI: Available on all database servers

13. Sign-Off¶

13.1 Environment Readiness Confirmation¶

13.2 Overall Environment Status¶

Status: ✅ READY FOR TESTING

Environment Readiness Date: January 23, 2024
Testing Start Date: January 29, 2024

Final Approval:

14. Known Issues and Limitations¶

14.1 Known Issues¶

14.2 Environment Limitations¶

1. Performance: QA environment has 50% capacity of production
2. Data Volume: Test data set smaller than production
3. Geographic Distribution: Single data center (production is multi-region)
4. External Services: Test/sandbox modes only
5. Email: Test SMTP server (no actual email delivery to external addresses)

15. Support and Escalation¶

15.1 Environment Support Contacts¶

15.2 Escalation Path¶

1. Level 1: Team Lead (immediate)
2. Level 2: Department Manager (within 1 hour)
3. Level 3: Director (critical issues, within 2 hours)

Document End

Last Updated: January 23, 2024
Next Review: As needed during testing phase or upon environment changes