10

End of phase 4

docs(TDD): Clarify FastAPI server execution and fix markdown for Phase 4

This commit enhances the Technical Design Document (Design Docs/TDD.md) by providing explicit instructions for running the FastAPI server, pertinent to the completion of Phase 4 ("Green Implementation for FastAPI"). It also includes a minor markdown syntax correction.

Key changes:
- Added a dedicated markdown block in Phase 4 with the precise command `uvicorn app_fastapi.app:app --host 127.0.0.1 --port 8000` and context for running the FastAPI application. This makes the instruction more prominent and user-friendly.
- Removed the previous, less visible comment `# Uvicorn will run this: uvicorn app_fastapi.app:app --port 8000` from within the FastAPI Python code example to avoid redundancy and improve clarity.
- Corrected markdown code block specifiers (from ``` to ````) around the FastAPI example and the new instruction block to ensure correct rendering of the document.

These changes make it easier for anyone following the TDD to manually start and test the FastAPI server as intended at the end of Phase 4, before proceeding to the benchmarking in Phase 5.

9

starting phase 4 -

8

phase 3 complete

file name updated

app_flask   app.py auto launches browser and 3000

4

Initialize project environment, dependencies, and Flask 'red' test.

This commit covers the successful completion of Phase 0 (Environment & Repo Skeleton) and Phase 1 (Red Test for Flask Home Route) as outlined in the Technical Design Document.

Key achievements include:

Phase 0:
- Successfully created and activated a Python virtual environment (.venv).
- Installed core project dependencies: Flask, FastAPI, Uvicorn, Pytest, HTTPX, and Requests.
- Corrected and finalized 'requirements.txt' to reflect these core dependencies with their specific versions.
- Scaffolded the initial project directory structure:
    - project/
        - app_flask/
        - app_fastapi/
        - tests/
        - benchmark/

Phase 1:
- Created the initial failing test file 'project/tests/test_flask_route.py'. This test is designed to fail (red state) as the Flask application endpoint is not yet implemented.
- Confirmed the expected 'red' test failure (httpx.ConnectError and ModuleNotFoundError for the non-existent app) by running the command:
  .\.venv\Scripts\python.exe -m pytest -p no:all
- Updated 'Design Docs/TDD.md' to include a detailed report of the Phase 1 verification, including the exact command used and the observed terminal output.

This establishes the baseline for Test-Driven Development, with a failing test now ready for the Flask application implementation in Phase 2.

requirements file updated

phase 0 - Complete