feat: melhorando o run do projeto

Author: felipementel

README.md

@@ -122,7 +122,7 @@ desenvolvimento:
 
 ```bash
 uv python install 3.14
-uv sync --extra dev
+uv sync --project source --extra dev --active
 ```
 
 ### Executar a API
@@ -214,11 +214,11 @@ Caso prefira utilizar o fluxo tradicional com `pip` e `venv`, execute dentro da
 ### Passos rapidos (Linux / macOS / Bash)
 
 ```bash
-python -m venv .venv
-source .venv/bin/activate
-python -m pip install --upgrade pip
-pip install -e .[dev]
-python src/main.py
+python3 -m venv source/.venv
+source ./source/.venv/bin/activate
+python3 -m pip install --upgrade pip
+pip install -e "./source[dev]"
+python3 source/src/main.py
 ```
 
 ### Passo a passo detalhado
@@ -228,27 +228,27 @@ python src/main.py
 No Linux / macOS (Bash):
 
 ```bash
-python -m venv .venv
+python3 -m venv source/.venv
 ```
 
 No Windows (PowerShell):
 
 ```powershell
-py -3.14 -m venv .venv
+py -3.14 -m venv source/.venv
 ```
 
 #### 2. Ativar o ambiente virtual
 
 No Linux / macOS (Bash):
 
 ```bash
-source .venv/bin/activate
+source source/.venv/bin/activate
 ```
 
 No Windows (PowerShell):
 
 ```powershell
-.\.venv\Scripts\Activate.ps1
+.\source\.venv\Scripts\Activate.ps1
 ```
 
 Se o PowerShell bloquear a execucao de scripts, rode uma vez:

source/src/main.py

@@ -39,5 +39,9 @@ def create_app(user_service: UserService | None = None) -> FastAPI:
 app = create_app()
 
 
+import os
+
 if __name__ == "__main__":
-    uvicorn.run(app, host="0.0.0.0", port=8080)  # nosec B104 - intentional in container
+    host = os.getenv("UVICORN_HOST", os.getenv("HOST", "0.0.0.0"))
+    port = int(os.getenv("UVICORN_PORT", os.getenv("PORT", "8080")))
+    uvicorn.run(app, host=host, port=port)