{{-- Hoja 1: portada, resumen e índice --}}
<article class="pdf-sheet">
    @include('system.administrator.trend-detection-settings.partials.help-manual-pdf-header', [
        'headerTitle' => 'GUÍA PARA ANALISTAS',
        'headerSubtitle' => 'Configuración de detección de tendencias y generación de notificaciones',
        'isCover' => true,
    ])

    <div class="doc-cover-title">
        <h1>Guía para analistas</h1>
        <p class="doc-subtitle">Documento de referencia — módulo Config. tendencias</p>
    </div>
    <p class="doc-meta">
        <span>Módulo: Config. tendencias</span>
        <span>Versión documento: {{ date('Y-m') }}</span>
    </p>

    <div class="doc-abstract">
        <strong>Resumen ejecutivo.</strong>
        En esta pantalla usted define cuándo un resultado de laboratorio debe generar una notificación.
        El sistema dejó de alarmar por cualquier subida respecto al promedio reciente; ahora exige un cambio significativo,
        una tendencia sostenida o el cruce de los límites operativos que usted configure por elemento.
    </div>

    <nav class="doc-toc" id="indice">
        <h2>Índice</h2>
        <ol>
            <li><a href="#inicio-rapido">Crear su primera regla</a></li>
            <li><a href="#campos">Campos del formulario</a></li>
            <li><a href="#ejemplo">Ejemplo: Agua</a></li>
            <li><a href="#cuando-corre">¿Cuándo corre el sistema?</a></li>
            <li><a href="#prioridad">Prioridad entre reglas</a></li>
            <li><a href="#severidad">Niveles de severidad</a></li>
            <li><a href="#sin-notificacion">Cuándo no hay notificación</a></li>
            <li><a href="#tecnico">Anexo técnico</a></li>
        </ol>
    </nav>

    <footer class="sheet-footer">
        <span>Terpel · Fidelis — Manual de tendencias</span>
        <span>Página 1</span>
    </footer>
</article>

