Improve docs and security defaults

src/core/SerieScanner.py

@@ -124,6 +124,9 @@ class SerieScanner:
             total_to_scan = self.get_total_to_scan()
             logger.info("Total folders to scan: %d", total_to_scan)
 
+            # The scanner enumerates folders with mp4 files, loads existing
+            # metadata, calculates the missing episodes via the provider, and
+            # persists the refreshed metadata while emitting progress events.
             result = self.__find_mp4_files()
             counter = 0
 
@@ -137,6 +140,9 @@ class SerieScanner:
                     else:
                         percentage = 0.0
 
+                    # Progress is surfaced both through the callback manager
+                    # (for the web/UI layer) and, for compatibility, through a
+                    # legacy callback that updates CLI progress bars.
                     # Notify progress
                     self._callback_manager.notify_progress(
                         ProgressContext(
@@ -160,12 +166,16 @@ class SerieScanner:
                         serie is not None
                         and not self.is_null_or_whitespace(serie.key)
                     ):
-                        missings, site = (
+                        # Delegate the provider to compare local files with
+                        # remote metadata, yielding missing episodes per
+                        # season. Results are saved back to disk so that both
+                        # CLI and API consumers see consistent state.
+                        missing_episodes, site = (
                             self.__get_missing_episodes_and_season(
                                 serie.key, mp4_files
                             )
                         )
-                        serie.episodeDict = missings
+                        serie.episodeDict = missing_episodes
                         serie.folder = folder
                         data_path = os.path.join(
                             self.directory, folder, 'data'