## Часть 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 где нужно
85 lines
3.8 KiB
HTML
85 lines
3.8 KiB
HTML
{% extends "base.html" %}
|
|
{% block title %}Scan #{{ scan.id }} — GuardDog Nexus{% endblock %}
|
|
{% block breadcrumbs %}
|
|
<div class="breadcrumbs">
|
|
<a href="/">Home</a>
|
|
<span class="separator">/</span>
|
|
<a href="/scans">Scans</a>
|
|
<span class="separator">/</span>
|
|
<span>Scan #{{ scan.id }}</span>
|
|
</div>
|
|
{% endblock %}
|
|
{% block content %}
|
|
<h1>Scan #{{ scan.id }}</h1>
|
|
|
|
<table>
|
|
<tr><td><strong>Package</strong></td><td><a href="/packages/{{ scan.package_name }}/{{ scan.package_version }}">{{ scan.package_name }}</a></td></tr>
|
|
<tr><td><strong>Version</strong></td><td>{{ scan.package_version }}</td></tr>
|
|
<tr><td><strong>Ecosystem</strong></td><td>{{ scan.ecosystem }}</td></tr>
|
|
<tr><td><strong>Repository</strong></td><td>{{ scan.repository }}</td></tr>
|
|
<tr><td><strong>Status</strong></td><td>
|
|
{% if scan.status == 'scanning' %}<span class="status-scanning"><span class="spinner"></span>scanning</span>{% else %}<span class="status-{{ scan.status }}">{{ scan.status }}</span>{% endif %}
|
|
</td></tr>
|
|
<tr><td><strong>SHA256</strong></td><td><code>{{ scan.sha256 or '-' }}</code></td></tr>
|
|
<tr><td><strong>Started</strong></td><td>{{ scan.started_at.isoformat() if scan.started_at }}</td></tr>
|
|
<tr><td><strong>Finished</strong></td><td>{{ scan.finished_at.isoformat() if scan.finished_at }}</td></tr>
|
|
{% if scan.error_message %}<tr><td><strong>Error</strong></td><td><span class="flagged">{{ scan.error_message }}</span></td></tr>{% endif %}
|
|
</table>
|
|
|
|
<div class="finding-header-row">
|
|
<h2>Findings ({{ scan.findings|length }})</h2>
|
|
{% if scan.findings|length > 1 %}
|
|
<button class="toggle-all-btn" onclick="toggleFindings()">Collapse All</button>
|
|
{% endif %}
|
|
</div>
|
|
|
|
{% if scan.findings %}
|
|
<div id="findings-container">
|
|
{% for f in scan.findings %}
|
|
<details class="finding-card {{ f.data.severity }}" data-finding-id="{{ f.id }}">
|
|
<summary class="finding-summary">
|
|
<strong class="severity-{{ f.data.severity }}">[{{ f.data.severity }}]</strong>
|
|
<strong>{{ f.data.rule }}</strong>
|
|
{% if f.data.location %}<small> @ {{ f.data.location }}</small>{% endif %}
|
|
<span class="finding-summary-hint">click to expand</span>
|
|
</summary>
|
|
<div class="finding-details">
|
|
<p>{{ f.data.message }}</p>
|
|
{% if f.data.code %}
|
|
<div class="code-toolbar">
|
|
<button class="copy-btn" onclick="copyCode(this, 'code-{{ f.id }}')">Copy</button>
|
|
</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 %}
|
|
</div>
|
|
{% else %}
|
|
<p class="empty-state">No findings — package looks clean.</p>
|
|
{% endif %}
|
|
{% endblock %}
|