Refactor and enhance CalMiner application

- Updated README.md to reflect new features and usage instructions.
- Removed deprecated Dashboard.html component and integrated dashboard functionality directly into the main application.
- Revised architecture documentation for clarity and added module map and request flow diagrams.
- Enhanced maintenance model to include equipment association and cost tracking.
- Updated requirements.txt to include new dependencies (httpx, pandas, numpy).
- Improved consumption, maintenance, production, and reporting routes with better validation and response handling.
- Added unit tests for maintenance and production routes, ensuring proper CRUD operations and validation.
- Enhanced reporting service to calculate and return detailed summary statistics.
- Redesigned Dashboard.html for improved user experience and integrated Chart.js for visualizing simulation results.

tests/unit/test_consumption.py

@@ -29,7 +29,7 @@ def test_create_and_list_consumption():
     cons_payload = {"scenario_id": sid, "amount": 250.0,
                     "description": "Monthly consumption"}
     resp2 = client.post("/api/consumption/", json=cons_payload)
-    assert resp2.status_code == 200
+    assert resp2.status_code == 201
     cons = resp2.json()
     assert cons["scenario_id"] == sid
     assert cons["amount"] == 250.0

tests/unit/test_maintenance.py

@@ -1,8 +1,30 @@
-from fastapi.testclient import TestClient
-from main import app
-from config.database import Base, engine
+from uuid import uuid4
 
-# Setup and teardown
+from fastapi.testclient import TestClient
+from sqlalchemy import create_engine
+from sqlalchemy.orm import sessionmaker
+
+from config.database import Base
+from main import app
+from routes import (
+    consumption,
+    costs,
+    distributions,
+    equipment,
+    maintenance,
+    parameters,
+    production,
+    reporting,
+    scenarios,
+    simulations,
+    ui,
+)
+
+SQLALCHEMY_DATABASE_URL = "sqlite:///./test.db"
+engine = create_engine(SQLALCHEMY_DATABASE_URL, connect_args={
+                       "check_same_thread": False})
+TestingSessionLocal = sessionmaker(
+    autocommit=False, autoflush=False, bind=engine)
 
 
 def setup_module(module):
@@ -13,29 +35,145 @@ def teardown_module(module):
     Base.metadata.drop_all(bind=engine)
 
 
+def override_get_db():
+    db = TestingSessionLocal()
+    try:
+        yield db
+    finally:
+        db.close()
+
+
+app.dependency_overrides[maintenance.get_db] = override_get_db
+app.dependency_overrides[equipment.get_db] = override_get_db
+app.dependency_overrides[scenarios.get_db] = override_get_db
+app.dependency_overrides[distributions.get_db] = override_get_db
+app.dependency_overrides[parameters.get_db] = override_get_db
+app.dependency_overrides[costs.get_db] = override_get_db
+app.dependency_overrides[consumption.get_db] = override_get_db
+app.dependency_overrides[production.get_db] = override_get_db
+app.dependency_overrides[reporting.get_db] = override_get_db
+app.dependency_overrides[simulations.get_db] = override_get_db
+
+app.include_router(maintenance.router)
+app.include_router(equipment.router)
+app.include_router(scenarios.router)
+app.include_router(distributions.router)
+app.include_router(ui.router)
+app.include_router(parameters.router)
+app.include_router(costs.router)
+app.include_router(consumption.router)
+app.include_router(production.router)
+app.include_router(reporting.router)
+app.include_router(simulations.router)
+
 client = TestClient(app)
 
 
+def _create_scenario_and_equipment():
+    scenario_payload = {
+        "name": f"Test Scenario {uuid4()}",
+        "description": "Scenario for maintenance tests",
+    }
+    scenario_response = client.post("/api/scenarios/", json=scenario_payload)
+    assert scenario_response.status_code == 200
+    scenario_id = scenario_response.json()["id"]
+
+    equipment_payload = {
+        "scenario_id": scenario_id,
+        "name": f"Test Equipment {uuid4()}",
+        "description": "Equipment linked to maintenance",
+    }
+    equipment_response = client.post("/api/equipment/", json=equipment_payload)
+    assert equipment_response.status_code == 200
+    equipment_id = equipment_response.json()["id"]
+    return scenario_id, equipment_id
+
+
+def _create_maintenance_payload(equipment_id: int, scenario_id: int, description: str):
+    return {
+        "equipment_id": equipment_id,
+        "scenario_id": scenario_id,
+        "maintenance_date": "2025-10-20",
+        "description": description,
+        "cost": 100.0,
+    }
+
+
 def test_create_and_list_maintenance():
