cleanup

2025-09-14 14:19:39 -04:00
parent a9c90d2939
commit f5ae8c7768
5 changed files with 90 additions and 37 deletions
@@ -1,43 +1,57 @@
 # NFOGuard Development Summary

-## Current Status: v1.4.4 - TV Webhooks Working! 🎉
+## Current Status: v1.4.6 - Flexible Debug Controls! �️

-### Latest Updates (v1.4.4)
- **✅ SUCCESS**: TV webhook path mapping now working correctly!
- **🎯 FIXED**: Six Feet Under processing correctly (no more cross-processing)
- **📺 WORKING**: Episode batch processing and database storage functional
- **🔧 MINOR**: Fixed remaining path typo in tv6 configuration
+### Latest Updates (v1.4.6)
+- **🎛️ FLEXIBLE DEBUGGING**: Added `PATH_DEBUG` environment variable for path mapping debug control
+- **🧹 PRODUCTION READY**: Can now disable path debug while keeping general logging
+- **⚙️ GRANULAR CONTROL**: Separate debug controls for different system components
+- **✅ CONFIGURABLE**: Debug output now completely controllable via .env settings

-### Working TV Webhook Flow
-```
-✅ Webhook received: Six Feet Under
-✅ Path mapping: /mnt/unionfs/Media/TV/tv → /media/TV/tv
-✅ Series lookup: Found exact IMDb match (ID: 588)
-✅ Episode processing: S01E03 processed successfully 
-✅ Database: Episode entry saved with timestamp
-✅ Result: 1/1 episodes processed
-```
-
-### Final Configuration Fix
-**Your .env should have:**
+### New Debug Control System
 ```bash
-# All paths working correctly:
-MOVIE_PATHS=/media/Movies/movies,/media/Movies/movies6
-TV_PATHS=/media/TV/tv,/media/TV/tv6
-RADARR_ROOT_FOLDERS=/mnt/unionfs/Media/Movies/movies,/mnt/unionfs/Media/Movies/movies6
-SONARR_ROOT_FOLDERS=/mnt/unionfs/Media/TV/tv,/mnt/unionfs/Media/TV/tv6
+# General application debugging (webhooks, processing, etc.)
+DEBUG=true
+
+# Path mapping debugging (verbose path translation output)  
+PATH_DEBUG=false
 ```

-### Complete System Status
- ✅ **Movie Webhooks**: Working perfectly with path mapping
- ✅ **TV Webhooks**: Working perfectly with path mapping  
- ✅ **NFO Management**: All media types preserve content and append fields
- ✅ **Database**: Clean schema with proper episode tracking
- ✅ **Path Mapping**: Both movies/movies6 and tv/tv6 handled correctly
+### Debug Output Examples

-### Minor Notes
- ⚠️ TVDB API warnings are normal (not all series support TVDB lookup)
- ✅ Episode processing completes successfully regardless
- ✅ IMDb-based series matching works reliably
+**With PATH_DEBUG=false (Production):**
+```
+INFO: Received Radarr webhook: Download
+INFO: Batched movie webhook for movie:tt3322940
+INFO: Processing movie: Annabelle (2014) [tt3322940]
+INFO: Completed processing movie: Annabelle (2014) [tt3322940]
+```

-## 🎬📺 NFOGuard is now fully functional for both movies and TV shows! 🎉
+**With PATH_DEBUG=true (Troubleshooting):**
+```
+PATH_DEBUG: PathMapper initialized with:
+PATH_DEBUG: radarr_roots: ['/mnt/unionfs/Media/Movies/movies', '/mnt/unionfs/Media/Movies/movies6']
+PATH_DEBUG: radarr_path_to_container_path input: /mnt/unionfs/Media/Movies/movies6/Annabelle...
+PATH_DEBUG: Checking radarr_root[1]: /mnt/unionfs/Media/Movies/movies6
+PATH_DEBUG: Match found! Index 1
+PATH_DEBUG: Mapped to: /media/Movies/movies6/Annabelle (2014) [tt3322940]
+```
+
+### Recommended Production Settings
+```bash
+# Optimal for production monitoring:
+DEBUG=true          # Keep application logging for monitoring
+PATH_DEBUG=false    # Disable verbose path mapping output
+
+# Minimal logging for high-performance:
+DEBUG=false         # Disable all debug output
+PATH_DEBUG=false    # Disable path mapping debug
+```
+
+### Debug Scenarios
+- **✅ Production**: `DEBUG=true, PATH_DEBUG=false` - Monitor without noise
+- **🔧 Troubleshooting**: `DEBUG=true, PATH_DEBUG=true` - Full diagnostics  
+- **🚀 High Performance**: `DEBUG=false, PATH_DEBUG=false` - Minimal logging
+- **🎯 Path Issues**: `DEBUG=false, PATH_DEBUG=true` - Focus on path mapping only
+
+## 🎛️ NFOGuard now offers complete control over debug output levels! 🎛️