{{-- Hoja 2: primera regla + tabla de campos --}}
<article class="pdf-sheet">
    @include('system.administrator.trend-detection-settings.partials.help-manual-pdf-header', [
        'headerTitle' => 'MANUAL — CONFIGURACIÓN DE TENDENCIAS',
        'headerSubtitle' => 'Fidelis · Terpel',
    ])

    <section id="inicio-rapido" class="doc-section">
        <h2>Crear su primera regla</h2>
        <p class="doc-p">
            El formulario tiene muchos campos, pero en la práctica solo necesita pensar en <strong>tres bloques</strong>.
            Si es su primera vez, siga este orden; el detalle de cada campo está en la sección 2 de este manual.
        </p>

        <div class="doc-quick-phases">
            <div class="doc-phase doc-phase-a">
                <div class="doc-phase-label">Bloque A</div>
                <div class="doc-phase-title">¿Para qué parámetro y a quién aplica?</div>
                <ul class="doc-phase-list">
                    <li>Pulse <strong>Nueva configuración</strong> en la pantalla principal.</li>
                    <li><strong>Elemento</strong> (obligatorio): el parámetro que analiza, p. ej. Agua, Fe, Cu.</li>
                    <li><strong>Componente</strong> y <strong>Equipo</strong>: déjelos en <em>Todos</em> si la regla vale para cualquier muestra de ese elemento.</li>
                </ul>
                <p class="doc-phase-tip">
                    <strong>¿Cuándo llenar componente o equipo?</strong> Solo si ese componente o esa unidad tiene límites distintos al resto.
                </p>
            </div>

            <div class="doc-phase doc-phase-b">
                <div class="doc-phase-label">Bloque B</div>
                <div class="doc-phase-title">Sensibilidad del sistema (casi siempre igual)</div>
                <p class="doc-phase-intro">Estos valores ya vienen bien para empezar. <strong>No los cambie</strong> salvo indicación del coordinador.</p>
                <table class="doc-table doc-table-compact">
                    <thead>
                        <tr>
                            <th>Campo en pantalla</th>
                            <th>Valor</th>
                        </tr>
                    </thead>
                    <tbody>
                        <tr>
                            <td>Dirección de riesgo</td>
                            <td><strong>Subir es malo</strong> <span class="doc-muted">(contaminantes, agua, desgaste)</span></td>
                        </tr>
                        <tr>
                            <td>Variación % umbral</td>
                            <td><strong>20</strong></td>
                        </tr>
                        <tr>
                            <td>Ratio mín. límite</td>
                            <td><strong>0,25</strong></td>
                        </tr>
                        <tr>
                            <td>Puntos tendencia / Factor z-score / Delta mín.</td>
                            <td><strong>5</strong> · <strong>2</strong> · <em>vacío</em></td>
                        </tr>
                    </tbody>
                </table>
            </div>

            <div class="doc-phase doc-phase-c">
                <div class="doc-phase-label">Bloque C</div>
                <div class="doc-phase-title">Límites del laboratorio (lo más importante)</div>
                <ul class="doc-phase-list">
                    <li>Copie del informe o estándar del cliente los valores de <strong>Precaución</strong>, <strong>Alerta</strong> y <strong>Crítico</strong>.</li>
                    <li>Deje la configuración en <strong>Activo</strong> y pulse <strong>Guardar</strong>.</li>
                </ul>
                <p class="doc-phase-tip">
                    Sin estos tres límites la regla guarda, pero las alertas por cruce de umbral serán más limitadas. Véase la nota en la sección de campos.
                </p>
            </div>
        </div>

        <h3 class="doc-subheading">Mapa del formulario (mismo orden que en pantalla)</h3>
        <div class="doc-form-map">
            <div class="doc-form-block doc-form-block-scope">
                <span class="doc-form-block-tag">Bloque A — Alcance</span>
                <span class="doc-form-field">Elemento <em>*</em></span>
                <span class="doc-form-field">Componente (opcional)</span>
                <span class="doc-form-field">Equipo (opcional)</span>
            </div>
            <div class="doc-form-arrow" aria-hidden="true">↓</div>
            <div class="doc-form-block doc-form-block-sense">
                <span class="doc-form-block-tag">Bloque B — Sensibilidad</span>
                <span class="doc-form-field">Dirección · Variación % · Ratio mín.</span>
                <span class="doc-form-field doc-form-field-muted">Puntos · Z-score · Delta (no tocar al inicio)</span>
            </div>
            <div class="doc-form-arrow" aria-hidden="true">↓</div>
            <div class="doc-form-block doc-form-block-limits">
                <span class="doc-form-block-tag">Bloque C — Límites</span>
                <span class="doc-form-field">Precaución · Alerta · Crítico</span>
                <span class="doc-form-field">Activo → Guardar</span>
            </div>
        </div>

        <h3 class="doc-subheading">Antes de guardar, confirme</h3>
        <ul class="doc-checklist">
            <li>El <strong>elemento</strong> es el parámetro correcto (mismo nombre que en resultados).</li>
            <li>Componente y equipo vacíos = regla <strong>general</strong>; si eligió uno, es regla <strong>específica</strong>.</li>
            <li>Los tres <strong>límites</strong> coinciden con el estándar que ya usa el laboratorio.</li>
            <li>La fila quedó en estado <strong>Activo</strong>.</li>
        </ul>
    </section>

    <section id="campos" class="doc-section">
        <h2>Campos del formulario</h2>
        <table class="doc-table">
            <thead>
                <tr>
                    <th>Campo</th>
                    <th>Obligatorio</th>
                    <th>Qué escribir</th>
                </tr>
            </thead>
            <tbody>
                <tr>
                    <td>Elemento</td>
                    <td><span class="doc-tag doc-tag-yes">Sí</span></td>
                    <td>Parámetro analizado (mismo nombre que en resultados de muestra).</td>
                </tr>
                <tr>
                    <td>Componente</td>
                    <td><span class="doc-tag doc-tag-no">No</span></td>
                    <td>Vacío = todos. Elija uno solo si ese componente tiene límites distintos.</td>
                </tr>
                <tr>
                    <td>Equipo</td>
                    <td><span class="doc-tag doc-tag-no">No</span></td>
                    <td>Vacío = todos. Elija uno para reglas de una unidad específica.</td>
                </tr>
                <tr>
                    <td>Dirección de riesgo</td>
                    <td><span class="doc-tag doc-tag-yes">Sí</span></td>
                    <td>
                        <strong>Subir es malo</strong> — agua, partículas, contaminación.<br>
                        <strong>Bajar es malo</strong> — viscosidad u otros que deben mantenerse altos.<br>
                        <strong>Ambas</strong> — subidas y bajadas seguidas.
                    </td>
                </tr>
                <tr>
                    <td>Variación % umbral</td>
                    <td><span class="doc-tag doc-tag-yes">Sí</span></td>
                    <td>Cambio mínimo vs. promedio de las 4 muestras anteriores. Use <strong>20</strong> para empezar.</td>
                </tr>
                <tr>
                    <td>Ratio mín. límite</td>
                    <td><span class="doc-tag doc-tag-yes">Sí</span></td>
                    <td>
                        Valor entre 0 y 1. Use <strong>0,25</strong>: solo alarmar por tendencia si el resultado llegó al menos al
                        <strong>25%</strong> del límite usado (crítico, o alerta/precaución si no hay crítico).
                    </td>
                </tr>
                <tr class="doc-row-highlight">
                    <td>Límite precaución</td>
                    <td><span class="doc-tag doc-tag-rec">Recom.</span></td>
                    <td>Primera revisión interna. Si queda vacío, no habrá severidad Precaución por cruce de este umbral.</td>
                </tr>
                <tr class="doc-row-highlight">
                    <td>Límite alerta</td>
                    <td><span class="doc-tag doc-tag-rec">Recom.</span></td>
                    <td>Problema claro. Si queda vacío, no habrá severidad Alerta por cruce de este umbral.</td>
                </tr>
                <tr class="doc-row-highlight">
                    <td>Límite crítico</td>
                    <td><span class="doc-tag doc-tag-rec">Recom.</span></td>
                    <td>Máximo permitido. Si solo llena este, puede haber <strong>Crítica</strong> al cruzarlo; alerta y precaución por límite no aplican.</td>
                </tr>
                <tr>
                    <td>Puntos tendencia</td>
                    <td><span class="doc-tag doc-tag-no">No</span></td>
                    <td>Deje <strong>5</strong>.</td>
                </tr>
                <tr>
                    <td>Factor z-score</td>
                    <td><span class="doc-tag doc-tag-no">No</span></td>
                    <td>Deje <strong>2</strong>.</td>
                </tr>
                <tr>
                    <td>Delta mín. absoluto</td>
                    <td><span class="doc-tag doc-tag-no">No</span></td>
                    <td>Deje vacío salvo parámetros casi en cero donde el porcentaje engaña.</td>
                </tr>
            </tbody>
        </table>
    </section>

    <footer class="sheet-footer">
        <span>Terpel · Fidelis — Manual de tendencias</span>
        <span>Página 2</span>
    </footer>
