Skip to content

Latest commit

 

History

History
515 lines (410 loc) · 12.4 KB

TESTING_GUIDE.md

File metadata and controls

515 lines (410 loc) · 12.4 KB

MySeedBook Catalogue - Testing Guide

📋 Table of Contents

📖 Overview

This document provides comprehensive testing procedures for MySeedBook Catalogue, a React Native/Expo app for managing gardening seeds and suppliers. The app uses Supabase for backend services and supports web, iOS, and Android platforms.

Current Version: Production Ready (August 2025)
Testing Framework: Jest (configured)
Platforms: Web, iOS, Android
Backend: Supabase
Status: ✅ Core functionality tested and working

✅ Recently Completed Testing (August 2025):

  • Calendar event creation with user ID association
  • Android orientation handling and responsive design
  • Image URL handling for seed suppliers (RareSeeds, Burpee)
  • Authentication flows and security cleanup
  • Production security scanning

🛠 Test Environment Setup

Prerequisites

  • Node.js installed
  • Expo CLI installed (npm install -g @expo/eas-cli)
  • Android Studio (for Android testing)
  • Xcode (for iOS testing, macOS only)
  • Test devices or simulators

Environment Configuration

# Install dependencies
npm install

# Start development server
npm start

# Run on specific platforms
npm run android  # Android
npm run ios      # iOS

Test Data Setup

  • Create test Supabase account
  • Set up test database with sample data
  • Configure test environment variables
  • Prepare test images for photo uploads

✅ Manual Testing Checklist

🚀 App Launch & Initialization

  • App launches without crashes
  • Splash screen displays correctly
  • Theme loads (light/dark mode)
  • Navigation structure initializes
  • Authentication state is checked

🔐 Authentication Flow

  • Login screen displays correctly
  • Login with valid credentials works
  • Login with invalid credentials shows error
  • Signup process works
  • Password reset functionality
  • Logout functionality
  • Session persistence across app restarts
  • Auth bypass flags work in development

🏠 Navigation & Layout

  • Tab navigation works smoothly
  • Back button navigation (Android)
  • Deep linking works
  • Status bar styling is correct
  • Safe area handling on all devices
  • Gesture navigation compatibility

🧪 Feature Testing

📦 Seed Management (Inventory Screen)

Viewing Seeds

  • Seed list loads correctly
  • Seed images display properly
  • Seed details are accurate
  • Search functionality works
  • Filter functionality works
  • Pull-to-refresh works
  • Empty state displays when no seeds
  • Loading states display correctly

Adding Seeds

  • "Add Seed" button navigates correctly
  • All form fields accept input
  • Required field validation works
  • Image upload functionality
  • Multiple image handling
  • Supplier selection works
  • Date picker functionality
  • Form submission works
  • Success message displays
  • Navigation back to inventory

Editing Seeds

  • Edit seed navigation works
  • Form pre-fills with existing data
  • Changes save correctly
  • Image updates work
  • Supplier changes work
  • Date changes work
  • Validation on edit works

Deleting Seeds

  • Delete confirmation dialog
  • Soft delete functionality
  • Seed removed from list
  • Associated calendar events handled
  • Undo functionality (if implemented)

🏪 Supplier Management

Viewing Suppliers

  • Supplier list loads
  • Supplier details display
  • Contact information shows
  • Associated seeds count
  • Search suppliers works
  • Empty state handling

Adding Suppliers

  • Add supplier form works
  • Required field validation
  • Contact info validation (email, phone)
  • Website URL validation
  • Form submission works
  • Success feedback
  • Navigation back to supplier list

Editing Suppliers

  • Edit form pre-fills data
  • Changes save correctly
  • Validation works on edit
  • Associated seeds update

Deleting Suppliers

  • Delete confirmation
  • Soft delete functionality
  • Associated seeds handling
  • Supplier removed from lists

📅 Calendar Functionality

Calendar Display

  • Monthly calendar view loads
  • Navigation between months
  • Events display on correct dates
  • Different event types show correctly
  • Date selection works
  • Double-tap for event creation

Event Management

  • Add event modal opens
  • Event form validation
  • Date picker works
  • Event categories work
  • Seed selection works
  • Event creation works
  • Event deletion works
  • Event editing (if implemented)

Calendar Integration

  • Purchase dates auto-add to calendar
  • Sowing events create germination/harvest events
  • Days to germinate/harvest calculations
  • Calendar events sync with seed data

📸 Image Handling

Photo Capture

  • Camera permission requests
  • Camera opens correctly
  • Photo capture works
  • Photo preview displays
  • Photo saves to seed/supplier

Photo Library

  • Gallery access permission
  • Photo selection works
  • Multiple photo selection
  • Photo preview displays
  • Photo upload works

Image Display

  • Images load correctly
  • Image fallbacks work
  • Image resizing/optimization
  • Image caching works
  • Image error handling

📱 Platform Testing

🌐 Web Platform

  • Responsive design works
  • Touch/click interactions
  • Keyboard navigation
  • Browser compatibility (Chrome, Firefox, Safari)
  • Web-specific features work
  • File upload works
  • Date pickers work
  • Hover states work

🤖 Android Platform

  • Material Design compliance
  • Back button behavior
  • Android permissions
  • Keyboard handling
  • Hardware back button
  • Deep linking
  • App icon displays
  • Notification handling (if implemented)

🍎 iOS Platform

  • iOS design guidelines compliance
  • iOS permissions
  • Safe area handling
  • iOS-specific gestures
  • App icon displays
  • iOS keyboard handling
  • Deep linking
  • Notification handling (if implemented)

