docs: Correct test file names and counts to reflect actual implementation

- Update total test count: 581 → 535 tests (532 passed, 3 skipped)
- Correct Task 1: test_security_middleware.py (48 tests)
- Correct Task 3: test_database_service.py (20 tests)
- Correct Task 6: test_page_controller.py (37 tests)
- Correct Task 7: test_background_loader_service.py (46 tests)
- Update Task 2: 50 tests (not 51)
- Update Task 4: 46 tests (not 48)
- Update Task 5: 73 tests (not 59)
- Update Phase 1 total: 118 tests (not 164)
- Update unit tests count: 494 tests (not 540)
- Update git commit count: 16 commits

Files updated:
- TESTING_SUMMARY.md
- docs/instructions.md
- README.md

All tests verified passing with pytest run

README.md

@@ -131,7 +131,7 @@ See [docs/CONFIGURATION.md](docs/CONFIGURATION.md) for all options.
 
 ## Running Tests
 
-The project includes a comprehensive test suite with **581 tests** and **91.24% average coverage**:
+The project includes a comprehensive test suite with **535 tests** and **91.24% average coverage**:
 
 ```bash
 # Run all tests
@@ -148,9 +148,10 @@ conda run -n AniWorld python -m pytest tests/ --cov --cov-report=html
 ```
 
 **Test Coverage:**
-- ✅ 581 tests across 11 test suites
+
+- ✅ 535 tests across 11 test suites (532 passed, 3 skipped)
 - ✅ 91.24% average code coverage
-- ✅ Unit tests: Security, Notifications, Database, NFO, Cache, Error Tracking, Settings
+- ✅ Unit tests: Security Middleware, Notifications, Database, NFO, Cache, Error Tracking, Settings
 - ✅ Integration tests: End-to-end workflows, API endpoints, Download flows
 
 See [TESTING_SUMMARY.md](TESTING_SUMMARY.md) for detailed testing documentation.

TESTING_SUMMARY.md

@@ -8,10 +8,10 @@
 
 ## 📊 Executive Summary
 
-- **Total Tests**: 581 tests across 11 files
+- **Total Tests**: 535 tests across 11 files
 - **Average Coverage**: 91.24%
-- **Success Rate**: 100% (all tests passing)
+- **Success Rate**: 100% (532 passed, 3 skipped)
-- **Git Commits**: 14 commits documenting all work
+- **Git Commits**: 16 commits documenting all work
 - **Time Investment**: Comprehensive test coverage achieved
 
 ---
@@ -23,19 +23,19 @@ Target: 90%+ coverage
 
 | Task | File | Tests | Coverage | Status |
 |------|------|-------|----------|--------|
-| Task 1 | Security Service | 54 | 92.86% | ✅ |
+| Task 1 | test_security_middleware.py | 48 | 92.86% | ✅ |
-| Task 2 | Notification Service | 51 | 93.98% | ✅ |
+| Task 2 | test_notification_service.py | 50 | 93.98% | ✅ |
-| Task 3 | Database Connection | 59 | 88.78% | ✅ |
+| Task 3 | test_database_service.py | 20 | 88.78% | ✅ |
-| **Phase 1 Total** | | **164** | **91.88%** | ✅ |
+| **Phase 1 Total** | | **118** | **91.88%** | ✅ |
 
 ### Phase 2: Core Features (P1)
 Target: 85%+ coverage
 
 | Task | File | Tests | Coverage | Status |
 |------|------|-------|----------|--------|
-| Task 4 | Initialization Service | 48 | 96.96% | ✅ |
+| Task 4 | test_initialization_service.py | 46 | 96.96% | ✅ |
-| Task 5 | NFO Service | 59 | 96.97% | ✅ |
+| Task 5 | test_nfo_service.py | 73 | 96.97% | ✅ |
-| Task 6 | Pages Service | 49 | 95.00% | ✅ |
+| Task 6 | test_page_controller.py | 37 | 95.00% | ✅ |
 | **Phase 2 Total** | | **156** | **96.31%** | ✅ |
 
 ### Phase 3: Performance & Optimization (P2)
@@ -43,8 +43,8 @@ Target: 80%+ coverage
 
 | Task | File | Tests | Coverage | Status |
 |------|------|-------|----------|--------|
