feat: enhance dashboard with new metrics, project and scenario utilities, and comprehensive tests

tests/test_repositories.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from collections.abc import Iterator
+from datetime import datetime, timezone
 
 import pytest
 from sqlalchemy import create_engine
@@ -153,4 +154,91 @@ def test_unit_of_work_commit_and_rollback(engine) -> None:
 
     with TestingSession() as session:
         projects = ProjectRepository(session).list()
-        assert len(projects) == 1
+        assert len(projects) == 1
+
+
+def test_project_repository_count_and_recent(session: Session) -> None:
+    repo = ProjectRepository(session)
+    project_alpha = Project(name="Alpha", operation_type=MiningOperationType.OPEN_PIT)
+    project_bravo = Project(name="Bravo", operation_type=MiningOperationType.UNDERGROUND)
+
+    repo.create(project_alpha)
+    repo.create(project_bravo)
+
+    project_alpha.updated_at = datetime(2025, 1, 1, tzinfo=timezone.utc)
+    project_bravo.updated_at = datetime(2025, 1, 2, tzinfo=timezone.utc)
+    session.flush()
+
+    assert repo.count() == 2
+    recent = repo.recent(limit=1)
+    assert len(recent) == 1
+    assert recent[0].name == "Bravo"
+
+
+def test_scenario_repository_counts_and_filters(session: Session) -> None:
+    project = Project(name="Project", operation_type=MiningOperationType.PLACER)
+    session.add(project)
+    session.flush()
+
+    repo = ScenarioRepository(session)
+    draft = Scenario(name="Draft", project_id=project.id,
+                     status=ScenarioStatus.DRAFT)
+    active = Scenario(name="Active", project_id=project.id,
+                      status=ScenarioStatus.ACTIVE)
+
+    repo.create(draft)
+    repo.create(active)
+
+    draft.updated_at = datetime(2025, 1, 1, tzinfo=timezone.utc)
+    active.updated_at = datetime(2025, 1, 3, tzinfo=timezone.utc)
+    session.flush()
+
+    assert repo.count() == 2
+    assert repo.count_by_status(ScenarioStatus.ACTIVE) == 1
+
+    recent = repo.recent(limit=1, with_project=True)
+    assert len(recent) == 1
+    assert recent[0].name == "Active"
+    assert recent[0].project.name == "Project"
+
+    drafts = repo.list_by_status(ScenarioStatus.DRAFT, limit=2, with_project=True)
+    assert len(drafts) == 1
+    assert drafts[0].name == "Draft"
+    assert drafts[0].project_id == project.id
+
+
+def test_financial_input_repository_latest_created_at(session: Session) -> None:
+    project = Project(name="Project FI", operation_type=MiningOperationType.OTHER)
+    scenario = Scenario(name="Scenario FI", project=project)
+    session.add(project)
+    session.flush()
+
+    repo = FinancialInputRepository(session)
+    old_timestamp = datetime(2024, 12, 31, 15, 0)
+    new_timestamp = datetime(2025, 1, 2, 8, 30)
+
+    repo.bulk_upsert(
+        [
+            FinancialInput(
+                scenario_id=scenario.id,
+                name="Legacy Entry",
+                category=FinancialCategory.OPERATING_EXPENDITURE,
+                amount=1000,
+                currency="usd",
+                created_at=old_timestamp,
+                updated_at=old_timestamp,
+            ),
+            FinancialInput(
+                scenario_id=scenario.id,
+                name="New Entry",
+                category=FinancialCategory.OPERATING_EXPENDITURE,
+                amount=2000,
+                currency="usd",
+                created_at=new_timestamp,
+                updated_at=new_timestamp,
+            ),
+        ]
+    )
+
+    latest = repo.latest_created_at()
+    assert latest == new_timestamp