</article>

{{-- Hoja 3: ejemplo y operación --}}
<article class="pdf-sheet">
    @include('system.administrator.trend-detection-settings.partials.help-manual-pdf-header', [
        'headerTitle' => 'MANUAL — CONFIGURACIÓN DE TENDENCIAS',
        'headerSubtitle' => 'Fidelis · Terpel',
    ])

    <section id="ejemplo" class="doc-section">
        <h2>Ejemplo: Agua</h2>
        <div class="doc-example">
            <dl>
                <dt>Elemento</dt><dd><strong>Agua</strong></dd>
                <dt>Componente / Equipo</dt><dd><em>Vacíos</em> (regla general)</dd>
                <dt>Dirección</dt><dd><strong>Subir es malo</strong></dd>
                <dt>Variación %</dt><dd><strong>20</strong></dd>
                <dt>Ratio mín.</dt><dd><strong>0,25</strong></dd>
                <dt>Precaución / Alerta / Crítico</dt><dd><strong>500 · 1000 · 2000</strong> (ajuste a estándares del laboratorio)</dd>
                <dt>Puntos / Z-score / Delta</dt><dd><strong>5 · 2 ·</strong> vacío</dd>
            </dl>
        </div>
    </section>

    <section id="cuando-corre" class="doc-section">
        <h2>¿Cuándo corre el sistema?</h2>
        <p class="doc-p">
            Al <strong>aprobar una muestra</strong> (aplicar reglas en laboratorio). El motor compara el resultado con las
            <strong>cuatro muestras anteriores</strong> del mismo equipo, componente y elemento.
        </p>
        <p class="doc-p">
            Si se genera alerta, aparece <strong>una notificación por muestra</strong> en el módulo de Notificaciones,
            con el detalle de todos los elementos afectados en un solo grupo.
        </p>
    </section>

    <section id="prioridad" class="doc-section">
        <h2>Prioridad entre reglas</h2>
        <p class="doc-p">Si existen varias reglas para el mismo elemento, se aplica la más específica:</p>
        <p class="doc-flow">
            <strong>Equipo + componente</strong> → <strong>Solo componente</strong> → <strong>Solo equipo</strong> → <strong>Global del elemento</strong>
        </p>
    </section>

    <footer class="sheet-footer">
        <span>Terpel · Fidelis — Manual de tendencias</span>
        <span>Página 3</span>
    </footer>
