22 Commits

Author SHA1 Message Date
8f7c489bd2 feat: Complete frontend integration with native WebSocket and FastAPI backend
- Created websocket_client.js: Native WebSocket wrapper with Socket.IO-compatible interface
  - Automatic reconnection with exponential backoff
  - Room-based subscriptions for targeted updates
  - Message queueing during disconnection

- Updated HTML templates (index.html, queue.html):
  - Replaced Socket.IO CDN with native websocket_client.js
  - No external dependencies needed

- Updated JavaScript files (app.js, queue.js):
  - Added room subscriptions on WebSocket connect (scan_progress, download_progress, downloads)
  - Added dual event handlers for backward compatibility
  - Support both old (scan_completed) and new (scan_complete) message types
  - Support both old (download_error) and new (download_failed) message types
  - Support both old (queue_updated) and new (queue_status) message types

- Registered anime router in fastapi_app.py:
  - Added anime_router import and registration
  - All API routers now properly included

- Documentation:
  - Created FRONTEND_INTEGRATION.md with comprehensive integration guide
  - Updated infrastructure.md with frontend integration section
  - Updated instructions.md to mark task as completed

- Testing:
  - Verified anime endpoint tests pass (pytest)
  - API endpoint mapping documented
  - WebSocket message format changes documented

Benefits:
  - Native WebSocket API (faster, smaller footprint)
  - No external CDN dependencies
  - Full backward compatibility with existing code
  - Proper integration with backend services
  - Real-time updates via room-based messaging
2025-10-17 12:12:47 +02:00
99e24a2fc3 feat: Integrate HTML templates with FastAPI
- Created template_helpers.py for centralized template rendering
- Added ux_features.css for enhanced UX styling
- Implemented JavaScript modules for:
  - Keyboard shortcuts (Ctrl+K, Ctrl+R navigation)
  - User preferences persistence
  - Undo/redo functionality (Ctrl+Z/Ctrl+Y)
  - Mobile responsive features
  - Touch gesture support
  - Accessibility features (ARIA, focus management)
  - Screen reader support
  - Color contrast compliance (WCAG)
  - Multi-screen support
- Updated page_controller.py and error_controller.py to use template helpers
- Created comprehensive template integration tests
- All templates verified: index.html, login.html, setup.html, queue.html, error.html
- Maintained responsive layout and theme switching
- Updated instructions.md (removed completed task)
- Updated infrastructure.md with template integration details
2025-10-17 12:01:22 +02:00
043d8a2877 docs: Remove completed WebSocket integration task from instructions 2025-10-17 11:52:19 +02:00
71207bc935 feat: Complete WebSocket integration with core services
- Enhanced DownloadService broadcasts for all queue operations
  - Download progress, complete, and failed broadcasts with full metadata
  - Queue operations (add, remove, reorder, retry, clear) broadcast queue status
  - Queue control (start, stop, pause, resume) broadcasts state changes

- AnimeService scan progress fully integrated with ProgressService
  - Scan lifecycle events (start, update, complete, fail) broadcasted
  - Progress tracking via ProgressService to scan_progress room

- ProgressService WebSocket integration
  - Broadcast callback registered during application startup
  - All progress types route to appropriate rooms
  - Throttled broadcasts for performance (>1% changes)

- Comprehensive integration tests
  - Test download progress and completion broadcasts
  - Test queue operation broadcasts
  - Test scan progress lifecycle
  - Test progress service integration
  - End-to-end flow testing

- Updated infrastructure documentation
  - Detailed broadcast message formats
  - Room structure and subscription patterns
  - Production deployment considerations
  - Architecture benefits and scalability notes
2025-10-17 11:51:16 +02:00
8c8853d26e clean 2025-10-17 11:13:17 +02:00
577c55f32a feat: Implement download queue API endpoints
- Add comprehensive REST API for download queue management
- Implement GET /api/queue/status endpoint with queue status and statistics
- Implement POST /api/queue/add for adding episodes to queue with priority support
- Implement DELETE /api/queue/{id} and DELETE /api/queue/ for removing items
- Implement POST /api/queue/start and /api/queue/stop for queue control
- Implement POST /api/queue/pause and /api/queue/resume for pause/resume
- Implement POST /api/queue/reorder for queue item reordering
- Implement DELETE /api/queue/completed for clearing completed items
- Implement POST /api/queue/retry for retrying failed downloads
- Add get_download_service and get_anime_service dependencies
- Register download router in FastAPI application
- Add comprehensive test suite for all endpoints
- All endpoints require JWT authentication
- Update infrastructure documentation
- Remove completed task from instructions.md

