Enhance testing framework and UI feedback

- Updated architecture documentation to include details on UI rendering checks and Playwright end-to-end tests.
- Revised testing documentation to specify Playwright for frontend E2E tests and added details on running tests.
- Implemented feedback mechanism in scenario form for successful creation notifications.
- Added feedback div in ScenarioForm.html for user notifications.
- Created new fixtures for Playwright tests to manage server and browser instances.
- Developed comprehensive E2E tests for consumption, costs, equipment, maintenance, production, and scenarios.
- Added smoke tests to verify UI page loading and form submissions.
- Enhanced unit tests for simulation and validation, including new tests for report generation and validation errors.
- Created new test files for router validation to ensure consistent error handling.
- Established a new test suite for UI routes to validate dashboard and reporting functionalities.
- Implemented validation tests to ensure proper handling of JSON payloads.

tests/e2e/test_consumption.py

@@ -0,0 +1,42 @@
+from uuid import uuid4
+
+from playwright.sync_api import Page, expect
+
+
+def test_consumption_form_loads(page: Page):
+    """Verify the consumption form page loads correctly."""
+    page.goto("/ui/consumption")
+    expect(page).to_have_title("CalMiner Consumption")
+    expect(page.locator("h1")).to_have_text("Consumption")
+
+
+def test_create_consumption_item(page: Page):
+    """Test creating a new consumption item through the UI."""
+    # First, create a scenario to associate the consumption with.
+    page.goto("/ui/scenarios")
+    scenario_name = f"Consumption Test Scenario {uuid4()}"
+    page.fill("input[name='name']", scenario_name)
+    page.click("button[type='submit']")
+    with page.expect_response("**/api/scenarios/"):
+        pass  # Wait for the scenario to be created
+
+    # Now, navigate to the consumption page and add an item.
+    page.goto("/ui/consumption")
+
+    # Create a consumption item.
+    consumption_desc = "Diesel for generators"
+    page.select_option("select[name='scenario_id']", label=scenario_name)
+    page.fill("input[name='description']", consumption_desc)
+    page.fill("input[name='amount']", "5000")
+    page.click("button[type='submit']")
+
+    with page.expect_response("**/api/consumption/") as response_info:
+        pass
+    assert response_info.value.status == 201
+
+    # Verify the new item appears in the table.
+    expect(page.locator(f"tr:has-text('{consumption_desc}')")).to_be_visible()
+
+    # Verify the feedback message.
+    expect(page.locator("#consumption-feedback")
+           ).to_have_text("Consumption record saved.")