Testing Approach

​

Testing Philosophy

​

Browser Testing

​

Supported Browsers

​

Browser-Specific Testing

​

PWA Testing

​

Service Worker Validation

​

Installation Test

1. Open the app in a supported browser
2. Check DevTools > Application > Service Workers
3. Verify status shows “activated and running”
4. Check registration scope is /

// Expected in console
Service Worker registrado com sucesso

​

Cache Test

1. Load the app with network enabled
2. Open DevTools > Application > Cache Storage
3. Verify cache named estudo-organizado-v1 exists
4. Check that all static assets are cached:
   • /src/index.html
   • /src/css/*.css
   • /src/js/*.js
   • Icons and manifest

​

Offline Mode Test

1. Load the app normally
2. Open DevTools > Network tab
3. Enable offline mode (throttling dropdown)
4. Refresh the page
5. Verify:
   • Page loads successfully
   • All features work (reading data)
   • UI shows offline indicator if implemented

​

PWA Installation Test

​

Desktop Installation

1. Open the app in Chrome/Edge
2. Look for install icon in address bar
3. Click install
4. Verify:
   • App opens in standalone window
   • No browser chrome visible
   • Correct app name and icon

​

Mobile Installation (iOS)

1. Open in Safari on iPhone/iPad
2. Tap Share button
3. Select “Add to Home Screen”
4. Verify:
   • App appears on home screen
   • Correct icon and name
   • Opens in fullscreen
   • No Safari UI

​

Mobile Installation (Android)

1. Open in Chrome on Android
2. Tap “Add to Home Screen” prompt
3. Verify:
   • Install banner appears
   • App installs successfully
   • Opens in standalone mode

​

Manifest Validation

1. Open DevTools > Application > Manifest
2. Check all fields:
   • Name: “Estudo Organizado”
   • Icons: Multiple sizes present
   • Theme color matches app
   • Display: “standalone”
   • Start URL: ”/“

​

Feature Testing

​

State Management Testing

​

IndexedDB Persistence

1. Create test data:
   • Add an edital
   • Create a study event
   • Set up a review
2. Close the browser completely
3. Reopen the app
4. Verify:
   • All data persists
   • No data loss
   • No corruption

​

LocalStorage Migration

1. Manually add old data to localStorage:
   localStorage.setItem('estudo_state', JSON.stringify({
     editais: [{ nome: 'Test' }]
   }));
   
2. Refresh the page
3. Verify:
   • Data migrates to IndexedDB
   • localStorage key is removed
   • Data appears in app

​

Timer Testing

​

Free Timer Test

1. Start free timer (cronômetro livre)
2. Let it run for 30+ seconds
3. Test scenarios:
   • Pause and resume
   • Navigate to other tabs
   • Return to timer tab
   • Refresh page (should reset)
   • Close tab and reopen (should reset)

​

Event Timer Test

1. Create study event
2. Start event timer
3. Test scenarios:
   • Pause and resume
   • Switch between events
   • Navigate to other modules
   • Refresh page (should reset per session logic)
   • Multiple timers (should only one run)

​

Expected Timer Behavior

// BUG 3: Prevenir persistência inflada de timer ao fechar a aba
const isSameSession = sessionStorage.getItem('estudo_session_active');
if (!isSameSession) {
  if (loadedState.cronoLivre && loadedState.cronoLivre._timerStart) {
    loadedState.cronoLivre._timerStart = null;
  }
}

​

Sync Testing

​

Cloudflare Sync

1. Configure Cloudflare Worker (see setup docs)
2. Enable sync in Configurações
3. Make changes (add event, modify edital)
4. Wait for debounce (2 seconds)
5. Check DevTools Console:
   • Look for sync success messages
   • Verify no errors
6. Open on different device
7. Verify data synced

​

Google Drive Backup

1. Connect Google Drive in settings
2. Trigger backup
3. Check Google Drive:
   • File created/updated
   • Contains valid JSON
4. Restore from backup
5. Verify data integrity

​

Migration Testing

​

Test Each Migration Path

1. Create mock data at old schema version:
   const oldState = {
     schemaVersion: 6,
     editais: [/* old format */]
   };
   
