chore(infra): contenedores, despliegue y scripts de arranque local

Añade Dockerfiles de backend y UI, docker-compose, render.yaml para el despliegue gratuito y los scripts PowerShell de arranque local sin Docker (run_backend, run_ui, dev) que usan 'python -m uvicorn' para evitar los shims .exe bloqueados por OneDrive. Incluye placeholders de models/ y sample_data/.

backend/Dockerfile

@@ -0,0 +1,23 @@
+# Imagen del backend FastAPI del MVP (CPU).
+FROM ghcr.io/astral-sh/uv:python3.13-bookworm-slim
+
+WORKDIR /app
+
+# Instalar dependencias de producción desde el manifiesto
+COPY pyproject.toml ./
+RUN uv sync --no-dev
+
+COPY backend/ ./backend/
+
+# Para ACTIVAR el conteo: descargar el modelo desde Hugging Face Hub en el build.
+# (Mientras COUNTING_ENABLED=false el backend funciona en standby y no requiere modelo.)
+# ARG MODEL_VERSION=2.0.0
+# RUN uv run python -c "from huggingface_hub import hf_hub_download; \
+#   hf_hub_download(repo_id='<org>/agrovision-plantcount', \
+#   filename='agrovision-plantcount-v${MODEL_VERSION}.onnx', local_dir='/app/models')"
+
+ENV COUNTING_ENABLED=false
+ENV MODEL_PATH=/app/models/agrovision-plantcount-v2.0.0.onnx
+ENV MODEL_VERSION=2.0.0
+EXPOSE 8000
+CMD ["uv", "run", "uvicorn", "backend.main:app", "--host", "0.0.0.0", "--port", "8000"]

docker-compose.yml

@@ -0,0 +1,32 @@
+# Stack local del MVP: backend FastAPI (api) + UI Shiny (ui).
+# El conteo arranca en standby (COUNTING_ENABLED=false); la app levanta igual.
+services:
+  api:
+    build:
+      context: .
+      dockerfile: backend/Dockerfile
+    ports:
+      - "8000:8000"
+    environment:
+      - COUNTING_ENABLED=false
+      - ALLOWED_ORIGINS=http://localhost:8001
+    volumes:
+      - ./models:/app/models:ro
+      - ./sample_data:/app/sample_data:ro
+    healthcheck:
+      test: ["CMD-SHELL", "python -c \"import urllib.request; urllib.request.urlopen('http://localhost:8000/api/status')\""]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  ui:
+    build:
+      context: .
+      dockerfile: frontend/Dockerfile
+    ports:
+      - "8001:8001"
+    environment:
+      - API_BASE_URL=http://api:8000
+    depends_on:
+      api:
+        condition: service_healthy

frontend/Dockerfile

@@ -0,0 +1,13 @@
+# Imagen de la UI Shiny for Python del MVP.
+FROM ghcr.io/astral-sh/uv:python3.13-bookworm-slim
+
+WORKDIR /app
+
+COPY pyproject.toml ./
+RUN uv sync --no-dev
+
+COPY frontend/ ./frontend/
+
+ENV API_BASE_URL=http://localhost:8000
+EXPOSE 8001
+CMD ["uv", "run", "shiny", "run", "frontend/app.py", "--host", "0.0.0.0", "--port", "8001"]

models/.gitkeep

@@ -0,0 +1,2 @@
+# Carpeta para el artefacto del modelo (agrovision-plantcount-*.onnx).
+# Los pesos NO se versionan: se descargan de Hugging Face Hub en el build.

render.yaml

@@ -0,0 +1,16 @@
+# Despliegue del backend del MVP en Render (capa gratuita).
+# La UI Shiny se despliega aparte en ShinyApps.io (rsconnect deploy shiny ./frontend).
+services:
+  - type: web
+    name: agrovision-mvp-api
+    runtime: docker
+    dockerfilePath: ./backend/Dockerfile
+    plan: free
+    healthCheckPath: /api/status
+    envVars:
+      - key: COUNTING_ENABLED
+        value: "false"                       # true cuando el modelo esté publicado
+      - key: ALLOWED_ORIGINS
+        value: https://<tu-app>.shinyapps.io
+      - key: MODEL_VERSION
+        value: "2.0.0"

sample_data/README.md

@@ -0,0 +1,7 @@
+# sample_data
+
+Ortomosaicos de ejemplo para probar el conteo localmente (cuando el módulo deje el modo *standby*).
+
+- Las imágenes (`*.png`, `*.jpg`, `*.tif`) **no se versionan** (ver `.gitignore`).
+- Coloca aquí un ortomosaico de arándano de prueba, p. ej. `lote_demo.png`.
+- El conteo se activa con `COUNTING_ENABLED=true` y el modelo publicado en Hugging Face Hub.

scripts/dev.ps1

@@ -0,0 +1,8 @@
+# Arranca backend + UI en ventanas PowerShell separadas (local, sin Docker).
+# Uso:  ./scripts/dev.ps1
+Start-Process powershell -ArgumentList "-NoExit", "-File", "`"$PSScriptRoot\run_backend.ps1`""
+Start-Sleep -Seconds 2
+Start-Process powershell -ArgumentList "-NoExit", "-File", "`"$PSScriptRoot\run_ui.ps1`""
+
+Write-Host "Backend:  http://127.0.0.1:8000/api/status"
+Write-Host "UI Shiny: http://127.0.0.1:8001"

scripts/run_backend.ps1

@@ -0,0 +1,11 @@
+# Levanta el backend FastAPI del MVP en local (sin Docker), en http://127.0.0.1:8000
+Set-Location (Split-Path -Parent $PSScriptRoot)
+
+# Entorno virtual fuera de OneDrive (evita errores de hardlink/lock en carpetas sincronizadas)
+$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

scripts/run_ui.ps1

@@ -0,0 +1,9 @@
+# Levanta la UI Shiny del MVP en local (sin Docker), en http://127.0.0.1:8001
+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
+# 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