feat(dashboard): add system summary endpoint and monthly media statistics

tests/test_api_authorization.py

@@ -59,6 +59,7 @@ def test_dashboard_endpoints_require_superuser():
     assert _dependency_of(dashboard_endpoint.statistic, "_") is get_current_active_superuser
     assert _dependency_of(dashboard_endpoint.storage, "_") is get_current_active_superuser
     assert _dependency_of(dashboard_endpoint.processes, "_") is get_current_active_superuser
+    assert _dependency_of(dashboard_endpoint.system_info, "_") is get_current_active_superuser
     assert _dependency_of(dashboard_endpoint.downloader, "_") is get_current_active_superuser
     assert _dependency_of(dashboard_endpoint.schedule, "_") is get_current_active_superuser
     assert _dependency_of(dashboard_endpoint.transfer, "_") is get_current_active_superuser

tests/test_dashboard_system_info.py

@@ -0,0 +1,53 @@
+from app.db import SessionFactory
+from app.db.models.transferhistory import TransferHistory
+from app.schemas.types import MediaType
+from app.utils import system as system_module
+from app.utils.system import SystemUtils
+
+
+def test_dashboard_system_info_returns_runtime_environment(monkeypatch):
+    """系统摘要应返回主机、系统、进程运行时间和后端版本。"""
+
+    class FakeProcess:
+        """提供固定启动时间的进程桩。"""
+
+        @staticmethod
+        def create_time() -> float:
+            """返回固定的进程启动时间。"""
+            return 400.0
+
+    monkeypatch.setattr(system_module.socket, "gethostname", lambda: "moviepilot-host")
+    monkeypatch.setattr(system_module.time, "time", lambda: 1000.0)
+    monkeypatch.setattr(system_module.psutil, "Process", FakeProcess)
+    monkeypatch.setattr(SystemUtils, "_operating_system_name", staticmethod(lambda: "Ubuntu 24.04.4 LTS"))
+    monkeypatch.setattr(system_module, "APP_VERSION", "v2.13.16")
+
+    result = SystemUtils.dashboard_system_info()
+
+    assert result.hostname == "moviepilot-host"
+    assert result.operating_system == "Ubuntu 24.04.4 LTS"
+    assert result.runtime == 600
+    assert result.version == "v2.13.16"
+
+
+def test_monthly_media_statistics_counts_successful_unique_media():
+    """本月新增统计应只计算成功记录，并按媒体去重。"""
+    month = system_module.time.strftime("%Y-%m-", system_module.time.localtime())
+    histories = [
+        TransferHistory(status=True, date=f"{month}01 10:00:00", type=MediaType.MOVIE.value, tmdbid=1, title="电影"),
+        TransferHistory(status=True, date=f"{month}02 10:00:00", type=MediaType.MOVIE.value, tmdbid=1, title="电影"),
+        TransferHistory(status=True, date=f"{month}03 10:00:00", type=MediaType.TV.value, tmdbid=2, title="剧集", episodes="E01-E03"),
+        TransferHistory(status=False, date=f"{month}04 10:00:00", type=MediaType.TV.value, tmdbid=3, title="失败剧集"),
+    ]
+    db = SessionFactory()
+    try:
+        db.add_all(histories)
+        db.commit()
+
+        assert TransferHistory.monthly_media_statistics(db) == (1, 1, 3)
+    finally:
+        history_ids = [history.id for history in histories if history.id is not None]
+        if history_ids:
+            db.query(TransferHistory).filter(TransferHistory.id.in_(history_ids)).delete(synchronize_session=False)
+            db.commit()
+        db.close()