Add Spanish explanatory comments across JS modules and PHP proxy

README.md

@@ -164,38 +164,6 @@ O bien con el servidor integrado de PHP desde la raiz del proyecto:
 php -S localhost:8000
 ```
 
-### 5. Despliegue con Docker (HuggingFace Spaces)
-
-El proyecto incluye un `Dockerfile` basado en `php:8.2-apache` configurado para ejecutarse en HuggingFace Spaces en el puerto `7860`.
-
-**Construir y ejecutar localmente:**
-
-```bash
-docker build -t morphos .
-docker run -p 7860:7860 morphos
-```
-
-Abrir en el navegador: `http://localhost:7860`
-
-**Variables de entorno en Docker:**
-
-La API key de HuggingFace debe estar en `api/.env` antes de construir la imagen:
-
-```text
-HF_API_KEY=tu_clave_de_huggingface
-```
-
-> En HuggingFace Spaces también puede configurarse como secreto desde *Settings → Repository secrets* para no exponerla en el repositorio.
-
-**Notas del entorno Docker:**
-
-* Apache escucha en el puerto `7860` (configurado vía `sed` sobre `ports.conf` y `000-default.conf`)
-* El script `docker-entrypoint.sh` inicializa la base de datos SQLite en `/var/www/html/data/morphos.db` al arrancar el contenedor
-* Los datos escritos en SQLite durante la ejecución **no persisten** entre reinicios del contenedor a menos que se monte un volumen externo
-* Si el Space queda en estado de error por un proceso Apache colgado, usar **Factory reboot** desde el menú del Space en HuggingFace
-
----
-
 ## Backend de IA
 
 El modelo de IA se configura desde la propia interfaz. La seleccion se guarda en `localStorage`.
@@ -259,7 +227,7 @@ La gravedad se calcula como la desviacion relativa al ancho del rango de referen
 ## Retos
 
 * Por la diversidad de unidades de medición que utilizan los diferentes fabricantes de equipos de laboratorio se incorporó una detección de unidades para su conversión y normalización
-* El modelado del output de la I.A requirió muchísimas iteraciones de formateo del prompt y harness
+* El modelado del output de la I.A requirió muchísimas iteraciones de formateo del prompt y harness para evitar alucinaciones o que envíara su proceso de pensamiento, aún requiere de mucho trabajo extra de refinamiento
 * Inicialmente quería usar proveedores de inferencia gratuita de medGemma (como featherless AI) pero fallaban continuamente, por eso decidí optar por hostear al modelo en Zero GPU de HF con la subscripción pro para la prueba de concepto
 * Incluir las librería de parseo de pdf y las fuentes en el directorio del proyecto con la intención de reducir dependencias externas estaba generando problemas con las métricas de velocidad de lighthouse que no lograba solucionar. Claude planteó implementación de caché en htacesss y pre carga de las fuentes, lo cual llevó la puntuación de 60 a 90/100 sin mayores cambios estructurales
 * Lograr una interfaz limpia y entendible requirío de muchos intentos hasta lograr un flujo de trabajo intuitivo y accsesible con la mínima friccion posible para los usuarios

SKILL.md

