docs(ejecucion)+scripts: arranque manual con -u/PYTHONUNBUFFERED, --log-level y --reload-exclude por capa

- Option B del runbook y los launchers usan python -u + PYTHONUNBUFFERED=1 (logs en vivo),
--log-level info y --reload-exclude para no reiniciar por dirs no-fuente.
- Cada servicio excluye la capa del otro (backend ignora frontend/ y viceversa) + docs/tests/etc.
- Verificado: el backend arranca con el comando completo (HTTP 200).

docs/ejecucion.md

@@ -87,17 +87,27 @@ cp .env.example .env
 
 > Se usa `python -m uvicorn` (no los shims `uvicorn.exe`/`shiny.exe`, que OneDrive bloquea).
 > La app Shiny es ASGI, por lo que `uvicorn frontend.app:app` equivale a `shiny run frontend/app.py`.
+>
+> **Flags útiles:** `PYTHONUNBUFFERED=1` + `python -u` → logs en vivo sin buffer. `--log-level info` → trazas de cada request. `--reload-exclude` → evita reinicios por cambios en carpetas que no son código de ese servicio (cada servicio **excluye la capa del otro**: el backend ignora `frontend/` y viceversa, además de `docs/`, `tests/`, etc.). *(No usamos `alembic`; las migraciones son SQL en `supabase/migrations`.)*
 
 **Terminal 1 — Backend / API:**
 ```powershell
 $env:UV_PROJECT_ENVIRONMENT = "$env:LOCALAPPDATA\agrovision-venv"
-uv run python -m uvicorn backend.main:app --host 127.0.0.1 --port 8000 --reload
+$env:PYTHONUNBUFFERED = "1"
+uv run python -u -m uvicorn backend.main:app --host 127.0.0.1 --port 8000 --reload --log-level info `
+  --reload-exclude ".venv" --reload-exclude "frontend" --reload-exclude "docs" `
+  --reload-exclude "tests" --reload-exclude "scripts" --reload-exclude "supabase" `
+  --reload-exclude "models" --reload-exclude "sample_data" --reload-exclude "scratch"
 ```
 
 **Terminal 2 — UI (Shiny):**
 ```powershell
 $env:UV_PROJECT_ENVIRONMENT = "$env:LOCALAPPDATA\agrovision-venv"
-uv run python -m uvicorn frontend.app:app --host 127.0.0.1 --port 8001 --reload
+$env:PYTHONUNBUFFERED = "1"
+uv run python -u -m uvicorn frontend.app:app --host 127.0.0.1 --port 8001 --reload --log-level info `
+  --reload-exclude ".venv" --reload-exclude "backend" --reload-exclude "docs" `
+  --reload-exclude "tests" --reload-exclude "scripts" --reload-exclude "supabase" `
+  --reload-exclude "models" --reload-exclude "sample_data" --reload-exclude "scratch"
 ```
 
 ### 3.3 Puertos y Accesos Locales

scripts/run_backend.ps1

@@ -6,6 +6,11 @@ $env:UV_PROJECT_ENVIRONMENT = "$env:LOCALAPPDATA\agrovision-venv"
 $env:UV_LINK_MODE = "copy"
 
 uv sync
-# Se usa "python -m uvicorn" (no el shim uvicorn.exe) para evitar errores de
-# ejecución en carpetas sincronizadas por OneDrive.
-uv run python -m uvicorn backend.main:app --host 127.0.0.1 --port 8000 --reload
+# Se usa "python -u -m uvicorn" (no el shim uvicorn.exe) para evitar errores de
+# ejecución en carpetas sincronizadas por OneDrive; -u/PYTHONUNBUFFERED dan logs en vivo.
+# --reload-exclude evita reinicios por cambios fuera del código del backend (incluye frontend/).
+$env:PYTHONUNBUFFERED = "1"
+uv run python -u -m uvicorn backend.main:app --host 127.0.0.1 --port 8000 --reload --log-level info `
+  --reload-exclude ".venv" --reload-exclude "frontend" --reload-exclude "docs" `
+  --reload-exclude "tests" --reload-exclude "scripts" --reload-exclude "supabase" `
+  --reload-exclude "models" --reload-exclude "sample_data" --reload-exclude "scratch"

scripts/run_ui.ps1

@@ -4,6 +4,11 @@ Set-Location (Split-Path -Parent $PSScriptRoot)
 $env:UV_PROJECT_ENVIRONMENT = "$env:LOCALAPPDATA\agrovision-venv"
 $env:UV_LINK_MODE = "copy"
 
-# La app Shiny es ASGI: se sirve con uvicorn (python -m) para evitar el shim
+# La app Shiny es ASGI: se sirve con uvicorn (python -u -m) para evitar el shim
 # shiny.exe, que OneDrive bloquea. Equivale a `shiny run frontend/app.py`.
-uv run python -m uvicorn frontend.app:app --host 127.0.0.1 --port 8001 --reload
+# --reload-exclude evita reinicios por cambios fuera del código de la UI (incluye backend/).
+$env:PYTHONUNBUFFERED = "1"
+uv run python -u -m uvicorn frontend.app:app --host 127.0.0.1 --port 8001 --reload --log-level info `
+  --reload-exclude ".venv" --reload-exclude "backend" --reload-exclude "docs" `
+  --reload-exclude "tests" --reload-exclude "scripts" --reload-exclude "supabase" `
+  --reload-exclude "models" --reload-exclude "sample_data" --reload-exclude "scratch"