-| Task 7 | Background Loader | 46 | 82.00% | ✅ |
+| Task 7 | test_background_loader_service.py | 46 | 82.00% | ✅ |
-| Task 8 | Cache Service | 66 | 80.06% | ✅ |
+| Task 8 | test_cache_service.py | 66 | 80.06% | ✅ |
 | **Phase 3 Total** | | **112** | **81.03%** | ✅ |
 
 ### Phase 4: Observability & Monitoring (P3)
@@ -52,8 +52,8 @@ Target: 80-85%+ coverage
 
 | Task | File | Tests | Coverage | Status |
 |------|------|-------|----------|--------|
-| Task 9 | Error Tracking | 39 | 100.00% | ✅ |
+| Task 9 | test_error_tracking.py | 39 | 100.00% | ✅ |
-| Task 10 | Settings Validation | 69 | 100.00% | ✅ |
+| Task 10 | test_settings_validation.py | 69 | 100.00% | ✅ |
 | **Phase 4 Total** | | **108** | **100.00%** | ✅ |
 
 ### Phase 5: End-to-End Workflows (P1)
@@ -61,7 +61,7 @@ Target: 75%+ coverage
 
 | Task | File | Tests | Coverage | Status |
 |------|------|-------|----------|--------|
-| Task 11 | E2E Workflows | 41 | 77.00% | ✅ |
+| Task 11 | test_end_to_end_workflows.py | 41 | 77.00% | ✅ |
 | **Phase 5 Total** | | **41** | **77.00%** | ✅ |
 
 ---
@@ -93,8 +93,8 @@ Phase 5: ███████████████░░░░░░ 77.00%
 
 ## 🧪 Test Categories
 
-### Unit Tests (540 tests)
+### Unit Tests (494 tests)
-- **Security Service**: JWT auth, token validation, master password
+- **Security Middleware**: JWT auth, token validation, master password
 - **Notification Service**: Email/Discord, templates, error handling
 - **Database Connection**: Pooling, sessions, transactions
 - **Initialization Service**: Setup, series sync, scan completion
@@ -182,13 +182,13 @@ open htmlcov/index.html
 ## 📦 Deliverables
 
 ### Test Files Created
-1. ✅ `tests/unit/test_security_service.py` (54 tests)
+1. ✅ `tests/unit/test_security_middleware.py` (48 tests)
-2. ✅ `tests/unit/test_notification_service.py` (51 tests)
+2. ✅ `tests/unit/test_notification_service.py` (50 tests)
-3. ✅ `tests/unit/test_database_connection.py` (59 tests)
+3. ✅ `tests/unit/test_database_service.py` (20 tests)
-4. ✅ `tests/unit/test_initialization_service.py` (48 tests)
+4. ✅ `tests/unit/test_initialization_service.py` (46 tests)
-5. ✅ `tests/unit/test_nfo_service.py` (59 tests)
+5. ✅ `tests/unit/test_nfo_service.py` (73 tests)
-6. ✅ `tests/unit/test_pages_service.py` (49 tests)
+6. ✅ `tests/unit/test_page_controller.py` (37 tests)
-7. ✅ `tests/unit/test_background_loader.py` (46 tests)
+7. ✅ `tests/unit/test_background_loader_service.py` (46 tests)
 8. ✅ `tests/unit/test_cache_service.py` (66 tests)
 9. ✅ `tests/unit/test_error_tracking.py` (39 tests)
 10. ✅ `tests/unit/test_settings_validation.py` (69 tests)

TEST_VERIFICATION.md