@@ -1,205 +0,0 @@
----
-name: hf-cli
-description: "Hugging Face Hub CLI (`hf`) for downloading, uploading, and managing models, datasets, spaces, buckets, repos, papers, jobs, and more on the Hugging Face Hub. Use when: handling authentication; managing local cache; managing Hugging Face Buckets; running or scheduling jobs on Hugging Face infrastructure; managing Hugging Face repos; discussions and pull requests; browsing models, datasets and spaces; reading, searching, or browsing academic papers; managing collections; querying datasets; configuring spaces; setting up webhooks; or deploying and managing HF Inference Endpoints. Make sure to use this skill whenever the user mentions 'hf', 'huggingface', 'Hugging Face', 'huggingface-cli', or 'hugging face cli', or wants to do anything related to the Hugging Face ecosystem and to AI and ML in general. Also use for cloud storage needs like training checkpoints, data pipelines, or agent traces. Use even if the user doesn't explicitly ask for a CLI command. Replaces the deprecated `huggingface-cli`."
----
-
-Install: `curl -LsSf https://hf.co/cli/install.sh | bash -s`.
-
-The Hugging Face Hub CLI tool `hf` is available. IMPORTANT: The `hf` command replaces the deprecated `huggingface-cli` command.
-
-Use `hf --help` to view available functions. Note that auth commands are now all under `hf auth` e.g. `hf auth whoami`.
-
-Generated with `huggingface_hub v1.13.0`. Run `hf skills add --force` to regenerate.
-
-## Commands
-
-- `hf download REPO_ID` — Download files from the Hub. `[--type CHOICE --revision TEXT --include TEXT --exclude TEXT --cache-dir TEXT --local-dir TEXT --force-download --dry-run --max-workers INTEGER --format CHOICE]`
-- `hf env` — Print information about the environment. `[--format CHOICE]`
-- `hf sync` — Sync files between local directory and a bucket. `[--delete --ignore-times --ignore-sizes --plan TEXT --apply TEXT --dry-run --include TEXT --exclude TEXT --filter-from TEXT --existing --ignore-existing --verbose --format CHOICE]`
-- `hf update` — Update the `hf` CLI to the latest version. `[--format CHOICE]`
-- `hf upload REPO_ID` — Upload a file or a folder to the Hub. Recommended for single-commit uploads. `[--type CHOICE --revision TEXT --private --include TEXT --exclude TEXT --delete TEXT --commit-message TEXT --commit-description TEXT --create-pr --every FLOAT --format CHOICE]`
-- `hf upload-large-folder REPO_ID LOCAL_PATH` — Upload a large folder to the Hub. Recommended for resumable uploads. `[--type CHOICE --revision TEXT --private --include TEXT --exclude TEXT --num-workers INTEGER --no-report --no-bars --format CHOICE]`
-- `hf version` — Print information about the hf version. `[--format CHOICE]`
-
-### `hf auth` — Manage authentication (login, logout, etc.).
-
-- `hf auth list` — List all stored access tokens. `[--format CHOICE]`
-- `hf auth login` — Login using a token from huggingface.co/settings/tokens. `[--add-to-git-credential --force --format CHOICE]`
-- `hf auth logout` — Logout from a specific token. `[--token-name TEXT --format CHOICE]`
-- `hf auth switch` — Switch between access tokens. `[--token-name TEXT --add-to-git-credential --format CHOICE]`
-- `hf auth token` — Print the current access token to stdout. `[--format CHOICE]`
-- `hf auth whoami` — Find out which huggingface.co account you are logged in as. `[--format CHOICE]`
-
-### `hf buckets` — Commands to interact with buckets.
-
-- `hf buckets cp SRC` — Copy files to or from buckets. `[--format CHOICE]`
-- `hf buckets create BUCKET_ID` — Create a new bucket. `[--private --exist-ok --format CHOICE]`
-- `hf buckets delete BUCKET_ID` — Delete a bucket. `[--yes --missing-ok --format CHOICE]`
-- `hf buckets info BUCKET_ID` — Get info about a bucket. `[--format CHOICE]`
-- `hf buckets list` — List buckets or files in a bucket. `[--human-readable --tree --recursive --search TEXT --format CHOICE]`
-- `hf buckets move FROM_ID TO_ID` — Move (rename) a bucket to a new name or namespace. `[--format CHOICE]`
-- `hf buckets remove ARGUMENT` — Remove files from a bucket. `[--recursive --yes --dry-run --include TEXT --exclude TEXT --format CHOICE]`
-- `hf buckets sync` — Sync files between local directory and a bucket. `[--delete --ignore-times --ignore-sizes --plan TEXT --apply TEXT --dry-run --include TEXT --exclude TEXT --filter-from TEXT --existing --ignore-existing --verbose --format CHOICE]`
-
-### `hf cache` — Manage local cache directory.
-
-- `hf cache list` — List cached repositories or revisions. `[--cache-dir TEXT --revisions --filter TEXT --sort CHOICE --limit INTEGER --format CHOICE]`
-- `hf cache prune` — Remove detached revisions from the cache. `[--cache-dir TEXT --yes --dry-run --format CHOICE]`
-- `hf cache rm TARGETS` — Remove cached repositories or revisions. `[--cache-dir TEXT --yes --dry-run --format CHOICE]`
-- `hf cache verify REPO_ID` — Verify checksums for a single repo revision from cache or a local directory. `[--type CHOICE --revision TEXT --cache-dir TEXT --local-dir TEXT --fail-on-missing-files --fail-on-extra-files --format CHOICE]`
-
-### `hf collections` — Interact with collections on the Hub.
-
-- `hf collections add-item COLLECTION_SLUG ITEM_ID ITEM_TYPE` — Add an item to a collection. `[--note TEXT --exists-ok --format CHOICE]`
-- `hf collections create TITLE` — Create a new collection on the Hub. `[--namespace TEXT --description TEXT --private --exists-ok --format CHOICE]`
-- `hf collections delete COLLECTION_SLUG` — Delete a collection from the Hub. `[--missing-ok --format CHOICE]`
-- `hf collections delete-item COLLECTION_SLUG ITEM_OBJECT_ID` — Delete an item from a collection. `[--missing-ok --format CHOICE]`
-- `hf collections info COLLECTION_SLUG` — Get info about a collection on the Hub. `[--format CHOICE]`
-- `hf collections list` — List collections on the Hub. `[--owner TEXT --item TEXT --sort CHOICE --limit INTEGER --format CHOICE]`
-- `hf collections update COLLECTION_SLUG` — Update a collection's metadata on the Hub. `[--title TEXT --description TEXT --position INTEGER --private --theme TEXT --format CHOICE]`
-- `hf collections update-item COLLECTION_SLUG ITEM_OBJECT_ID` — Update an item in a collection. `[--note TEXT --position INTEGER --format CHOICE]`
-
-### `hf datasets` — Interact with datasets on the Hub.
-
-- `hf datasets card DATASET_ID` — Get the dataset card (README) for a dataset on the Hub. `[--metadata --text --format CHOICE]`
-- `hf datasets info DATASET_ID` — Get info about a dataset on the Hub. `[--revision TEXT --expand TEXT --format CHOICE]`
-- `hf datasets leaderboard DATASET_ID` — List model scores from a dataset leaderboard. This command helps find the best models for a task or compare models by benchmark scores. `[--limit INTEGER --format CHOICE]`
-- `hf datasets list` — List datasets on the Hub, or files in a dataset repo. `[--search TEXT --author TEXT --filter TEXT --sort CHOICE --limit INTEGER --expand TEXT --human-readable --tree --recursive --revision TEXT --format CHOICE]`
-- `hf datasets parquet DATASET_ID` — List parquet file URLs available for a dataset. `[--subset TEXT --split TEXT --format CHOICE]`
-- `hf datasets sql SQL` — Execute a raw SQL query with DuckDB against dataset parquet URLs. `[--format CHOICE]`
-
-### `hf discussions` — Manage discussions and pull requests on the Hub.
-
-- `hf discussions close REPO_ID NUM` — Close a discussion or pull request. `[--comment TEXT --yes --type CHOICE --format CHOICE]`
-- `hf discussions comment REPO_ID NUM` — Comment on a discussion or pull request. `[--body TEXT --body-file PATH --type CHOICE --format CHOICE]`
-- `hf discussions create REPO_ID --title TEXT` — Create a new discussion or pull request on a repo. `[--body TEXT --body-file PATH --pull-request --type CHOICE --format CHOICE]`
-- `hf discussions diff REPO_ID NUM` — Show the diff of a pull request. `[--type CHOICE --format CHOICE]`
-- `hf discussions info REPO_ID NUM` — Get info about a discussion or pull request. `[--type CHOICE --format CHOICE]`
-- `hf discussions list REPO_ID` — List discussions and pull requests on a repo. `[--status CHOICE --kind CHOICE --author TEXT --limit INTEGER --type CHOICE --format CHOICE]`
-- `hf discussions merge REPO_ID NUM` — Merge a pull request. `[--comment TEXT --yes --type CHOICE --format CHOICE]`
-- `hf discussions rename REPO_ID NUM NEW_TITLE` — Rename a discussion or pull request. `[--type CHOICE --format CHOICE]`
-- `hf discussions reopen REPO_ID NUM` — Reopen a closed discussion or pull request. `[--comment TEXT --yes --type CHOICE --format CHOICE]`
-
-### `hf endpoints` — Manage Hugging Face Inference Endpoints.
-
-- `hf endpoints catalog deploy --repo TEXT` — Deploy an Inference Endpoint from the Model Catalog. `[--name TEXT --accelerator TEXT --namespace TEXT --format CHOICE]`
-- `hf endpoints catalog list` — List available Catalog models. `[--format CHOICE]`
-- `hf endpoints delete NAME` — Delete an Inference Endpoint permanently. `[--namespace TEXT --yes --format CHOICE]`
-- `hf endpoints deploy NAME --repo TEXT --framework TEXT --accelerator TEXT --instance-size TEXT --instance-type TEXT --region TEXT --vendor TEXT` — Deploy an Inference Endpoint from a Hub repository. `[--namespace TEXT --task TEXT --min-replica INTEGER --max-replica INTEGER --scale-to-zero-timeout INTEGER --scaling-metric CHOICE --scaling-threshold FLOAT --format CHOICE]`
-- `hf endpoints describe NAME` — Get information about an existing endpoint. `[--namespace TEXT --format CHOICE]`
-- `hf endpoints list` — Lists all Inference Endpoints for the given namespace. `[--namespace TEXT --format CHOICE]`
-- `hf endpoints pause NAME` — Pause an Inference Endpoint. `[--namespace TEXT --format CHOICE]`
-- `hf endpoints resume NAME` — Resume an Inference Endpoint. `[--namespace TEXT --fail-if-already-running --format CHOICE]`
-- `hf endpoints scale-to-zero NAME` — Scale an Inference Endpoint to zero. `[--namespace TEXT --format CHOICE]`
-- `hf endpoints update NAME` — Update an existing endpoint. `[--namespace TEXT --repo TEXT --accelerator TEXT --instance-size TEXT --instance-type TEXT --framework TEXT --revision TEXT --task TEXT --min-replica INTEGER --max-replica INTEGER --scale-to-zero-timeout INTEGER --scaling-metric CHOICE --scaling-threshold FLOAT --format CHOICE]`
-
-### `hf extensions` — Manage hf CLI extensions.
-
-- `hf extensions exec NAME` — Execute an installed extension.
-- `hf extensions install REPO_ID` — Install an extension from a public GitHub repository. `[--force --format CHOICE]`
-- `hf extensions list` — List installed extension commands. `[--format CHOICE]`
-- `hf extensions remove NAME` — Remove an installed extension. `[--format CHOICE]`
-- `hf extensions search` — Search extensions available on GitHub (tagged with 'hf-extension' topic). `[--format CHOICE]`
-
-### `hf jobs` — Run and manage Jobs on the Hub.
-
-- `hf jobs cancel JOB_ID` — Cancel a Job `[--namespace TEXT --format CHOICE]`
-- `hf jobs hardware` — List available hardware options for Jobs `[--format CHOICE]`
-- `hf jobs inspect JOB_IDS` — Display detailed information on one or more Jobs `[--namespace TEXT --format CHOICE]`
-- `hf jobs logs JOB_ID` — Fetch the logs of a Job. `[--follow --tail INTEGER --namespace TEXT --format CHOICE]`
-- `hf jobs ps` — List Jobs. `[--all --namespace TEXT --filter TEXT --format TEXT --quiet]`
-- `hf jobs run IMAGE COMMAND` — Run a Job. `[--env TEXT --secrets TEXT --label TEXT --volume TEXT --env-file TEXT --secrets-file TEXT --flavor CHOICE --timeout TEXT --detach --namespace TEXT]`
-- `hf jobs scheduled delete SCHEDULED_JOB_ID` — Delete a scheduled Job. `[--namespace TEXT --format CHOICE]`
-- `hf jobs scheduled inspect SCHEDULED_JOB_IDS` — Display detailed information on one or more scheduled Jobs `[--namespace TEXT --format CHOICE]`
-- `hf jobs scheduled ps` — List scheduled Jobs `[--all --namespace TEXT --filter TEXT --format TEXT --quiet]`
-- `hf jobs scheduled resume SCHEDULED_JOB_ID` — Resume (unpause) a scheduled Job. `[--namespace TEXT --format CHOICE]`
-- `hf jobs scheduled run SCHEDULE IMAGE COMMAND` — Schedule a Job. `[--suspend --concurrency --env TEXT --secrets TEXT --label TEXT --volume TEXT --env-file TEXT --secrets-file TEXT --flavor CHOICE --timeout TEXT --namespace TEXT]`
-- `hf jobs scheduled suspend SCHEDULED_JOB_ID` — Suspend (pause) a scheduled Job. `[--namespace TEXT --format CHOICE]`
-- `hf jobs scheduled uv run SCHEDULE SCRIPT` — Run a UV script (local file or URL) on HF infrastructure `[--suspend --concurrency --image TEXT --flavor CHOICE --env TEXT --secrets TEXT --label TEXT --volume TEXT --env-file TEXT --secrets-file TEXT --timeout TEXT --namespace TEXT --with TEXT --python TEXT]`
-- `hf jobs stats` — Fetch the resource usage statistics and metrics of Jobs `[--namespace TEXT --format CHOICE]`
-- `hf jobs uv run SCRIPT` — Run a UV script (local file or URL) on HF infrastructure `[--image TEXT --flavor CHOICE --env TEXT --secrets TEXT --label TEXT --volume TEXT --env-file TEXT --secrets-file TEXT --timeout TEXT --detach --namespace TEXT --with TEXT --python TEXT]`
-
-### `hf models` — Interact with models on the Hub.
-
-- `hf models card MODEL_ID` — Get the model card (README) for a model on the Hub. `[--metadata --text --format CHOICE]`
-- `hf models info MODEL_ID` — Get info about a model on the Hub. `[--revision TEXT --expand TEXT --format CHOICE]`
-- `hf models list` — List models on the Hub, or files in a model repo. `[--search TEXT --author TEXT --filter TEXT --num-parameters TEXT --sort CHOICE --limit INTEGER --expand TEXT --human-readable --tree --recursive --revision TEXT --format CHOICE]`
-
-### `hf papers` — Interact with papers on the Hub.
-
-- `hf papers info PAPER_ID` — Get info about a paper on the Hub. `[--format CHOICE]`
-- `hf papers list` — List daily papers on the Hub. `[--date TEXT --week TEXT --month TEXT --submitter TEXT --sort CHOICE --limit INTEGER --format CHOICE]`
-- `hf papers read PAPER_ID` — Read a paper as markdown. `[--format CHOICE]`
-- `hf papers search QUERY` — Search papers on the Hub. `[--limit INTEGER --format CHOICE]`
-
-### `hf repos` — Manage repos on the Hub.
-
-- `hf repos branch create REPO_ID BRANCH` — Create a new branch for a repo on the Hub. `[--revision TEXT --type CHOICE --exist-ok --format CHOICE]`
-- `hf repos branch delete REPO_ID BRANCH` — Delete a branch from a repo on the Hub. `[--type CHOICE --format CHOICE]`
-- `hf repos create REPO_ID` — Create a new repo on the Hub. `[--type CHOICE --space-sdk TEXT --private --public --protected --exist-ok --resource-group-id TEXT --flavor CHOICE --storage CHOICE --sleep-time INTEGER --secrets TEXT --secrets-file TEXT --env TEXT --env-file TEXT --volume TEXT --format CHOICE]`
-- `hf repos delete REPO_ID` — Delete a repo from the Hub. This is an irreversible operation. `[--type CHOICE --missing-ok --yes --format CHOICE]`
-- `hf repos delete-files REPO_ID PATTERNS` — Delete files from a repo on the Hub. `[--type CHOICE --revision TEXT --commit-message TEXT --commit-description TEXT --create-pr --format CHOICE]`
-- `hf repos duplicate FROM_ID` — Duplicate a repo on the Hub (model, dataset, or Space). `[--type CHOICE --private --public --protected --exist-ok --flavor CHOICE --storage CHOICE --sleep-time INTEGER --secrets TEXT --secrets-file TEXT --env TEXT --env-file TEXT --volume TEXT --format CHOICE]`
-- `hf repos move FROM_ID TO_ID` — Move a repository from a namespace to another namespace. `[--type CHOICE --format CHOICE]`
-- `hf repos settings REPO_ID` — Update the settings of a repository. `[--gated CHOICE --private --public --protected --type CHOICE --format CHOICE]`
-- `hf repos tag create REPO_ID TAG` — Create a tag for a repo. `[--message TEXT --revision TEXT --type CHOICE --format CHOICE]`
-- `hf repos tag delete REPO_ID TAG` — Delete a tag for a repo. `[--yes --type CHOICE --format CHOICE]`
-- `hf repos tag list REPO_ID` — List tags for a repo. `[--type CHOICE --format CHOICE]`
-
-### `hf skills` — Manage skills for AI assistants.
-
-- `hf skills add` — Download a Hugging Face skill and install it for an AI assistant. `[--claude --global --dest PATH --force --format CHOICE]`
-- `hf skills preview` — Print the generated `hf-cli` SKILL.md to stdout. `[--format CHOICE]`
-- `hf skills upgrade` — Upgrade installed Hugging Face marketplace skills. `[--claude --global --dest PATH --format CHOICE]`
-
-### `hf spaces` — Interact with spaces on the Hub.
-
-- `hf spaces card SPACE_ID` — Get the Space card (README) for a Space on the Hub. `[--metadata --text --format CHOICE]`
-- `hf spaces dev-mode SPACE_ID` — Enable or disable dev mode on a Space. `[--stop --format CHOICE]`
-- `hf spaces hardware` — List available hardware options for Spaces. `[--format CHOICE]`
-- `hf spaces hot-reload SPACE_ID` — Hot-reload any Python file of a Space without a full rebuild + restart. `[--local-file PATH --skip-checks --skip-summary --format CHOICE]`
-- `hf spaces info SPACE_ID` — Get info about a space on the Hub. `[--revision TEXT --expand TEXT --format CHOICE]`
-- `hf spaces list` — List spaces on the Hub, or files in a space repo. `[--search TEXT --author TEXT --filter TEXT --sort CHOICE --limit INTEGER --expand TEXT --human-readable --tree --recursive --revision TEXT --format CHOICE]`
-- `hf spaces logs SPACE_ID` — Fetch the run or build logs of a Space. `[--build --follow --tail INTEGER --format CHOICE]`
-- `hf spaces pause SPACE_ID` — Pause a Space. `[--format CHOICE]`
-- `hf spaces restart SPACE_ID` — Restart a Space. `[--factory-reboot --format CHOICE]`
-- `hf spaces search QUERY` — Search spaces on the Hub using semantic search. `[--filter TEXT --sdk TEXT --include-non-running --description --limit INTEGER --format CHOICE]`
-- `hf spaces settings SPACE_ID` — Update the settings of a Space. `[--sleep-time INTEGER --hardware CHOICE --format CHOICE]`
-- `hf spaces volumes delete SPACE_ID` — Remove all volumes from a Space. `[--yes --format CHOICE]`
-- `hf spaces volumes list SPACE_ID` — List volumes mounted in a Space. `[--format CHOICE]`
-- `hf spaces volumes set SPACE_ID` — Set (replace) volumes for a Space. `[--volume TEXT --format CHOICE]`
-
-### `hf webhooks` — Manage webhooks on the Hub.
-
-- `hf webhooks create --watch TEXT` — Create a new webhook. `[--url TEXT --job-id TEXT --domain CHOICE --secret TEXT --format CHOICE]`
-- `hf webhooks delete WEBHOOK_ID` — Delete a webhook permanently. `[--yes --format CHOICE]`
-- `hf webhooks disable WEBHOOK_ID` — Disable an active webhook. `[--format CHOICE]`
-- `hf webhooks enable WEBHOOK_ID` — Enable a disabled webhook. `[--format CHOICE]`
-- `hf webhooks info WEBHOOK_ID` — Show full details for a single webhook. `[--format CHOICE]`
-- `hf webhooks list` — List all webhooks for the current user. `[--format CHOICE]`
-- `hf webhooks update WEBHOOK_ID` — Update an existing webhook. Only provided options are changed. `[--url TEXT --watch TEXT --domain CHOICE --secret TEXT --format CHOICE]`
-
-## Common options
-
-- `--format` — Output format: `--format json` (or `--json`) or `--format table` (default).
-- `-q / --quiet` — Print only IDs (one per line).
-- `--revision` — Git revision id which can be a branch name, a tag, or a commit hash.
-- `--token` — Use a User Access Token. Prefer setting `HF_TOKEN` env var instead of passing `--token`.
-- `--type` — The type of repository (model, dataset, or space).
-
-## Mounting repos as local filesystems
-
-To mount Hub repositories or buckets as local filesystems — no download, no copy, no waiting — use `hf-mount`. Files are fetched on demand. GitHub: https://github.com/huggingface/hf-mount
-
-Install: `curl -fsSL https://raw.githubusercontent.com/huggingface/hf-mount/main/install.sh | sh`
-
-Some command examples:
-- `hf-mount start repo openai-community/gpt2 /tmp/gpt2` — mount a repo (read-only)
-- `hf-mount start --hf-token $HF_TOKEN bucket myuser/my-bucket /tmp/data` — mount a bucket (read-write)
-- `hf-mount status` / `hf-mount stop /tmp/data` — list or unmount
-
-## Tips
-
-- Use `hf <command> --help` for full options, descriptions, usage, and real-world examples
-- Authenticate with `HF_TOKEN` env var (recommended) or with `--token`
-- Update the CLI with `hf update` (uses the correct command for the detected install method)

