834138368a
## Часть 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 где нужно
57 lines
2.2 KiB
Python
57 lines
2.2 KiB
Python
"""SQLAlchemy ORM models."""
|
|
|
|
import datetime
|
|
from enum import Enum
|
|
|
|
from sqlalchemy import JSON, Boolean, DateTime, ForeignKey, Integer, String, Text, func
|
|
from sqlalchemy.orm import Mapped, mapped_column, relationship
|
|
|
|
from guarddog_nexus.database import Base
|
|
|
|
|
|
class ScanStatus(str, Enum):
|
|
PENDING = "pending"
|
|
SCANNING = "scanning"
|
|
COMPLETED = "completed"
|
|
FAILED = "failed"
|
|
|
|
|
|
class Scan(Base):
|
|
__tablename__ = "scans"
|
|
|
|
id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True)
|
|
package_name: Mapped[str] = mapped_column(String(255), nullable=False)
|
|
package_version: Mapped[str] = mapped_column(String(255), nullable=False)
|
|
ecosystem: Mapped[str] = mapped_column(String(50), nullable=False, default="pypi")
|
|
repository: Mapped[str] = mapped_column(String(255), nullable=False)
|
|
nexus_asset_url: Mapped[str] = mapped_column(Text, nullable=False)
|
|
sha256: Mapped[str | None] = mapped_column(String(64), nullable=True)
|
|
status: Mapped[str] = mapped_column(
|
|
String(20), nullable=False, default=ScanStatus.PENDING.value
|
|
)
|
|
total_findings: Mapped[int] = mapped_column(Integer, nullable=False, default=0)
|
|
flagged: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False)
|
|
started_at: Mapped[datetime.datetime] = mapped_column(
|
|
DateTime, nullable=False, default=func.now()
|
|
)
|
|
finished_at: Mapped[datetime.datetime | None] = mapped_column(DateTime, nullable=True)
|
|
error_message: Mapped[str | None] = mapped_column(Text, nullable=True)
|
|
|
|
findings: Mapped[list["Finding"]] = relationship(
|
|
"Finding", back_populates="scan", cascade="all, delete-orphan"
|
|
)
|
|
|
|
|
|
class Finding(Base):
|
|
__tablename__ = "findings"
|
|
|
|
id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True)
|
|
scan_id: Mapped[int] = mapped_column(Integer, ForeignKey("scans.id"), nullable=False)
|
|
data: Mapped[dict] = mapped_column(JSON, nullable=False)
|
|
report: Mapped[dict | None] = mapped_column(JSON, nullable=True)
|
|
created_at: Mapped[datetime.datetime] = mapped_column(
|
|
DateTime, nullable=False, default=func.now()
|
|
)
|
|
|
|
scan: Mapped["Scan"] = relationship("Scan", back_populates="findings")
|