👤 User Experience Testing

🎨 Theme System

  • Light theme displays correctly
  • Dark theme displays correctly
  • Theme switching works smoothly
  • Theme persistence across sessions
  • All screens support both themes
  • Theme affects all UI elements

♿ Accessibility

  • Screen reader compatibility
  • High contrast mode support
  • Font scaling support
  • Touch target sizes adequate
  • Color contrast ratios meet standards
  • Focus indicators visible

🔄 Loading States

  • Loading spinners display
  • Skeleton screens (if implemented)
  • Progress indicators
  • Loading timeouts handled
  • Offline state handling

📱 Responsive Design

  • Portrait orientation works
  • Landscape orientation works
  • Different screen sizes supported
  • Tablet layouts (if implemented)
  • Content scaling works

🗄 Data Integrity Testing

💾 Data Persistence

  • Data saves correctly to Supabase
  • Data retrieval works
  • Data updates work
  • Data deletion works (soft delete)
  • Offline data handling (if implemented)

🔄 Data Synchronization

  • Real-time updates work
  • Data consistency across devices
  • Conflict resolution (if implemented)
  • Data backup/restore (if implemented)

🔗 Relationships

  • Seed-supplier relationships work
  • Calendar-seed relationships work
  • Foreign key constraints respected
  • Cascade deletes work correctly

⚡ Performance Testing

🚀 App Performance

  • App startup time acceptable
  • Screen transition smoothness
  • List scrolling performance
  • Image loading performance
  • Memory usage reasonable
  • Battery usage acceptable

📊 Data Performance

  • Database query performance
  • Large dataset handling
  • Image upload speed
  • Search performance
  • Filter performance

📱 Device Performance

  • Performance on older devices
  • Performance with low memory
  • Performance with slow network
  • Performance with large datasets

🛡 Security Testing

🔐 Authentication Security

  • Secure password requirements
  • Session management secure
  • Token expiration handling
  • Unauthorized access prevention
  • SQL injection prevention

🔒 Data Security

  • User data isolation (RLS)
  • Sensitive data encryption
  • Secure API communication
  • File upload security
  • Input sanitization

📝 Test Scenarios

Scenario 1: New User Onboarding

  1. Download and install app
  2. Create new account
  3. Add first supplier
  4. Add first seed with photo
  5. View seed in inventory
  6. Add calendar event
  7. Switch to dark theme

Expected Result: Smooth onboarding experience

Scenario 2: Existing User Daily Usage

  1. Launch app (auto-login)
  2. Check calendar for today's events
  3. Add new seed purchase
  4. Search for specific seed
  5. Edit seed details
  6. Add supplier note
  7. Plan planting event

Expected Result: Efficient daily workflow

Scenario 3: Data Management

  1. Import bulk seed data (if implemented)
  2. Edit multiple seeds
  3. Delete old seeds
  4. Update supplier information
  5. Export data (if implemented)
  6. Restore deleted item

Expected Result: Robust data management

Scenario 4: Offline Usage

  1. Use app without internet
  2. Add new seeds offline
  3. Take photos offline
  4. Reconnect to internet
  5. Sync data

Expected Result: Seamless offline/online experience

Scenario 5: Cross-Platform Usage

  1. Use app on phone
  2. Switch to tablet/web
  3. Verify data sync
  4. Make changes on web
  5. View changes on phone

Expected Result: Perfect synchronization

🐛 Bug Reporting Template

Bug Report Format

**Title**: [Brief description of the bug]

**Priority**: Critical/High/Medium/Low

**Platform**: Web/iOS/Android/All

**Device**: [Device model and OS version]

**Steps to Reproduce**:
1. Step one
2. Step two
3. Step three

**Expected Behavior**:
[What should happen]

**Actual Behavior**:
[What actually happens]

**Screenshots/Videos**:
[Attach media if applicable]

**Additional Information**:
- App version: 
- User account type:
- Network condition:
- Other relevant details

**Workaround** (if any):
[Temporary solution]

Bug Priority Levels

  • Critical: App crashes, data loss, security issues
  • High: Major feature broken, blocks user workflow
  • Medium: Minor feature issues, UI problems
  • Low: Cosmetic issues, enhancement requests

🎯 Testing Schedule

Pre-Release Testing

  • Complete feature testing
  • Platform compatibility testing
  • Performance testing
  • Security testing
  • User acceptance testing

Regular Testing

  • Weekly smoke tests
  • Monthly regression tests
  • Quarterly full test suite
  • Performance benchmarks

Release Testing

  • Release candidate testing
  • Final verification
  • Store compliance testing
  • Distribution testing

📊 Test Coverage Goals

  • Core Features: 100% tested
  • Platform Compatibility: 95% tested
  • User Scenarios: 90% covered
  • Edge Cases: 80% covered
  • Performance: Benchmarked
  • Security: Fully audited

🔧 Testing Tools

Manual Testing Tools

  • Device simulators/emulators
  • Real devices for testing
  • Network condition simulators
  • Accessibility testing tools

Automated Testing (Future)

  • Jest for unit testing
  • React Native Testing Library
  • Detox for E2E testing
  • Performance monitoring tools

📞 Support & Issues

For testing support or to report issues:

  • Create GitHub issues for bugs
  • Use project management tools for tracking
  • Document test results systematically
  • Regular team testing sessions

Last Updated: August 4, 2025
Version: 1.0