optimize gui

add help text sections
This commit is contained in:
team2
2026-02-27 06:39:07 +01:00
parent e5268aa720
commit 41b595b4c5
7 changed files with 235 additions and 80 deletions

View File

@@ -59,7 +59,7 @@
<br>
<strong>Größere Werte:</strong> Weniger Chunks, mehr Kontext pro Treffer.
<br><br>
Empfehlung für Produkt- und Wissensdaten: 6001000.
Empfehlung für Produkt- und Wissensbasis: 6001000.
</div>
</div>

View File

@@ -12,6 +12,48 @@
</a>
</div>
{# ========================================================= #}
{# PROFIL SYSTEM DESCRIPTION #}
{# ========================================================= #}
<div class="card bg-black border-secondary mb-4 shadow-sm">
<div class="card-body text-light">
<h5 class="text-info mb-3">Was sind Indexierungsprofile?</h5>
<p class="small text-light mb-3">
Indexierungsprofile definieren die strukturellen Regeln des RAG-Systems.
Sie bestimmen, wie Dokumente in Chunks zerlegt, eingebettet
und später bewertet werden.
</p>
<ul class="small text-light mb-3">
<li>Chunk-Größe und Overlap (Textsegmentierung)</li>
<li>Embedding-Modell und Dimension</li>
<li>Scoring-Version (Retrieval-Logik)</li>
</ul>
<h6 class="text-info mt-3">Warum sind Profile versioniert?</h6>
<p class="small text-light mb-3">
Jede strukturelle Änderung beeinflusst die gesamte Indexarchitektur.
Deshalb ist ein Profil immer versioniert und unveränderlich.
Bei Aktivierung eines neuen Profils kann eine vollständige
Neuindizierung erforderlich werden.
</p>
<h6 class="text-info mt-3">Wie prüft das System Konsistenz?</h6>
<p class="small text-light mb-0">
Das System vergleicht das aktive Profil mit der aktuellen
<code>index_meta.json</code>. Weichen Parameter wie
Embedding-Dimension, Chunking oder Scoring ab,
wird eine Strukturabweichung erkannt und ein Global Reindex
empfohlen oder erzwungen.
</p>
</div>
</div>
{# ============================= #}
{# Strukturstatus Alert #}
{# ============================= #}
@@ -70,20 +112,20 @@
<span class="badge bg-success">Aktiv</span>
{% else %}
<span class="badge bg-dark border border-secondary">
Inaktiv
</span>
Inaktiv
</span>
{% endif %}
</td>
<td>
{% if p.reindexRequired %}
<span class="badge bg-warning text-dark">
Erforderlich
</span>
Erforderlich
</span>
{% else %}
<span class="badge bg-secondary">
Nein
</span>
Nein
</span>
{% endif %}
</td>
@@ -91,7 +133,6 @@
{% if not p.active and is_granted('ROLE_SUPER_ADMIN') %}
{# Aktivieren via POST #}
<form method="post"
action="{{ path('admin_ingest_profile_activate', {id: p.id}) }}"
class="d-inline"
@@ -106,7 +147,6 @@
</button>
</form>
{# Löschen via POST #}
<form method="post"
action="{{ path('admin_ingest_profile_remove', {id: p.id}) }}"
class="d-inline"
@@ -143,12 +183,12 @@
{# ============================= #}
<div class="card bg-black border-secondary">
<div class="card-body">
<div class="card-body text-light">
<h5 class="text-info mb-3">Index-Struktur Vergleich</h5>
{% if indexMeta %}
<div class="mb-3 small text-secondary">
<div class="mb-3 small text-light">
Aktuelle Index-Version:
<strong>{{ indexMeta.index_version }}</strong>
</div>
@@ -194,9 +234,10 @@
</div>
</div>
<div class="mt-4 small text-secondary">
Hinweis: Strukturänderungen (Chunking, Embedding, Scoring) führen zu
inkonsistentem Retrieval, bis eine vollständige Neuindizierung durchgeführt wird.
<div class="mt-4 small text-light">
Hinweis: Strukturänderungen (Chunking, Embedding, Scoring)
führen zu inkonsistentem Retrieval, bis eine vollständige
Neuindizierung durchgeführt wird.
</div>
{% endblock %}
{% endblock %}