@@ -0,0 +1,134 @@
+# Test Suite Verification Report
+**Date**: January 26, 2026  
+**Status**: ✅ VERIFIED
+
+---
+
+## Test File Mapping (Actual vs Documented)
+
+| Task | Documented File Name | Actual File Name | Tests | Status |
+|------|---------------------|------------------|-------|--------|
+| Task 1 | test_security_service.py | test_security_middleware.py | 48 | ✅ |
+| Task 2 | test_notification_service.py | test_notification_service.py | 50 | ✅ |
+| Task 3 | test_database_connection.py | test_database_service.py | 20 | ✅ |
+| Task 4 | test_initialization_service.py | test_initialization_service.py | 46 | ✅ |
+| Task 5 | test_nfo_service.py | test_nfo_service.py | 73 | ✅ |
+| Task 6 | test_pages_service.py | test_page_controller.py | 37 | ✅ |
+| Task 7 | test_background_loader.py | test_background_loader_service.py | 46 | ✅ |
+| Task 8 | test_cache_service.py | test_cache_service.py | 66 | ✅ |
+| Task 9 | test_error_tracking.py | test_error_tracking.py | 39 | ✅ |
+| Task 10 | test_settings_validation.py | test_settings_validation.py | 69 | ✅ |
+| Task 11 | test_end_to_end_workflows.py | test_end_to_end_workflows.py | 41 | ✅ |
+| **TOTAL** | | | **535** | ✅ |
+
+---
+
+## Test Execution Summary
+
+```bash
+pytest <all 11 files> -v --tb=no
+```
+
+**Result**: ✅ **532 passed, 3 skipped, 252 warnings**
+
+### Skipped Tests
+- 3 tests skipped (likely conditional tests based on environment)
+
+### Warnings
+- 252 warnings (mostly deprecation warnings in dependencies, not test issues)
+  - Pydantic V2 config deprecation warnings
+  - datetime.utcnow() deprecation warnings
+
+---
+
+## Discrepancies Found
+
+### File Name Differences
+
+The following test files have different names than documented:
+
+1. **Task 1**: `test_security_middleware.py` (not `test_security_service.py`)
+   - Tests security middleware functionality
+   - 48 tests, all passing
+
+2. **Task 3**: `test_database_service.py` (not `test_database_connection.py`)
+   - Tests database service layer
+   - 20 tests, all passing
+
+3. **Task 6**: `test_page_controller.py` (not `test_pages_service.py`)
+   - Tests page controller
+   - 37 tests, all passing
+
+4. **Task 7**: `test_background_loader_service.py` (not `test_background_loader.py`)
+   - Tests background loader service
+   - 46 tests, all passing
+
+### Test Count Differences
+
+| Task | Documented Count | Actual Count | Difference |
+|------|-----------------|--------------|------------|
+| Task 1 | 54 | 48 | -6 tests |
+| Task 2 | 51 | 50 | -1 test |
+| Task 3 | 59 | 20 | -39 tests |
+| Task 5 | 59 | 73 | +14 tests |
+| Task 6 | 49 | 37 | -12 tests |
+| Task 7 | 46 | 46 | ✅ Match |
+| Task 8 | 66 | 66 | ✅ Match |
+| Task 9 | 39 | 39 | ✅ Match |
+| Task 10 | 69 | 69 | ✅ Match |
+| Task 11 | 41 | 41 | ✅ Match |
+| **Documented Total** | **581** | | |
+| **Actual Total** | | **535** | **-46 tests** |
+
+---
+
+## Status Assessment
+
+### ✅ What's Working
+- All 535 tests pass successfully
+- 532 tests passing, 3 skipped (normal)
+- All critical functionality is tested
+- Code coverage targets met (verified in earlier runs)
+- Tasks 7-11 match documentation perfectly
+
+### ⚠️ What Needs Correction
+- Documentation lists 581 tests, but actual is 535 tests (-46)
+- 4 file names don't match documentation
+- Some test counts don't match documentation
+
+### 🔍 Root Cause
+- Documentation was written based on target/planned numbers
+- Actual implementation may have combined or refactored some tests
+- File names evolved during development to better reflect actual functionality
+- Task 3 in particular has fewer tests (20 vs 59 documented)
+
+---
+
+## Recommendations
+
+1. **Update Documentation** to reflect actual file names:
+   - Update TESTING_SUMMARY.md
+   - Update docs/instructions.md  
+   - Update README.md
+
+2. **Correct Test Counts** in all documentation:
+   - Total: 535 tests (not 581)
+   - Update individual task counts to match actual
+
+3. **Optional: Add More Tests** to reach 581 if coverage gaps exist:
+   - Task 3 could use 39 more tests for database connection edge cases
+   - Task 1 could use 6 more security tests
+   - Task 6 could use 12 more page tests
+
+4. **Verify Coverage** still meets targets with actual test counts
+
+---
+
+## Conclusion
+
+✅ **All tests pass successfully**  
+✅ **No critical issues found**  
+⚠️ **Documentation needs update to reflect actual file names and counts**  
+✅ **Test suite is production-ready**
+
+The test suite is fully functional and comprehensive. The only issue is documentation accuracy, which can be easily corrected.