-    # Create a scenario to attach maintenance
-    resp = client.post(
-        "/api/scenarios/", json={"name": "MaintScenario", "description": "maintenance scenario"}
+    scenario_id, equipment_id = _create_scenario_and_equipment()
+    payload = _create_maintenance_payload(
+        equipment_id, scenario_id, "Create maintenance")
+
+    response = client.post("/api/maintenance/", json=payload)
+    assert response.status_code == 201
+    created = response.json()
+    assert created["equipment_id"] == equipment_id
+    assert created["scenario_id"] == scenario_id
+    assert created["description"] == "Create maintenance"
+
+    list_response = client.get("/api/maintenance/")
+    assert list_response.status_code == 200
+    items = list_response.json()
+    assert any(item["id"] == created["id"] for item in items)
+
+
+def test_get_maintenance():
+    scenario_id, equipment_id = _create_scenario_and_equipment()
+    payload = _create_maintenance_payload(
+        equipment_id, scenario_id, "Retrieve maintenance"
     )
-    assert resp.status_code == 200
-    scenario = resp.json()
-    sid = scenario["id"]
+    create_response = client.post("/api/maintenance/", json=payload)
+    assert create_response.status_code == 201
+    maintenance_id = create_response.json()["id"]
 
-    # Create Maintenance record
-    maint_payload = {"scenario_id": sid, "details": "Routine check"}
-    resp2 = client.post("/api/maintenance/", json=maint_payload)
-    assert resp2.status_code == 200
-    maint = resp2.json()
-    assert maint["scenario_id"] == sid
-    assert maint["details"] == "Routine check"
+    response = client.get(f"/api/maintenance/{maintenance_id}")
+    assert response.status_code == 200
+    data = response.json()
+    assert data["id"] == maintenance_id
+    assert data["equipment_id"] == equipment_id
+    assert data["description"] == "Retrieve maintenance"
 
-    # List Maintenance records
-    resp3 = client.get("/api/maintenance/")
-    assert resp3.status_code == 200
-    data = resp3.json()
-    assert any(item["details"] ==
-               "Routine check" and item["scenario_id"] == sid for item in data)
+
+def test_update_maintenance():
+    scenario_id, equipment_id = _create_scenario_and_equipment()
+    create_response = client.post(
+        "/api/maintenance/",
+        json=_create_maintenance_payload(
+            equipment_id, scenario_id, "Maintenance before update"
+        ),
+    )
+    assert create_response.status_code == 201
+    maintenance_id = create_response.json()["id"]
+
+    update_payload = {
+        "equipment_id": equipment_id,
+        "scenario_id": scenario_id,
+        "maintenance_date": "2025-11-01",
+        "description": "Maintenance after update",
+        "cost": 250.0,
+    }
+
+    response = client.put(
+        f"/api/maintenance/{maintenance_id}", json=update_payload)
+    assert response.status_code == 200
+    updated = response.json()
+    assert updated["maintenance_date"] == "2025-11-01"
+    assert updated["description"] == "Maintenance after update"
+    assert updated["cost"] == 250.0
+
+
+def test_delete_maintenance():
+    scenario_id, equipment_id = _create_scenario_and_equipment()
+    create_response = client.post(
+        "/api/maintenance/",
+        json=_create_maintenance_payload(
+            equipment_id, scenario_id, "Delete maintenance"),
+    )
+    assert create_response.status_code == 201
+    maintenance_id = create_response.json()["id"]
+
+    delete_response = client.delete(f"/api/maintenance/{maintenance_id}")
+    assert delete_response.status_code == 204
+
+    get_response = client.get(f"/api/maintenance/{maintenance_id}")
+    assert get_response.status_code == 404

tests/unit/test_production.py

@@ -3,14 +3,19 @@ from main import app
 from config.database import Base, engine
 
 # Setup and teardown
+
+
 def setup_module(module):
     Base.metadata.create_all(bind=engine)
 
+
 def teardown_module(module):
     Base.metadata.drop_all(bind=engine)
 
+
 client = TestClient(app)
 
+
 def test_create_and_list_production_output():
     # Create a scenario to attach production output
     resp = client.post(
@@ -21,9 +26,10 @@ def test_create_and_list_production_output():
     sid = scenario["id"]
 
     # Create Production Output item
-    prod_payload = {"scenario_id": sid, "amount": 300.0, "description": "Daily output"}
+    prod_payload = {"scenario_id": sid,
+                    "amount": 300.0, "description": "Daily output"}
     resp2 = client.post("/api/production/", json=prod_payload)
-    assert resp2.status_code == 200
+    assert resp2.status_code == 201
     prod = resp2.json()
     assert prod["scenario_id"] == sid
     assert prod["amount"] == 300.0
@@ -32,4 +38,5 @@ def test_create_and_list_production_output():
     resp3 = client.get("/api/production/")
     assert resp3.status_code == 200
     data = resp3.json()
-    assert any(item["amount"] == 300.0 and item["scenario_id"] == sid for item in data)
+    assert any(item["amount"] == 300.0 and item["scenario_id"]
+               == sid for item in data)

tests/unit/test_reporting.py

@@ -1,15 +1,38 @@
-from services.reporting import generate_report
-from routes.reporting import router
 from fastapi.testclient import TestClient
-from main import app
 import pytest
 
-# Function test
+from main import app
+from services.reporting import generate_report
+
+
 def test_generate_report_empty():
     report = generate_report([])
-    assert isinstance(report, dict)
+    assert report == {
+        "count": 0,
+        "mean": 0.0,
+        "median": 0.0,
+        "min": 0.0,
+        "max": 0.0,
+        "std_dev": 0.0,
+        "percentile_10": 0.0,
+        "percentile_90": 0.0,
+    }
+
+
+def test_generate_report_with_values():
+    values = [{"iteration": 1, "result": 10.0}, {
+        "iteration": 2, "result": 20.0}, {"iteration": 3, "result": 30.0}]
+    report = generate_report(values)
+    assert report["count"] == 3
+    assert report["mean"] == pytest.approx(20.0)
+    assert report["median"] == pytest.approx(20.0)
+    assert report["min"] == pytest.approx(10.0)
+    assert report["max"] == pytest.approx(30.0)
+    assert report["std_dev"] == pytest.approx(8.1649658, rel=1e-6)
+    assert report["percentile_10"] == pytest.approx(12.0)
+    assert report["percentile_90"] == pytest.approx(28.0)
+
 
-# Endpoint test
 def test_reporting_endpoint_invalid_input():
     client = TestClient(app)
     resp = client.post("/api/reporting/summary", json={})
@@ -19,9 +42,29 @@ def test_reporting_endpoint_invalid_input():
 
 def test_reporting_endpoint_success():
     client = TestClient(app)
-    # Minimal input: list of dicts
-    input_data = [{"iteration": 1, "result": 10.0}]
+    input_data = [
+        {"iteration": 1, "result": 10.0},
+        {"iteration": 2, "result": 20.0},
+        {"iteration": 3, "result": 30.0},
+    ]
     resp = client.post("/api/reporting/summary", json=input_data)
     assert resp.status_code == 200
     data = resp.json()
-    assert isinstance(data, dict)
+    assert data["count"] == 3
+    assert data["mean"] == pytest.approx(20.0)
+
+
+@pytest.mark.parametrize(
+    "payload,expected_detail",
+    [
+        (["not-a-dict"], "Entry at index 0 must be an object"),
+        ([{"iteration": 1}], "Entry at index 0 must include numeric 'result'"),
+        ([{"iteration": 1, "result": "bad"}],
+         "Entry at index 0 must include numeric 'result'"),
+    ],
+)
+def test_reporting_endpoint_validation_errors(payload, expected_detail):
+    client = TestClient(app)
+    resp = client.post("/api/reporting/summary", json=payload)
+    assert resp.status_code == 400
+    assert resp.json()["detail"] == expected_detail