USO_DE_IA.md

@@ -1,11 +1,12 @@
 # Uso de inteligencia artificial en el desarrollo de Morphos
+
 ## Proyecto final — Curso de Desarrollo Web 2026
 
 ---
 
 ## Modelo utilizado
 
-Se utilizó exclusivamente Claude Code (Sonnet 4.6) de Anthropic como asistente de desarrollo a lo largo de todo el proyecto.
+Se utilizó Claude Code (Sonnet 4.6) de Anthropic como asistente de desarrollo a lo largo de todo el proyecto y para el despliegue, docker y debug del comportamiento del modelo de IA se utilizó Kimi 2.6 con Open Code CLI.
 
 ---
 
@@ -21,11 +22,13 @@ El modelo actuó como ejecutor de decisiones ya tomadas, no como tomador de deci
 
 Para el motor de detección de patrones (`analisis.js`) y los datos de referencia (`valores_referencia.json`, `alteraciones.json`), se proporcionó al modelo literatura especializada en patología clínica veterinaria como contexto de generación.
 
-Los rangos de referencia por especie, los ajustes por edad, raza y sexo, las descripciones clínicas de cada alteración, y la lógica de clasificación de gravedad fueron **validados gracias a mi formación y experiencia profesional en Medicina Veterinaria**, antes de ser incorporados al código. El modelo fue un medio para estructurar y codificar ese conocimiento, no la fuente del mismo.
+Los rangos de referencia por especie, los ajustes por edad, raza y sexo, las descripciones clínicas de cada alteración, y la lógica de clasificación de gravedad fueron **validados gracias a mi formación y experiencia profesional en Medicina Veterinaria**, antes de ser incorporados al código. El modelo fue un medio para estructurar y codificar ese conocimiento, no la fuente del mismo. Se han realizado múltiples pruebas con resultados de laboratorio reales y citologías de pacientes facilitados por otros veterinarios ejercientes.
 
 Textos de referencia utilizados:
