Flex Credits Test Plan

Overview

This test plan outlines the testing strategy for the Flex Credits system implementation.

Test Environments

• Development: Local environment

• Staging: Pre-production environment

• Production: Live environment

Test Categories

1. Database Tests

• Verify flex_credits column added correctly

• Verify is_flex boolean column added correctly

• Test cascade delete functionality

• Verify paypal_orders table structure

• Test database triggers and functions

2. Credit Management Tests

• Test credit balance calculation

• Verify flex credits are added correctly after purchase

• Test credit deduction for project creation

• Verify subscription credits are used before flex credits

• Test credit balance display in UI

• Verify credit history tracking

3. Purchase Flow Tests

• Test each flex credits package purchase

• Verify PayPal payment process

• Test success URL handling

• Test cancel URL handling

• Verify order record creation

• Test webhook handling

• Verify purchase history display

4. Subscription Integration Tests

• Test coexistence with subscription credits

• Verify subscription status handling

• Test upgrade flow from free to flex

• Test upgrade flow from flex to subscription

• Verify subscription management UI changes

5. UI/UX Tests

• Test responsive design

• Verify loading states

• Test error messages

• Verify success messages

• Test navigation flows

• Verify accessibility compliance

6. Edge Cases

• Test with zero credits

• Test with large credit amounts

• Test concurrent purchases

• Test network failures

• Test partial payment completion

• Test webhook retries

7. Landing Page Integration Tests

• Test PayPal button integration

• Verify pricing display

• Test success/cancel redirects

• Verify tracking parameters

• Test mobile responsiveness

Test Data Requirements

1. Test PayPal accounts:

   • Sandbox buyer: [e-mail] / testuser123

   • Sandbox seller: [e-mail] / merchant123

2. Test Credit Packages:

   • 100 credits ($99)

   • 165 credits ($149)

   • 205 credits ($199)

   • 410 credits ($399)

Test Scenarios

Purchase Flow

1. New user purchases flex credits

   Given: A new user without any credits
   When: They purchase the 100 credits package
   Then: Their balance should show 100 credits
   And: A purchase record should be created
   And: They should receive a success message

2. Existing subscription user adds flex credits

   Given: A user with an active subscription
   When: They purchase flex credits
   Then: Both subscription and flex credits should show
   And: Subscription credits should be used first

Error Handling

1. Failed payment

   Given: A user attempting to purchase credits
   When: The PayPal payment fails
   Then: No credits should be added
   And: User should see error message
   And: Order status should be updated

2. Network issues

   Given: A user completing a purchase
   When: Network connection is lost
   Then: System should handle gracefully
   And: Order status should be accurate

Test Execution

Prerequisites

1. Clean test database

2. PayPal sandbox credentials

3. Test user accounts

4. Access to all environments

Test Flow

1. Run database migration tests

2. Execute unit tests

3. Perform integration tests

4. Run end-to-end tests

5. Conduct user acceptance testing

Success Criteria

• All test cases pass

• No critical or high-priority bugs

• Performance metrics within acceptable range

• User feedback positive

Bug Reporting

Report bugs with:

1. Environment details

2. Steps to reproduce

3. Expected vs actual results

4. Screenshots/logs

5. Severity level

Test Schedule

1. Database testing: Day 1

2. Backend testing: Days 2-3

3. Frontend testing: Days 4-5

4. Integration testing: Days 6-7

5. UAT: Days 8-9

6. Bug fixes and regression: Day 10

Sign-off Criteria

• All critical and high-priority tests pass

• No blocking bugs

• Documentation complete

• Performance requirements met

• Security requirements met