refactor: FastAPI best practices — return types, Pydantic schemas, middleware, code dedup

- Все 18 роутов получили return type annotations
- Создан schemas.py с Pydantic-моделями (ScanOut, PackageOut, FindingOut, ...)
- API-роуты: response_model на list/detail/export/stats
- 404 через HTTPException(404) вместо {'detail':'Not found'} (200)
- RequestLoggingMiddleware: method, path, status, duration_ms
- Глобальный exception handler: ловит необработанные исключения → 500
- _parse_flagged(): вынесен дублирующийся string→bool
- parse_package_path(): общий для web.py и api_packages.py
- selectinload: вынесены в top-level imports
- harvester: makedirs/mkdtemp/rmtree обёрнуты в asyncio.to_thread()

guarddog_nexus/routes/api_findings.py

@@ -13,11 +13,12 @@ from ..constants import (
 )
 from ..db.engine import get_session
 from ..db.models import Finding
+from ..schemas import FindingsListResponse
 
 router = APIRouter(prefix="/api/v1/findings", tags=["findings"])
 
 
-@router.get("")
+@router.get("", response_model=FindingsListResponse)
 async def list_findings(
     limit: int = Query(DEFAULT_PAGE_SIZE, le=MAX_PAGE_SIZE),
     offset: int = Query(DEFAULT_OFFSET, ge=0),
@@ -25,7 +26,7 @@ async def list_findings(
     severity: str | None = Query(None),
     scan_id: int | None = Query(None),
     session: AsyncSession = Depends(get_session),
-):
+) -> dict:
     q = select(Finding)
     if rule:
         q = q.where(func.json_extract(Finding.data, JSON_PATH_RULE) == rule)