fix: Dev v4 to main merge

.devcontainer/setupEnv.sh

@@ -8,7 +8,7 @@ set -e
 
 echo "Setting up Backend..."
 cd ./src/backend
-uv sync --frozen
+uv sync --frozen --extra dev
 cd ../../
 
 echo "Setting up Frontend..."

.github/workflows/test.yml

@@ -35,6 +35,11 @@ on:
       - 'src/**/pyproject.toml'
       - '.github/workflows/test.yml'
 
+permissions:
+  contents: read
+  actions: read
+  pull-requests: write
+
 jobs:
   test:
     runs-on: ubuntu-latest
@@ -71,9 +76,9 @@ jobs:
         run: |
           # Run test_app.py first (isolation required)
           python -m pytest src/tests/backend/test_app.py --cov=src/backend --cov-config=.coveragerc -q
-          
+
           # Run remaining backend tests with coverage append
-          python -m pytest src/tests/backend --cov=src/backend --cov-append --cov-report=term --cov-report=xml --cov-config=.coveragerc --ignore=src/tests/backend/test_app.py
+          python -m pytest src/tests/backend --cov=src/backend --cov-append --cov-report=term --cov-report=xml --junitxml=pytest.xml --cov-config=.coveragerc --ignore=src/tests/backend/test_app.py
 
       - name: Check coverage threshold
         if: env.skip_tests == 'false'
@@ -91,7 +96,19 @@ jobs:
             exit 1
           fi
 
+      - name: Pytest Coverage Comment
+        if: |
+          always() &&
+          github.event_name == 'pull_request' &&
+          github.event.pull_request.head.repo.fork == false &&
+          env.skip_tests == 'false'
+        uses: MishaKav/pytest-coverage-comment@26f986d2599c288bb62f623d29c2da98609e9cd4  # v1.6.0
+        with:
+          pytest-xml-coverage-path: coverage.xml
+          junitxml-path: pytest.xml
+          report-only-changed-files: true
+
       - name: Skip coverage report if no tests
         if: env.skip_tests == 'true'
         run: |
-          echo "Skipping coverage report because no tests were found."
+          echo "Skipping coverage report because no tests were found."

docs/LocalDevelopmentSetup.md

@@ -363,8 +363,8 @@ source .venv/bin/activate  # Linux/WSL2
 # or
 .\.venv\Scripts\Activate.ps1  # Windows PowerShell
 
-# Install dependencies
-uv sync --python 3.12
+# Install dependencies (--extra dev includes pytest for testing)
+uv sync --python 3.12 --extra dev
 ```
 
 **Windows users**: If you encounter issues with the `uv` command not being found, use the Python Launcher instead:
@@ -373,11 +373,11 @@ uv sync --python 3.12
 # Create virtual environment
 py -3.12 -m uv venv .venv
 
-# Install dependencies
-py -3.12 -m uv sync
+# Install dependencies (--extra dev includes pytest for testing)
+py -3.12 -m uv sync --extra dev
 ```
 
-> **⚠️ Important**: Always run `uv sync` (or `py -3.12 -m uv sync` on Windows) after creating the virtual environment to install all required dependencies. Missing dependencies will cause runtime errors like `ModuleNotFoundError: No module named 'pydantic'` or DNS resolution failures.
+> **⚠️ Important**: Always run `uv sync --extra dev` (or `py -3.12 -m uv sync --extra dev` on Windows) after creating the virtual environment to install all required dependencies. Missing dependencies will cause runtime errors like `ModuleNotFoundError: No module named 'pydantic'` or DNS resolution failures.
 
 ### 4.4. Run the Backend