+
 - Thrall,  *Veterinary Hematology and Clinical Chemistry*, 3.ª ed. 2022
 - Weiss, — *Schalm's Veterinary Hematology*, 7.ª ed. 2022
+
 ---
 
 ## Afinamiento del prompt y control de salidas del modelo de IA
@@ -58,9 +61,11 @@ Durante las auditorías de rendimiento con Lighthouse se identificó que la carg
 Al concluir el desarrollo se realizó una auditoría asistida por IA con los siguientes objetivos:
 
 **Código muerto**
+
 - Identificación y eliminación de exportaciones sin consumidores y código que ya no era necesario o era experimental
 
 **Seguridad**
+
 - Protección de archivos sensibles (`.env`, `setup.php`) mediante `.htaccess`
 - Sanitización de datos externos de APIs con `textContent` en lugar de `innerHTML`, eliminando el riesgo de XSS
 - Validación de URLs externas antes de usarlas como atributos `href`

api/conexion.php

@@ -1,6 +1,6 @@
 <?php
 
-// Try MySQL first (local XAMPP), fallback to SQLite (Docker / HF Spaces)
+// Primero intenta conectar con MySQL (XAMPP), fallback a SQLite (Docker / HF Spaces)
 $dbHost = '127.0.0.1';
 $dbUsuario = 'root';
 $dbClave = '';