</article>

{{-- Hoja 4: severidad y anexo --}}
<article class="pdf-sheet">
    @include('system.administrator.trend-detection-settings.partials.help-manual-pdf-header', [
        'headerTitle' => 'MANUAL — CONFIGURACIÓN DE TENDENCIAS',
        'headerSubtitle' => 'Fidelis · Terpel',
    ])

    <section id="severidad" class="doc-section">
        <h2>Niveles de severidad</h2>
        <table class="doc-table doc-sev-table">
            <thead>
                <tr>
                    <th class="col-sev">Severidad</th>
                    <th class="col-meaning">Significado para el analista</th>
                </tr>
            </thead>
            <tbody>
                <tr>
                    <td><span class="sev-label sev-critica">Crítica</span></td>
                    <td>El resultado superó el <strong>límite crítico</strong> configurado.</td>
                </tr>
                <tr>
                    <td><span class="sev-label sev-alerta">Alerta</span></td>
                    <td>Superó el <strong>límite de alerta</strong> configurado.</td>
                </tr>
                <tr>
                    <td><span class="sev-label sev-precau">Precaución</span></td>
                    <td>Superó precaución, o hay cambio fuerte con tendencia cerca del límite.</td>
                </tr>
                <tr>
                    <td><span class="sev-label sev-info">Informativa</span></td>
                    <td>Tendencia preocupante; el valor aún está lejos del límite crítico.</td>
                </tr>
            </tbody>
        </table>
    </section>

    <section id="sin-notificacion" class="doc-section">
        <h2>Cuándo no aparece notificación</h2>
        <ul class="doc-bullet-list">
            <li>Menos de cuatro muestras previas para ese elemento en el mismo equipo y componente.</li>
            <li>El cambio es menor al umbral de variación (por defecto <strong>20%</strong>).</li>
            <li>Hay tendencia pero el valor está muy por debajo del crítico (ratio &lt; 0,25).</li>
            <li>La configuración está marcada como <strong>Inactiva</strong>.</li>
        </ul>
    </section>

    <section id="tecnico" class="doc-section">
        <h2>Anexo técnico</h2>
        <div class="doc-tech">
            <ul>
                <li><strong>Promedio histórico:</strong> media aritmética de las últimas cuatro muestras comparables.</li>
                <li><strong>Variación %:</strong> cambio del valor actual respecto a ese promedio.</li>
                <li><strong>Tendencia:</strong> cinco resultados consecutivos en la misma dirección (cuatro históricos más el actual).</li>
                <li><strong>Sin configuración en pantalla:</strong> el sistema aplica 20% de variación y ratio 0,25 por defecto.</li>
            </ul>
        </div>
    </section>

    <footer class="sheet-footer">
        <span>Terpel · Fidelis — Manual de tendencias</span>
        <span>Página 4</span>
    </footer>
</article>