refactor: вынос хардкода + LLM-анализ finding'ов
## Часть A: Вынос хардкода
- Новый модуль constants.py — все magic strings, лимиты, severity, ключи
(104 хардкод-значения централизованы)
- Новый модуль queries.py — общие SQL-запросы (build_scan_list_query,
build_package_list_query, get_dashboard_stats)
Убрана дупликация между api/*.py и web/routes.py (~90%)
- config.py: добавлены NLP_ENABLED, nexus_timeout, guarddog_binary,
log_syslog_facility, LLM-переменные
- nexus_client.py: таймауты из конфига, SHA256_CHUNK_SIZE из constants
- scanner.py: error-ключи из constants, GUARDDOG_OUTPUT_FORMAT из constants
- webhooks.py: RELEVANT_WEBHOOK_ACTIONS, METADATA_PATTERNS, ignore-строки
из constants
- logging_setup.py: конфигурируемый syslog facility, APP_PACKAGE из constants
- main.py: APP_NAME, APP_DESCRIPTION, APP_PACKAGE из constants
- models.py: поле report: JSON | None в Finding для LLM-отчётов
- harvester.py: авто-очистка tmpdir через finally; ERROR_MESSAGE_MAX_LENGTH
из constants; PACKAGE_EXTENSIONS вместо SUPPORTED_EXTENSIONS (с .gem)
- api/*.py + web/routes.py: используют build_*_query из queries.py,
константы для лимитов и сортировок
- tests/conftest.py: SEVERITY_WARNING, DEFAULT_ECOSYSTEM из constants
## Часть B: LLM-анализ finding'ов
- llm.py: клиент для OpenAI-совместимых API с промптом security-аналитика
- harvester.py: авто-триггер после flagged scan, сохранение report в БД
- api/findings.py: POST /{id}/analyze — ручной триггер
- web/routes.py: POST /api/v1/findings/{id}/analyze — HTMX-фрагмент
- _llm_report_fragment.html: шаблон фрагмента с вердиктом
- scan_detail.html, package_detail.html: кнопка Analyze with LLM
(htmx-post, spinner, inline-замена на LLM-отчёт)
- style.css: стили для .llm-report .verdict-safe/suspicious/malicious
## Часть C: Тесты
- 50 тестов, все зелёные
- Линтер чистый
- Тесты используют constants где нужно
This commit is contained in:
9
guarddog_nexus/web/templates/_llm_report_fragment.html
Normal file
9
guarddog_nexus/web/templates/_llm_report_fragment.html
Normal file
@@ -0,0 +1,9 @@
|
||||
<div class="llm-report">
|
||||
<strong>LLM Analysis</strong>
|
||||
<span class="verdict-{{ report.verdict }}">[{{ report.verdict }}]</span>
|
||||
{% if report.severity_rating %}
|
||||
<span class="severity-{{ report.severity_rating }}">({{ report.severity_rating }})</span>
|
||||
{% endif %}
|
||||
<p><em>{{ report.summary }}</em></p>
|
||||
<p>{{ report.analysis }}</p>
|
||||
</div>
|
||||
@@ -135,13 +135,13 @@
|
||||
{% if top_rules %}
|
||||
<div class="top-rules-chart">
|
||||
<h3>Top Rules Triggered</h3>
|
||||
{% for rule, cnt in top_rules %}
|
||||
{% for r in top_rules %}
|
||||
<div class="rule-bar-row">
|
||||
<span class="rule-name" title="{{ rule }}"><code>{{ rule }}</code></span>
|
||||
<span class="rule-name" title="{{ r.rule }}"><code>{{ r.rule }}</code></span>
|
||||
<div class="rule-bar-container">
|
||||
<div class="rule-bar" style="width: {{ (cnt / top_rules[0][1] * 100) | int if top_rules[0][1] > 0 else 0 }}%;"></div>
|
||||
<div class="rule-bar" style="width: {{ (r.count / top_rules[0].count * 100) | int if top_rules[0].count > 0 else 0 }}%;"></div>
|
||||
</div>
|
||||
<span class="rule-count">{{ cnt }}</span>
|
||||
<span class="rule-count">{{ r.count }}</span>
|
||||
</div>
|
||||
{% endfor %}
|
||||
</div>
|
||||
|
||||
@@ -57,6 +57,29 @@
|
||||
</div>
|
||||
<pre><code id="code-{{ f.id }}">{{ f.data.code }}</code></pre>
|
||||
{% endif %}
|
||||
|
||||
{% if f.report %}
|
||||
<div class="llm-report">
|
||||
<strong>LLM Analysis</strong>
|
||||
<span class="verdict-{{ f.report.verdict }}">[{{ f.report.verdict }}]</span>
|
||||
<span class="severity-{{ f.report.severity_rating }}">({{ f.report.severity_rating }})</span>
|
||||
<p><em>{{ f.report.summary }}</em></p>
|
||||
<p>{{ f.report.analysis }}</p>
|
||||
</div>
|
||||
{% else %}
|
||||
<div class="llm-actions" id="llm-{{ f.id }}">
|
||||
<button class="outline"
|
||||
hx-post="/api/v1/findings/{{ f.id }}/analyze"
|
||||
hx-target="#llm-{{ f.id }}"
|
||||
hx-swap="outerHTML"
|
||||
hx-indicator="#llm-spinner-{{ f.id }}">
|
||||
<span id="llm-spinner-{{ f.id }}" class="htmx-indicator" style="display:none;">
|
||||
<span class="spinner"></span>
|
||||
</span>
|
||||
Analyze with LLM
|
||||
</button>
|
||||
</div>
|
||||
{% endif %}
|
||||
</div>
|
||||
</details>
|
||||
{% endfor %}
|
||||
|
||||
@@ -51,6 +51,29 @@
|
||||
</div>
|
||||
<pre><code id="code-{{ f.id }}">{{ f.data.code }}</code></pre>
|
||||
{% endif %}
|
||||
|
||||
{% if f.report %}
|
||||
<div class="llm-report">
|
||||
<strong>LLM Analysis</strong>
|
||||
<span class="verdict-{{ f.report.verdict }}">[{{ f.report.verdict }}]</span>
|
||||
<span class="severity-{{ f.report.severity_rating }}">({{ f.report.severity_rating }})</span>
|
||||
<p><em>{{ f.report.summary }}</em></p>
|
||||
<p>{{ f.report.analysis }}</p>
|
||||
</div>
|
||||
{% else %}
|
||||
<div class="llm-actions" id="llm-{{ f.id }}">
|
||||
<button class="outline"
|
||||
hx-post="/api/v1/findings/{{ f.id }}/analyze"
|
||||
hx-target="#llm-{{ f.id }}"
|
||||
hx-swap="outerHTML"
|
||||
hx-indicator="#llm-spinner-{{ f.id }}">
|
||||
<span id="llm-spinner-{{ f.id }}" class="htmx-indicator" style="display:none;">
|
||||
<span class="spinner"></span>
|
||||
</span>
|
||||
Analyze with LLM
|
||||
</button>
|
||||
</div>
|
||||
{% endif %}
|
||||
</div>
|
||||
</details>
|
||||
{% endfor %}
|
||||
|
||||
Reference in New Issue
Block a user