@@ -16,7 +16,6 @@ if (file_exists(__DIR__ . '/.env')) {
 
 $conexion = null;
 
-// Attempt MySQL only if not explicitly forced to SQLite
 $useSqlite = getenv('DB_FORCE_SQLITE') === '1';
 
 if (!$useSqlite) {
@@ -28,13 +27,12 @@ if (!$useSqlite) {
     }
 }
 
-// Fallback to SQLite
+// Fallback de SQLite
 if (!$conexion) {
     try {
         $conexion = new PDO("sqlite:$dbPath");
         $conexion->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
 
-        // Ensure users table exists (idempotent)
         $conexion->exec("CREATE TABLE IF NOT EXISTS usuarios (
             id INTEGER PRIMARY KEY AUTOINCREMENT,
             nombre TEXT NOT NULL,

api/hf_proxy.php

@@ -9,6 +9,7 @@ if ($_SERVER['REQUEST_METHOD'] !== 'POST') { http_response_code(405); exit; }
 
 $hfKey = $_ENV['HF_API_KEY'] ?? $_SERVER['HF_API_KEY'] ?? getenv('HF_API_KEY') ?? '';
 
+// Fallback a archivo .env si la variable de entorno no esta definida
 if (!$hfKey && file_exists(__DIR__ . '/.env')) {
     foreach (file(__DIR__ . '/.env', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES) as $line) {
         if (str_starts_with($line, 'HF_API_KEY=')) { $hfKey = trim(substr($line, 11)); break; }
@@ -30,8 +31,6 @@ function hf_get(string $url, array $headers, ?string $post = null): array {
     return [curl_exec($ch), curl_getinfo($ch, CURLINFO_HTTP_CODE)];
 }
 
-// Upload a data URL to the Gradio /upload endpoint and return a FileData object,
-// or fall back to the raw data URL format if the upload fails.
 function uploadImagen(string $space, string $hfKey, string $dataUrl): ?array {
     if (!preg_match('/^data:(image\/[\w+]+);base64,(.+)$/s', $dataUrl, $m)) return null;
     $mimeType = $m[1];
@@ -39,6 +38,7 @@ function uploadImagen(string $space, string $hfKey, string $dataUrl): ?array {
     $binary = base64_decode($m[2]);
     if ($binary === false) return null;
 
+    // Construye manualmente el cuerpo multipart para enviar la imagen al upload endpoint de Gradio
     $boundary = bin2hex(random_bytes(16));
     $body = "--$boundary\r\n"
         . "Content-Disposition: form-data; name=\"files\"; filename=\"image.$ext\"\r\n"
@@ -61,8 +61,8 @@ function uploadImagen(string $space, string $hfKey, string $dataUrl): ?array {
     $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
     curl_close($ch);
 
+    // Si el upload falla, devuelve la imagen inline para que el modelo la procese igualmente
     if ($code >= 400 || !$result) {
-        // Fall back: pass as data URL directly (older Gradio versions accept this)
         return ['url' => $dataUrl, 'orig_name' => "image.$ext", 'mime_type' => $mimeType];
     }
 
@@ -98,6 +98,7 @@ if (!$eventId) { http_response_code(502); echo json_encode(['error' => 'No se ob
 [$stream] = hf_get("$SPACE/call/analyze/$eventId", ["Authorization: Bearer $hfKey"]);
 
 $result = $error = null; $lastEvent = '';
+// Parsea el stream SSE de Gradio buscando el evento 'complete' o 'process_completed'
 foreach (explode("\n", $stream) as $raw) {
     $line = rtrim($raw, "\r");
     if (str_starts_with($line, 'event:')) $lastEvent = trim(substr($line, 6));

js/analisis.js

@@ -6,6 +6,7 @@
 const UMBRALES_GRAVEDAD = { leve: 0.5, moderado: 1.5 };
 
 const clasificarGravedad = (valor, ref) => {
+    // Mide cuantos anchos de rango de referencia se desvia el valor
     const rango = ref.superior - ref.inferior;
     const desviacion = valor > ref.superior
         ? (valor - ref.superior) / rango
@@ -98,6 +99,7 @@ const ajustarReferencias = (refsEspecie, paciente) => {
     const ajRaza = obtenerAjustesRaza(paciente.raza, paciente.especie);
     const ajSexo = AJUSTES_SEXO[paciente.especie]?.[paciente.sexo] ?? {};
 
+    // Multiplica los limites inferiores y superiores por los factores de edad, raza y sexo
     return Object.entries(refsEspecie).reduce((acc, [clave, ref]) => {
         const factorEdad = ajEdad[clave] ?? {};
         const factorRaza = ajRaza[clave] ?? {};
@@ -133,6 +135,7 @@ const detectarPatrones = (hallazgos, especie, alt) => {
     // Serie roja
 
     if (esBajo('hct') || esBajo('hgb') || esBajo('rbc')) {
+        // Clasifica el tipo de anemia segun el VCM para sugerir la etiologia mas probable
         const tipoPorVcm = !presente('vcm') ? '' :
             esBajo('vcm') ? 'microcítica' :
             esAlto('vcm') ? 'macrocítica' : 'normocítica';
@@ -160,6 +163,7 @@ const detectarPatrones = (hallazgos, especie, alt) => {
     // Serie blanca
 
     if (esAlto('wbc')) {
+        // Diferencia leucocitosis neutrofilica de linfocitica; si no hay diferencial, informa generico
         const neutrofilia = esAlto('neutro');
         const linfocitosis = esAlto('linfo');
 
@@ -329,6 +333,7 @@ const detectarPatrones = (hallazgos, especie, alt) => {
     const valSodio = valor('sodio');
     const valPotasio = valor('potasio');
 
+    // Ratio Na/K < 27 es sugestivo de hipoadrenocorticismo; la gravedad aumenta a menor ratio
     if (valSodio !== null && valPotasio !== null && valPotasio > 0) {
         const ratioNaK = valSodio / valPotasio;
         if (ratioNaK < 27) agregar({
@@ -461,6 +466,7 @@ export const analizarResultados = (valoresInput, paciente, referencias, alteraci
     const refsEspecie = referencias[paciente.especie];
     if (!refsEspecie) return { hallazgos: [], patrones: [] };
 
+    // Ajusta los rangos segun edad, raza y sexo antes de comparar
     const refsAjustadas = ajustarReferencias(refsEspecie, paciente);
     const hallazgos = [];
 

js/auth.js

@@ -103,6 +103,7 @@ function limpiarCampo(input) {
 }
 
 function activarValidacionCampo(input, reglaDeFalso) {
+    // Solo marca despues del primer blur para no agobiar al usuario mientras escribe
     let tocado = false;
     input.addEventListener('blur', () => { tocado = true; marcarCampo(input, !reglaDeFalso()); });
     input.addEventListener('input', () => { if (tocado) marcarCampo(input, !reglaDeFalso()); });
@@ -127,7 +128,7 @@ function inicializarValidacionRegistro() {
     activarValidacionCampo(email, () => !esEmailValido(email.value));
     activarValidacionCampo(password, () => password.value.length < 6);
 
-    // password2 depende del valor de password, se re-evalúa en ambos
+    // password2 depende del valor de password, se re-evalua en ambos campos para dar feedback inmediato
     let tocadoP2 = false;
     const validarP2 = () => password.value === password2.value && password2.value.length > 0;
     password2.addEventListener('blur', () => { tocadoP2 = true; marcarCampo(password2, validarP2()); });
@@ -173,6 +174,7 @@ formLogin.addEventListener('submit', async e => {
     estadoAuth = true;
     actualizarBtnUsuario(datos.nombre);
     cerrarModal();
+    // Ejecuta la accion que el usuario intento hacer antes de loguearse (ej. analisis IA)
     accionPendiente?.();
     accionPendiente = null;
 });
@@ -216,6 +218,7 @@ formRegistro.addEventListener('submit', async e => {
     estadoAuth = true;
     actualizarBtnUsuario(datos.nombre);
     cerrarModal();
+    // Ejecuta la accion que el usuario intento hacer antes de registrarse (ej. analisis IA)
     accionPendiente?.();
     accionPendiente = null;
 });

js/ia.js

@@ -74,6 +74,7 @@ function construirPrompt(obtenerDatosPaciente, obtenerValoresFormulario, getUlti
             ? hallazgos.map(h => `  ${h.nombre}: ${h.valor} ${h.unidad || ''} (${h.direccion} · ${h.gravedad})`).join('\n')
             : '  Todos los valores normales';
 
+        // Prompt enfocado en citologia cuando hay imagenes adjuntas
         return `Eres médico veterinario especialista en patología clínica.
 
 Paciente: ${paciente.especie || 'desconocido'}, ${paciente.raza || 'raza desconocida'}, ${edadTexto}, ${paciente.sexo || 'sexo desconocido'}
@@ -105,6 +106,7 @@ Proporciona una interpretación clínica breve (6-8 oraciones) destacando los ha
 }
 
 function limpiarRespuesta(text) {
+    // Elimina tokens especiales del modelo medGemma y otros artefactos de generacion
     if (text.includes('<start_of_turn>model')) {
         text = text.split('<start_of_turn>model').pop();
     }
@@ -115,7 +117,7 @@ function limpiarRespuesta(text) {
         // Formato normal: <unused94>pensamiento<unused95>respuesta
         text = text.split('<unused95>').pop();
     } else if (text.includes('<unused94>')) {
-        // El modelo agotó tokens en el razonamiento — mostrar el pensamiento como respuesta
+        // El modelo agoto tokens en el razonamiento; muestra el pensamiento como respuesta
         text = text.split('<unused94>').slice(1).join('').trim();
     }
     text = text.replace(/<unused\d+>/g, '');
@@ -127,7 +129,7 @@ function limpiarRespuesta(text) {
     // Quitar bloques de razonamiento / thinking process
     text = text.replace(/^thought\s*\n?/i, '');
 
-    // Detectar si el modelo solo generó razonamiento en inglés sin respuesta clínica
+    // Detectar si el modelo solo genero razonamiento en ingles sin respuesta clinica
     const tieneRazonamiento = /Here'?s a thinking process|Understand the Role|Analyze the Request|Review the Lab Results|Synthesize Findings|Formulate Clinical Interpretation/i.test(text);
     const tieneEspanol = /[áéíóúñÁÉÍÓÚÑ]{2,}/.test(text) || /\b(paciente|hallazgos|interpretación|recomendaciones|análisis|resultados|clínica|diagnóstico|evaluación|hepatopatía|nefropatía|anemia|leucocitosis|neutrofilia|linfopenia|hiperglucemia|hipoglucemia|pancreatitis|hepatitis|cirrosis|insuficiencia)\b/i.test(text);
     if (tieneRazonamiento && !tieneEspanol) {
@@ -136,7 +138,7 @@ function limpiarRespuesta(text) {
 
     // Si hay razonamiento mezclado con español, intentar extraer solo la respuesta
     if (tieneRazonamiento) {
-        // Buscar la primera línea que parezca español clínico
+        // Buscar la primera linea que parezca español clinico
         const lineas = text.split('\n');
         let inicioRespuesta = -1;
         for (let i = 0; i < lineas.length; i++) {
@@ -157,10 +159,10 @@ function limpiarRespuesta(text) {
     text = text.replace(/\\[a-zA-Z]+(\{[^}]*\})?/g, '');
     text = text.replace(/\$[^$]*\$/g, '');
 
-    // Colapsar líneas vacías múltiples
+    // Colapsar lineas vacias multiples
     text = text.replace(/\n{3,}/g, '\n\n').trim();
 
-    // Cortar al primer párrafo que se repite (loop del modelo)
+    // Cortar al primer parrafo que se repite (loop del modelo)
     const parrafos = text.split(/\n\n+/);
     const vistos = new Set();
     const sinRepetidos = [];
@@ -203,6 +205,7 @@ async function _llamarOllama(salidaEl, obtenerDatosPaciente, obtenerValoresFormu
     const prompt = construirPrompt(obtenerDatosPaciente, obtenerValoresFormulario, getUltimoAnalisis, getReferencias);
     const imagenes = [...imagenesDataUrl.filter(Boolean), ...capturasMicroscopio];
 
+    // Construye el payload compatible con OpenAI vision: imagenes primero, luego el texto
     const contenido = [];
     for (const img of imagenes) {
         if (typeof img === 'string' && img.startsWith('data:image/'))
@@ -244,16 +247,16 @@ async function _llamarOllama(salidaEl, obtenerDatosPaciente, obtenerValoresFormu
 async function _llamarSpace(salidaEl, obtenerDatosPaciente, obtenerValoresFormulario, getUltimoAnalisis, getReferencias) {
     let prompt = construirPrompt(obtenerDatosPaciente, obtenerValoresFormulario, getUltimoAnalisis, getReferencias);
     
-    // HACK: Prepend <unused95> to force medGemma to skip thinking phase and output response directly
+    // El modelo medGemma espera el token <unused95> al inicio del prompt para modo respuesta directa
     if (!prompt.includes('<unused95>')) {
         prompt = '<unused95>' + prompt;
     }
     
+    // Filtra y limita a 4 imagenes por restriccion del backend de HuggingFace
     const imagenes = [...imagenesDataUrl.filter(Boolean), ...capturasMicroscopio]
         .filter(img => typeof img === 'string' && /^data:image\/(jpeg|png|gif|webp);base64,/.test(img))
         .slice(0, 4);
 
-    // DEBUG: Log exact payload for desktop vs mobile comparison
     console.log('=== MORPHOS AI REQUEST ===');
     console.log('Images count:', imagenes.length);
     console.log('Prompt length:', prompt.length);
@@ -269,7 +272,6 @@ async function _llamarSpace(salidaEl, obtenerDatosPaciente, obtenerValoresFormul
 
         const data = await res.json();
         
-        // DEBUG: Log raw response
         console.log('=== MORPHOS AI RESPONSE ===');
         console.log('Status:', res.status);
         console.log('Raw text preview:', (data.text ?? 'NO TEXT').substring(0, 300));

js/main.js

@@ -56,6 +56,7 @@ const obtenerDatosPaciente = () => {
     const especieCruda = document.getElementById('pt-especie').value;
     const valorEdad = document.getElementById('pt-edad').value;
     const edadUnidad = document.getElementById('pt-edad-unidad').value;
+    // Normaliza la edad siempre a meses para que analisis.js pueda aplicar ajustes por cachorro/adulto/senior
     const edadMeses = valorEdad === '' ? null
         : edadUnidad === 'meses' ? parseFloat(valorEdad)
         : parseFloat(valorEdad) * 12;
@@ -124,6 +125,7 @@ const renderizarPatrones = (patrones) => {
 const evaluar = () => {
     const paciente = obtenerDatosPaciente();
 
+    // Si no hay especie o aun no cargaron las referencias, limpia la UI para evitar falsos positivos
     if (!paciente.especie || !referencias[paciente.especie]) {
         actualizarClasesInputs([]);
         renderizarPatrones([]);
@@ -131,6 +133,7 @@ const evaluar = () => {
     }
 
     const valores = obtenerValoresFormulario();
+    // Delega en analisis.js la comparacion contra rangos de referencia y la deteccion de patrones clinicos
     const { hallazgos, patrones } = analizarResultados(valores, paciente, referencias, alteraciones);
     ultimoAnalisis = { hallazgos, patrones };
 
@@ -142,6 +145,7 @@ const evaluar = () => {
 
 document.addEventListener('input', e => {
     if (e.target.type !== 'number') return;
+    // Impide valores negativos y limita a 4 digitos significativos para mantener la UI limpia
     if (e.target.value < 0) e.target.value = 0;
     if (e.target.value.replace('.', '').length > 4) e.target.value = e.target.value.slice(0, 4);
     e.target.classList.toggle('max-chars', e.target.value.replace('.', '').length >= 4);
@@ -164,6 +168,7 @@ document.addEventListener('click', e => {
     if (!btn) return;
     const panel = document.getElementById(`panel-${btn.dataset.panel}`);
     if (!panel) return;
+    // Recorre todos los campos editables del panel y los resetea, incluyendo indicadores visuales de estado
     panel.querySelectorAll('input[type="number"], input[type="text"], input[type="url"], select').forEach(el => {
         if (el.tagName === 'SELECT') {
             el.selectedIndex = 0;
@@ -181,6 +186,7 @@ document.addEventListener('click', e => {
 });
 
 document.querySelector('.boton-analizar').addEventListener('click', async () => {
+    // Si el usuario no esta logueado, abre el modal de auth y encola la llamada a IA como callback
     const autenticado = await verificarAuth();
     if (!autenticado) {
         abrirModalAuth(() => {

js/papers.js

@@ -60,6 +60,7 @@ const traducirPatron = (nombre) => {
 
 const construirQuery = (patrones) => {
     if (!patrones || patrones.length === 0) return 'veterinary clinical laboratory diagnosis canine feline';
+    // Limita a 3 terminos para mantener la query enfocada y evitar resultados irrelevantes
     const terminos = [...new Set(patrones.map(p => traducirPatron(p.nombre)))].slice(0, 3);
     return `${terminos.join(' ')} canine OR feline veterinary`;
 };
@@ -139,6 +140,7 @@ const renderizarPaginacion = () => {
         return;
     }
 
+    // Ventana deslizante de maximo 5 botones centrada en la pagina actual
     const inicio = Math.max(0, paginaActual - 2);
     const fin = Math.min(totalPaginas, inicio + 5);
 
@@ -211,6 +213,7 @@ export const abrirModalPapers = async (patrones) => {
     const etiquetaConsulta = document.getElementById('papers-consulta');
     if (etiquetaConsulta) etiquetaConsulta.textContent = `"${nuevaConsulta}"`;
 
+    // Reutiliza resultados si la consulta no cambio desde la ultima vez
     if (nuevaConsulta === consultaActual && todosLosPapers.length > 0) {
         renderizarPaginaActual();
         return;

js/pdf-parser.js

@@ -10,7 +10,7 @@ const DEFS_ANALITOS = [
     { campo: 'hgb', re: /\b(?:hemoglobin[ao]?\w*|hgb|hb)\b(?!a\d)/i },
     { campo: 'hct', re: /\b(?:hematocrit[oo]?\w*|hct|pcv)\b/i },
     { campo: 'vcm', re: /\b(?:v\.?c\.?m\.?|m\.?c\.?v\.?|vol(?:umen)?\s+corp\w*)\b/i },
-    // CHCM debe ir antes que HCM para evitar que MCH coincida con MCHC
+    // CHCM debe ir antes que HCM para evitar que MCH coincida con MCHC al usar lookahead negativo
     { campo: 'chcm', re: /\b(?:c\.?h\.?c\.?m\.?|m\.?c\.?h\.?c\.?|concentr\w+\s+hem\w+\s+corp\w*)\b/i },
     { campo: 'hcm', re: /\b(?:h\.?c\.?m\.?|m\.?c\.?h\.?)(?![cC]\.?)\b/i },
     { campo: 'rdw', re: /\b(?:r\.?d\.?w\.?(?:-cv)?|anch\w+\s+distrib\w+)\b/i },
@@ -201,6 +201,7 @@ function aplicarConversion(campo, claveConv, value, cadenaUnidad) {
     const key = claveConv || campo;
     const reglas = CONVERSIONES_UNIDADES[key];
     if (!reglas) return value;
+    // Aplica la primera regla cuya regex coincida con la cadena de unidad detectada
     for (const regla of reglas) {
         if (regla.re.test(cadenaUnidad)) {
             const f = regla.factor;
@@ -211,8 +212,8 @@ function aplicarConversion(campo, claveConv, value, cadenaUnidad) {
     return value;
 }
 
-// Retorna { num, unit } donde unit es la cadena de ~50 caracteres tras el valor numérico.
-// Las reglas de conversión evalúan su regex contra esta cadena.
+// Retorna { num, unit } donde unit es la cadena de ~50 caracteres tras el valor numerico.
+// Las reglas de conversion evaluan su regex contra esta cadena para decidir el factor.
 function extraerValorYUnidad(contexto) {
     const m = contexto.match(/[<>≤≥]?\s*(\d+(?:[.,]\d+)?)([\s\S]*)/);
     if (!m) return { num: null, unit: '' };
@@ -244,7 +245,7 @@ function parsearTextoLab(textoCrudo) {
         resultados[def.campo] = aplicarConversion(def.campo, def.claveConv, num, unit);
     }
 
-    // Derivar % desde conteos absolutos si el % no se encontró directamente y se conoce el WBC
+    // Derivar % desde conteos absolutos si el % no se encontro directamente y se conoce el WBC
     if (resultados.wbc && resultados.wbc > 0) {
         for (const f of ['neutro', 'linfo', 'mono', 'eosino', 'baso']) {
             if (resultados[f] === undefined && resultados[`${f}_abs`] !== undefined) {
@@ -254,8 +255,8 @@ function parsearTextoLab(textoCrudo) {
         }
     }
 
-    // Derivar % de reticulocitos desde el conteo absoluto y RBC si no se encontró directamente
-    // reti_abs (x10³/μL) ÷ (rbc (x10⁶/μL) × 10) = reti%
+    // Derivar % de reticulocitos desde el conteo absoluto y RBC si no se encontro directamente
+    // reti_abs (x10³/uL) / (rbc (x10⁶/uL) * 10) = reti%
     if (resultados.rbc && resultados.rbc > 0 && resultados.reti === undefined && resultados.reti_abs !== undefined) {
         const pct = resultados.reti_abs / (resultados.rbc * 10);
         if (pct >= 0 && pct <= 20) resultados.reti = Math.round(pct * 100) / 100;
@@ -311,7 +312,7 @@ function inferEspecie(raza) {
 function parsearTextoPaciente(textoCrudo) {
     const p = {};
 
-    // Especie — "Especie: Canino" / "Species: Dog" / "Tipo: Felino"
+    // Especie: tolera variaciones como "Canino", "Dog", "Felino", "Cat"
     const coincEsp = textoCrudo.match(/\b(?:especies?|species|tipo(?:\s+de)?\s+animal)\s*:?\s{0,4}([A-Za-záéíóúÁÉÍÓÚñÑ]{3,20})/i);
     if (coincEsp) {
         const v = coincEsp[1].toLowerCase();
@@ -319,11 +320,10 @@ function parsearTextoPaciente(textoCrudo) {
         else if (/fel[io]|gat[ao]|cat/.test(v)) p.especie = 'Felino';
     }
 
-    // Raza — "Raza: Labrador Retriever" / "Breed: Mixed"
+    // Raza: corta en la siguiente etiqueta o doble espacio para evitar absorber campos adyacentes en tablas
     const coincRaza = textoCrudo.match(/\b(?:raza|breed|race|cruce)\s*:?\s{0,4}([^\n\r;:]{2,60})/i);
     if (coincRaza) {
         const crudo = coincRaza[1];
-        // Detener en la siguiente palabra clave de etiqueta o 2+ espacios consecutivos (diseño tabular)
         const indiceParo = crudo.search(SIGUIENTE_ETIQUETA);
         const limpiado = (indiceParo > 0 ? crudo.slice(0, indiceParo) : crudo)
             .split(/\s{2,}/)[0]
@@ -331,9 +331,10 @@ function parsearTextoPaciente(textoCrudo) {
         if (limpiado.length >= 2) p.raza = limpiado.length > 40 ? limpiado.slice(0, 40).trim() : limpiado;
     }
 
+    // Si no encontro especie pero si raza, infiere la especie a partir de listas de razas conocidas
     if (!p.especie && p.raza) p.especie = inferEspecie(p.raza);
 
-    // Sexo — "Sexo: Macho" / "Sex: F" / "Género: Hembra Esterilizada"
+    // Sexo: soporta abreviaturas (M, F, H) y variantes como "Esterilizada"
     const coincSex = textoCrudo.match(/\b(?:sexo|sex[ou]?|g[eé]nero|gender)\s*:?\s{0,4}([^\n\r;:]{1,30})/i);
     if (coincSex) {
         const v = coincSex[1].trim();
@@ -341,7 +342,7 @@ function parsearTextoPaciente(textoCrudo) {
         else if (/\b(?:hembra|female|esterilizada?|spayed)\b/i.test(v) || /^[fh]\.?\s*$/i.test(v)) p.sexo = 'Hembra';
     }
 
-    // Edad — "Edad: 5 años" / "Age: 6 months" / "Edad: 2.5 años"
+    // Edad: extrae numero y unidad, normalizando comas decimales
     const coincEdad = textoCrudo.match(/\b(?:edad|age)\s*:?\s{0,4}(\d+(?:[.,]\d+)?)\s*(a[ñn]os?|years?|yr?s?|meses?|months?)\b/i);
     if (coincEdad) {
         p.edad = parseFloat(coincEdad[1].replace(',', '.'));

js/ui.js

@@ -15,6 +15,7 @@ export function activarTab(targetId) {
     const esTabExamenes = targetId === 'examenes';
     const mostrarExamenes = esTabExamenes || esSubpanelExamenes;
 
+    // Si se clickea la tab generica "Examenes", muestra el ultimo subtab activo; si es un subtab, lo guarda
     let idPanelActual;
     if (esTabExamenes) {
         idPanelActual = panelExamenActivo;
@@ -70,6 +71,7 @@ document.querySelector('main').addEventListener('touchstart', e => {
 document.querySelector('main').addEventListener('touchend', e => {
     const dx = e.changedTouches[0].clientX - inicioSwipeX;
     const dy = e.changedTouches[0].clientY - inicioSwipeY;
+    // Ignora gestos cortos o verticales para no interferir con scroll
     if (Math.abs(dx) < 50 || Math.abs(dx) < Math.abs(dy)) return;
     const indice = SWIPE_ORDER.indexOf(panelActivo);
     const siguiente = dx < 0 ? SWIPE_ORDER[indice + 1] : SWIPE_ORDER[indice - 1];
@@ -122,6 +124,7 @@ function inicializarFilasGrid() {
     if (!esGridEscritorio()) return;
     mainEl.style.gridTemplateRows = '1fr auto auto';
 
+    // Mide el panel de flujo expandido y colapsado para animar grid-template-rows con precision
     const alturaPanel = panelFlujo.getBoundingClientRect().height;
     const alturaEncabezado = panelFlujo.querySelector('.panel-cabecera').getBoundingClientRect().height;
     if (alturaPanel > 0) filaExpandida = `${alturaPanel}px`;
@@ -188,6 +191,7 @@ function establecerSubpanelColapsado(subpanel, debeColapsar) {
     if (debeColapsar === subpanel.classList.contains('collapsed')) return;
     subpanel.classList.toggle('collapsed', debeColapsar);
     if (btn) btn.setAttribute('aria-expanded', String(!debeColapsar));
+    // Forzar reflujo antes de cambiar height permite que CSS transition anime correctamente
     if (debeColapsar) {
         animEl.style.height = `${animEl.offsetHeight}px`;
         animEl.offsetHeight;
@@ -324,6 +328,7 @@ document.querySelectorAll('.zona-imagen').forEach(zona => {
         reader.onload = ev => {
             const img = new Image();
             img.onload = () => {
+                // Reduce la imagen a max 1024px en su lado mayor para no saturar la memoria ni la API
                 const MAX_PIXELES = 1024;
                 const scale = Math.min(MAX_PIXELES / img.width, MAX_PIXELES / img.height, 1);
                 const canvas = document.createElement('canvas');
@@ -420,6 +425,7 @@ document.querySelectorAll('.zona-imagen').forEach(zona => {
 
     async function abrirCamara() {
         try {
+            // Preferencia por camara trasera (microscopio o movil apuntando a la muestra)
             stream = await navigator.mediaDevices.getUserMedia({
                 video: { facingMode: { ideal: 'environment' }, width: { ideal: 1920 } }
             });
@@ -429,7 +435,7 @@ document.querySelectorAll('.zona-imagen').forEach(zona => {
             controles.hidden = false;
             actualizarInsignia();
         } catch {
-            // Permiso denegado o cámara no disponible — no se requiere fallback
+            // Permiso denegado o camara no disponible; no se requiere fallback
         }
     }
 
@@ -447,6 +453,7 @@ document.querySelectorAll('.zona-imagen').forEach(zona => {
         e.stopPropagation();
         if (capturasMicroscopio.length >= MAX_CAPTURAS_MICRO) return;
         const canvas = document.createElement('canvas');
+        // Escala el fotograma de video para mantener un tamano razonable antes de enviarlo al modelo
         const MAX_PIXELES = 1024;
         const scale = Math.min(MAX_PIXELES / video.videoWidth, MAX_PIXELES / video.videoHeight, 1);
         canvas.width = Math.round(video.videoWidth * scale);