chore: configuración inicial del proyecto y tooling

Inicializa el manifiesto del MVP (pyproject con uv, ruff y pytest), el lockfile reproducible, la plantilla .env.example, los hooks de pre-commit y el .gitignore que excluye docs internos, secretos y pesos de modelo. El entorno se crea fuera de OneDrive con link-mode=copy.

.env.example

@@ -0,0 +1,22 @@
+# ===== AgroVisión MVP — variables de entorno (plantilla) =====
+# Copia este archivo a .env para desarrollo local. NO pongas secretos reales aquí.
+
+APP_ENV=development
+LOG_LEVEL=info
+
+# --- UI (Shiny) ---
+SHINY_PORT=8001
+API_BASE_URL=http://localhost:8000        # En prod: URL pública del backend en Render
+
+# --- Backend (FastAPI) ---
+API_PORT=8000
+ALLOWED_ORIGINS=http://localhost:8001,https://<tu-app>.shinyapps.io
+CONFIDENCE_THRESHOLD=0.25
+MAX_UPLOAD_MB=50
+
+# --- Modelo de conteo (agnóstico; en STANDBY hasta publicar el artefacto) ---
+COUNTING_ENABLED=false                     # true cuando el modelo esté publicado en HF Hub
+MODEL_PATH=/app/models/agrovision-plantcount-v2.0.0.onnx
+MODEL_VERSION=2.0.0
+MODEL_ARCHITECTURE=yolo26n                 # yolo26n | rfdetr_nano (define el adaptador de decode)
+HF_MODEL_REPO=<org>/agrovision-plantcount  # repo de modelos en Hugging Face Hub

.gitignore

@@ -0,0 +1,117 @@
+# ===== AgroVision =====
+
+# --- Environment & Secrets ---
+.env
+.env.local
+.env.*.local
+*.secret
+.pnpm-debug.log*
+
+# --- Python & Backend ---
+__pycache__/
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.ipynb_checkpoints/
+.cache/
+*.py[cod]
+*$py.class
+.venv/
+env/
+venv/
+ENV/
+build/
+dist/
+*.egg-info/
+
+# --- Astro & Node.js (Frontend) ---
+frontend/node_modules/
+frontend/dist/
+frontend/.astro/
+frontend/.vercel/
+frontend/.netlify/
+frontend/npm-debug.log*
+frontend/yarn-debug.log*
+frontend/yarn-error.log*
+frontend/pnpm-debug.log*
+
+# --- Build Artifacts ---
+backend/static/
+backend/static/*
+!backend/static/.gitkeep
+
+# --- Data & SQLite ---
+data/*
+!data/README.md
+var/*.db
+var/*.sqlite
+*.db
+*.sqlite
+*.csv
+*.xlsx
+*.parquet
+*.json
+!package.json
+!tsconfig.json
+!docs/**/*.csv
+!docs/**/*.json
+
+# --- Model artifacts (descargados de Hugging Face Hub; NO versionar) ---
+models/*.onnx
+models/*.pt
+!models/.gitkeep
+
+# --- OS & IDE ---
+.vscode/*
+!.vscode/extensions.json
+!.vscode/settings.json
+!.vscode/launch.json
+.idea/
+*.swp
+*.swo
+Thumbs.db
+Desktop.ini
+.DS_Store
+
+# --- AI Agents & Tools ---
+.claude/
+.agents/
+.opencode/
+graphify-out/
+CLAUDE.md
+AGENTS.md
+.antigravityignore
+.claudeignore
+.graphifyignore
+opencode.json
+
+# --- Multimedia & Docs Exceptions ---
+*.jpg
+*.png
+*.jpeg
+*.mp4
+*.webp
+*.gif
+!/docs/image/
+!/docs/image/*.png
+!/docs/image/*.jpg
+!/docs/image/*.jpeg
+!/docs/image/*.csv
+
+# --- Temporary & Scratch ---
+scratch/
+.hypothesis/
+
+# --- Docs internos: NO versionar en git, pero SÍ legibles localmente / por Claude ---
+# (El .gitignore solo afecta a git; la lectura de archivos por herramientas/Claude es independiente.)
+docs/doc_guia/
+docs/investigation/
+docs/plan/
+docs/task/
+
+# Playwright MCP artifacts
+.playwright-mcp/
+localhost-*.png
+section5*.png
+desactivar-*.png
+download-*.png

.pre-commit-config.yaml

@@ -0,0 +1,9 @@
+# Hooks de calidad: ejecutan Ruff (lint + formato) antes de cada commit.
+# Instalar una vez: uv run pre-commit install
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.6.9
+    hooks:
+      - id: ruff          # linter (con autocorrección)
+        args: [--fix]
+      - id: ruff-format   # formateador

pyproject.toml

@@ -0,0 +1,47 @@
+[project]
+name = "agrovision-mvp"
+version = "0.1.0"
+description = "MVP de AgroVisión: UI Shiny + backend FastAPI para conteo de plantas (modelo agnóstico, en standby)."
+requires-python = ">=3.11"
+dependencies = [
+    "fastapi>=0.115",
+    "uvicorn[standard]>=0.34",
+    "python-multipart>=0.0.9",       # requerido por FastAPI para multipart/form-data
+    "pydantic>=2.7",
+    "shiny>=1.2",
+    "httpx>=0.27",
+    "python-dotenv>=1.0",            # carga .env en desarrollo local
+    "onnxruntime>=1.18",             # inferencia ONNX genérica (agnóstica al modelo)
+    "opencv-python-headless>=4.9",
+    "pillow>=10.0",
+    "numpy>=2.1",                    # >=2.1 trae wheels para Python 3.13
+    "supervision>=0.20",             # tiling/anotación de cajas (uso futuro al activar el conteo)
+    "huggingface_hub>=0.24",         # descarga del modelo desde HF Hub en el build
+]
+
+[dependency-groups]
+dev = [
+    "pytest>=8",
+    "ruff>=0.6",
+    "playwright>=1.45",
+]
+
+[tool.uv]
+# La carpeta del repo está sincronizada por OneDrive: usar copia evita errores de hardlink.
+link-mode = "copy"
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]
+
+[tool.ruff.lint.flake8-bugbear]
+# FastAPI usa estas llamadas en valores por defecto de argumentos (patrón idiomático).
+extend-immutable-calls = ["fastapi.File", "fastapi.Form", "fastapi.Depends", "fastapi.Query"]
+
+[tool.pytest.ini_options]
+pythonpath = ["."]
+testpaths = ["tests"]
+addopts = "-q"