feat: Add comprehensive testing plan for IPSExtractor, including unit, integration, E2E, stress, and resilience tests. Introduce LaTeX documentation structure with sections for architecture, test strategy, and execution guidelines. Enhance README with setup instructions and k6 stress testing scripts.

docs/plan_pruebas/sections/06_e2e.tex

@@ -0,0 +1,54 @@
+\chapter{Pruebas end-to-end}
+\label{ch:e2e}
+
+\section{Matriz de flujos de negocio}
+\begin{longtable}{@{}p{1.8cm}p{2.8cm}p{5.0cm}p{3.0cm}@{}}
+\caption{Casos E2E cr\'iticos.}\\
+\toprule
+\textbf{ID} & \textbf{Flujo} & \textbf{Pasos m\'inimos} & \textbf{\'Exito} \\
+\midrule
+\endhead
+E2E-01 & Conteo & Lotes PDF $\rightarrow$ \texttt{/count/v1/count} $\rightarrow$ \texttt{/count-jobs} $\rightarrow$ PATCH & Conteos editables \\
+E2E-02 & Extracci\'on from-count & Tras E2E-01 $\rightarrow$ task extraction $\rightarrow$ rows & Filas coherentes \\
+E2E-03 & Extracci\'on ingest & Upload PDFs $\rightarrow$ task $\rightarrow$ rows & Paridad con fixtures \\
+E2E-04 & Limpieza & Batch extraction $\rightarrow$ cleaning job & Reglas aplicadas \\
+E2E-05 & Bot feliz & Worker online $\rightarrow$ Excel $\rightarrow$ claim $\rightarrow$ PDFs MinIO $\rightarrow$ completed & Manifest + events \\
+E2E-06 & Bot cancel & Cancel pending y running & Estados correctos \\
+E2E-07 & Worker offline & Create job sin heartbeat & HTTP 409 \\
+E2E-08 & Pipeline largo & Descarga $\rightarrow$ extracci\'on PDFs & Sin corrupci\'on \\
+\bottomrule
+\end{longtable}
+
+\section{Detalle E2E-05 (bot descarga)}
+\subsection{Precondiciones}
+\begin{itemize}
+  \item Stack Compose healthy; MinIO accesible; token \texttt{BOT\_API\_TOKEN} compartido.
+  \item Job Desktop padre existente en tabla \texttt{jobs}.
+  \item Agent registrado y con heartbeat $<$45\,s.
+  \item Excel fixture con $N$ radicados v\'alidos ($N\geq 3$ en smoke; $N\geq 50$ en regresi\'on).
+\end{itemize}
+
+\subsection{Pasos}
+\begin{enumerate}
+  \item Arrancar agent: \texttt{python -m bot\_descarga.worker.run --api-url http://127.0.0.1:8189/bot-descarga ...}
+  \item Desde Desktop o HTTP: crear job multipart con Excel.
+  \item Verificar claim y descarga de Excel.
+  \item (Staging Imaging) Completar descargas; en CI mock: simular eventos + PutObject.
+  \item Verificar \texttt{completed}, lista \texttt{/files} y \texttt{\_manifest.json}.
+\end{enumerate}
+
+\subsection{Asserts}
+\begin{itemize}
+  \item Un \'unico claim; status final \texttt{completed} o \texttt{failed} expl\'icito.
+  \item Eventos ordenados; \texttt{processed/total} coherentes.
+  \item Objetos MinIO bajo \texttt{downloads/\{id\}/}.
+\end{itemize}
+
+\section{Desktop}
+Checklist manual / automatizable:
+\begin{itemize}
+  \item Wizard de descargas (2 pasos) y panel de resultados.
+  \item Polling de job ($\sim$3\,s) y workers ($\sim$5\,s).
+  \item Token en \texttt{localStorage} (\texttt{botApiToken}).
+\end{itemize}
+Gap conocido a resolver antes de E2E desktop completo: import de m\'odulo downloads ausente referenciado en \texttt{App.tsx}.