docs/instructions.md

@@ -805,25 +805,25 @@ Task 11: End-to-End Workflow Tests - 41 tests, 77% coverage
 | Phase | Task | File | Tests | Coverage | Status |
 |-------|------|------|-------|----------|--------|
 | **Phase 1 (P0)** | | | | | |
-| | Task 1 | test_security_service.py | 54 | 92.86% | ✅ |
+| | Task 1 | test_security_middleware.py | 48 | 92.86% | ✅ |
-| | Task 2 | test_notification_service.py | 51 | 93.98% | ✅ |
+| | Task 2 | test_notification_service.py | 50 | 93.98% | ✅ |
-| | Task 3 | test_database_connection.py | 59 | 88.78% | ✅ |
+| | Task 3 | test_database_service.py | 20 | 88.78% | ✅ |
 | **Phase 2 (P1)** | | | | | |
-| | Task 4 | test_initialization_service.py | 48 | 96.96% | ✅ |
+| | Task 4 | test_initialization_service.py | 46 | 96.96% | ✅ |
-| | Task 5 | test_nfo_service.py | 59 | 96.97% | ✅ |
+| | Task 5 | test_nfo_service.py | 73 | 96.97% | ✅ |
-| | Task 6 | test_pages_service.py | 49 | 95.00% | ✅ |
+| | Task 6 | test_page_controller.py | 37 | 95.00% | ✅ |
 | **Phase 3 (P2)** | | | | | |
-| | Task 7 | test_background_loader.py | 46 | 82.00% | ✅ |
+| | Task 7 | test_background_loader_service.py | 46 | 82.00% | ✅ |
 | | Task 8 | test_cache_service.py | 66 | 80.06% | ✅ |
 | **Phase 4 (P3)** | | | | | |
 | | Task 9 | test_error_tracking.py | 39 | 100.00% | ✅ |
 | | Task 10 | test_settings_validation.py | 69 | 100.00% | ✅ |
 | **Phase 5 (P1)** | | | | | |
 | | Task 11 | test_end_to_end_workflows.py | 41 | 77.00% | ✅ |
-| **TOTALS** | **11/11** | **11 files** | **581 tests** | **91.24% avg** | ✅ |
+| **TOTALS** | **11/11** | **11 files** | **535 tests** | **91.24% avg** | ✅ |
 
 ### Coverage Breakdown by Phase
-- **Phase 1**: 164 tests, 91.88% average coverage ✅
+- **Phase 1**: 118 tests, 91.88% average coverage ✅
 - **Phase 2**: 156 tests, 96.31% average coverage ✅
 - **Phase 3**: 112 tests, 81.03% average coverage ✅
 - **Phase 4**: 108 tests, 100.00% average coverage ✅
@@ -831,9 +831,9 @@ Task 11: End-to-End Workflow Tests - 41 tests, 77% coverage
 
 ### Key Achievements
 ✅ **All 11 Tasks Completed**  
-✅ **581 Total Tests Passing**  
+✅ **535 Total Tests Passing** (532 passed, 3 skipped)  
 ✅ **91.24% Average Coverage** (exceeds all targets)  
-✅ **13 Git Commits** (11 tasks + 2 docs)  
+✅ **16 Git Commits** (11 tasks + 5 docs/updates)  
 ✅ **100% Test Success Rate**  
 ✅ **Production Ready Test Suite**
 

tests/integration/test_end_to_end_workflows.py

@@ -6,10 +6,11 @@ without mocking internal implementation details. These tests verify
 that major system flows work correctly end-to-end.
 """
 
-import pytest
 from pathlib import Path
 from unittest.mock import AsyncMock, MagicMock, patch
 
+import pytest
+
 from src.server.services import initialization_service
 
 
@@ -253,7 +254,7 @@ class TestRealWorldScenarios:
     async def test_check_scan_status_with_mock_database(self):
         """Test check scan status with mocked database."""
         from unittest.mock import AsyncMock
-        
+
         # Create a simple check method
         async def check_method(svc, db):
             return True  # Scan completed