Add statistics and data-consistency menus, recently-added folder

src/core/file.py

@@ -24,6 +24,9 @@ class File:
         # movie-library fields
         self.title: str | None = None
         self.csfd_link: str | None = None
+        # ISO timestamp of when the movie was added to the pool (set on import);
+        # None for older/unknown → falls back to the file's ctime.
+        self.added: str | None = None
         # Cached CSFD data — avoids re-fetching on every open
         self.csfd_cache: dict | None = None
         # full_paths of tags that came from ČSFD (vs. user-added); only these are
@@ -60,6 +63,7 @@ class File:
         self.csfd_cache = None
         self.csfd_tag_paths = set()
         self.attributes = {}
+        self.added = None
 
     def _build_record(self) -> dict:
         data = {
@@ -74,6 +78,7 @@ class File:
             "title": self.title,
             "csfd_link": self.csfd_link,
             "attributes": self.attributes,
+            "added": self.added,
         }
         if self.csfd_cache is not None:
             data["csfd_cache"] = {"version": CSFD_CACHE_VERSION, **self.csfd_cache}
@@ -89,6 +94,7 @@ class File:
         # Legacy records have no provenance → treated as all-user (empty set)
         self.csfd_tag_paths = set(data.get("csfd_tags", []))
         self.attributes = dict(data.get("attributes", {}))
+        self.added = data.get("added", None)
         raw_cache = data.get("csfd_cache")
         if raw_cache and raw_cache.get("version") == CSFD_CACHE_VERSION:
             self.csfd_cache = {k: v for k, v in raw_cache.items() if k != "version"}
@@ -117,6 +123,25 @@ class File:
             data = json.load(f)
         self._apply_record(data)
 
+    def added_timestamp(self) -> float:
+        """Epoch seconds for 'date added' — the stored ``added`` or the file mtime.
+
+        Used to order the "recently added" folder (newer = larger). The fallback
+        is **mtime**, not ctime: creating the Filmotéka hardlinks bumps the source
+        inode's ctime, which would make ctime-based ordering meaningless, whereas
+        mtime (preserved from the source on import) stays stable.
+        """
+        if self.added:
+            try:
+                from datetime import datetime
+                return datetime.fromisoformat(self.added).timestamp()
+            except ValueError:
+                pass
+        try:
+            return self.file_path.stat().st_mtime
+        except OSError:
+            return 0.0
+
     def name_context(self) -> dict:
         """Fields for a Filmotéka filename template (see config tag schema).