2. Manually set in IndexedDB
3. Reload app
4. Verify:
   • Migration runs
   • Schema version updates
   • Data transforms correctly
   • No data loss

​

Module-Specific Testing

​

Study Organizer Module

• Create study events
• Start/pause/stop timers
• Mark events as complete
• Verify time tracking accuracy
• Test Pomodoro integration

​

Calendar Module

• Switch between month/week views
• Create events on specific dates
• Drag and drop events (if applicable)
• Navigate between months
• Test first day of week setting

​

Dashboard Module

• Verify metrics accuracy:
  • Total study time
  • Sessions count
  • Questions completed
  • Simulated exams
• Test date range filters
• Check chart rendering

​

Review System

• Create reviews
• Test spaced repetition intervals (1, 7, 30, 90 days)
• Mark reviews as complete
• Verify next review date calculation
• Test custom intervals

​

Habits Tracking

• Track different habit types:
  • Questões (questions)
  • Revisão (review)
  • Videoaula (video lessons)
  • Simulado (simulated exams)
• Verify data persists
• Check habit streaks

​

Exam Analysis (Inteligência de Banca)

• Add exam topics
• Run relevance analysis
• Test NLP/fuzzy matching
• Save analysis reports
• Load saved analyses
• Edit scores
• Delete analyses

​

Performance Testing

​

Load Testing

1. Create large datasets:
   • 100+ events
   • 10+ editais with many subjects
   • 50+ reviews
2. Test performance:
   • Calendar rendering
   • Dashboard calculations
   • Search/filter operations
3. Check for:
   • UI lag
   • Memory leaks (DevTools Memory tab)
   • Slow database queries

​

Debounce Verification

export function scheduleSave() {
  if (saveTimeout) clearTimeout(saveTimeout);
  
  saveTimeout = setTimeout(() => {
    saveStateToDB();
  }, 2000); // 2 second debounce
}

​

Testing Checklist

​

Core Functionality

• ✅ App loads without errors
• ✅ IndexedDB initializes correctly
• ✅ Service Worker registers
• ✅ Data persists across sessions
• ✅ All modules render correctly

​

Cross-Browser

• ✅ Chrome works
• ✅ Firefox works
• ✅ Safari works (if possible)
• ✅ Edge works

​

PWA Features

• ✅ Installable on desktop
• ✅ Installable on mobile
• ✅ Works offline
• ✅ Caches correctly
• ✅ Updates properly

​

State Management

• ✅ Data saves correctly
• ✅ Data loads correctly
• ✅ Migrations work
• ✅ No data loss

​

Timers

• ✅ Start/pause/stop work
• ✅ Time accumulates correctly
• ✅ Reset on session end
• ✅ No inflation bugs

​

Sync (if applicable)

• ✅ Cloudflare sync works
• ✅ Google Drive backup works
• ✅ No sync conflicts

​

Performance

• ✅ No memory leaks
• ✅ Fast rendering
• ✅ Debounce working
• ✅ Smooth interactions

​

Reporting Test Results

## Testing Performed

### Browsers Tested
- ✅ Chrome 120 (Windows 11)
- ✅ Firefox 119 (Windows 11)
- ✅ Safari 17 (macOS Sonoma)

### Features Tested
- ✅ Timer functionality (free and event timers)
- ✅ Data persistence (IndexedDB)
- ✅ Offline mode
- ✅ Calendar rendering
- ✅ Review system

### Scenarios Tested
1. Created 50 test events
2. Tested timer pause/resume 20+ times
3. Refreshed page 10+ times
4. Tested offline mode for 5 minutes
5. Verified data persists after browser restart

### Issues Found
None / [List any issues]

​

Common Issues to Watch For

​

Timer Inflation

• Timers continuing to run after page close
• Accumulated time showing incorrect values
• Multiple timers running simultaneously

​

Data Loss

• IndexedDB not initializing
• Migration failures
• Sync conflicts
• LocalStorage not migrating

​

PWA Issues

• Service Worker not registering
• Cache not updating
• Offline mode not working
• Install prompt not showing

​

Performance

• Slow calendar rendering with many events
• Memory leaks from event listeners
• Excessive database writes
• Missing debounce causing too many saves