Follows REST conventions with proper error handling and status codes.
Tests cover success cases, error conditions, and authentication requirements.
2025-10-17 10:29:03 +02:00
028d91283e feat: implement download queue service with persistence, priority, and retry logic
- Added comprehensive download queue service (download_service.py)
  - Priority-based queue management (HIGH, NORMAL, LOW)
  - Concurrent download processing with configurable limits
  - Automatic queue persistence to JSON file
  - Retry logic for failed downloads with max retry limits
  - Real-time progress tracking and WebSocket broadcasting
  - Queue operations: add, remove, reorder, pause, resume
  - Statistics tracking: download speeds, sizes, ETA calculations

- Created comprehensive unit tests (test_download_service.py)
  - 23 tests covering all service functionality
  - Tests for queue management, persistence, retry logic
  - Broadcast callbacks, error handling, and lifecycle

- Added structlog dependency for structured logging
- Updated infrastructure.md with download service documentation
- Removed completed task from instructions.md

All tests passing (23/23)
2025-10-17 10:07:16 +02:00
1ba4336291 feat: implement download queue Pydantic models
- Add comprehensive download queue models in src/server/models/download.py
  - DownloadStatus and DownloadPriority enums for type safety
  - EpisodeIdentifier for episode references
  - DownloadProgress for real-time progress tracking
  - DownloadItem for queue item representation with timestamps and error handling
  - QueueStatus for overall queue state management
  - QueueStats for aggregated queue statistics
  - DownloadRequest/DownloadResponse for API contracts
  - QueueOperationRequest and QueueReorderRequest for queue management
  - QueueStatusResponse for complete status endpoint responses

- Add comprehensive unit tests (47 tests, all passing)
  - Test validation constraints (positive numbers, ranges, etc.)
  - Test default values and optional fields
  - Test serialization/deserialization
  - Test model relationships and nested structures

- Update documentation
  - Add download models section to infrastructure.md
  - Remove completed task from instructions.md
  - Update models package __init__.py

All models follow PEP 8 style guide with proper type hints and validation.
2025-10-17 09:55:55 +02:00
9323eb6371 feat(api): add anime API endpoints and tests; update docs 2025-10-14 22:01:56 +02:00
3ffab4e70a feat(server): add anime_service wrapper, unit tests, update docs 2025-10-14 21:57:20 +02:00
5b80824f3a feat(server): add anime Pydantic models, unit tests, and infra notes 2025-10-14 21:53:41 +02:00
52b96da8dc feat(config): add Pydantic AppConfig, BackupConfig, LoggingConfig; update tests and infra notes 2025-10-14 21:43:48 +02:00
4aa7adba3a feat(config): add Pydantic config models, tests, docs and infra notes 2025-10-14 21:36:25 +02:00
9096afbace feat(auth): add AuthMiddleware with JWT parsing and in-memory rate limiting; wire into app; add tests and docs 2025-10-13 00:18:46 +02:00
97bef2c98a api(auth): add auth endpoints (setup, login, logout, status), tests, and dependency token decoding; update docs 2025-10-13 00:12:35 +02:00
aec6357dcb feat(auth): add AuthService with JWT, lockout and tests 2025-10-13 00:03:02 +02:00
92217301b5 feat(auth): add Pydantic auth models and unit tests; update docs 2025-10-12 23:49:04 +02:00
8e885dd40b feat: implement comprehensive logging system
- Created src/server/utils/logging.py with structured JSON logging
- Multiple log handlers for app, error, download, security, performance
- Request logging middleware with unique request IDs and timing
- Log rotation and cleanup functionality
- Comprehensive test suite with 19 passing tests
- Context variables for request and user tracking
- Security event logging and download progress tracking

Features:
- JSON formatted logs with consistent structure
- Automatic log rotation (10MB files, 5 backups)
- Request/response logging middleware
- Performance monitoring
- Security auditing
- Download progress tracking
- Old log cleanup functionality

Tests: All 19 tests passing for logging system functionality
2025-10-12 23:33:56 +02:00
8fb4770161 Implement dependency injection system
- Enhanced existing src/server/utils/dependencies.py with optional SQLAlchemy import
- Added comprehensive unit tests in tests/unit/test_dependencies.py
- Created pytest configuration with asyncio support
- Implemented SeriesApp singleton dependency with proper error handling
- Added placeholders for database session and authentication dependencies
- Updated infrastructure.md with dependency injection documentation
- Completed dependency injection task from instructions.md

Features implemented:
- SeriesApp dependency with lazy initialization and singleton pattern
- Configuration validation for anime directory
- Comprehensive error handling for initialization failures
- Common query parameters for pagination
- Placeholder dependencies for future authentication and database features
- 18 passing unit tests covering all dependency injection scenarios
2025-10-12 23:17:20 +02:00
2867ebae09 health check 2025-10-12 23:06:29 +02:00
6a695966bf instruction3 2025-10-12 22:43:18 +02:00
7481a33c15 instruction2 2025-10-12 22:39:51 +02:00