Files
ss-tools/backend/src/models/dataset_review_pkg/_finding_models.py
2026-04-24 17:10:02 +03:00

60 lines
1.8 KiB
Python

# [DEF:DatasetReviewFindingModels:Module]
# @COMPLEXITY: 2
# @PURPOSE: Validation finding model for tracking blocking, warning, and informational issues during review.
# @LAYER: Domain
# @RELATION: DEPENDS_ON -> [DatasetReviewEnums:Module]
# @RELATION: DEPENDS_ON -> [MappingModels]
import uuid
from datetime import datetime
from sqlalchemy import (
Column,
String,
Text,
DateTime,
ForeignKey,
Enum as SQLEnum,
)
from sqlalchemy.orm import relationship
from src.models.mapping import Base
from src.models.dataset_review_pkg._enums import (
FindingArea,
FindingSeverity,
ResolutionState,
)
# [DEF:ValidationFinding:Class]
# @COMPLEXITY: 2
# @PURPOSE: Structured finding record for dataset review validation issues with resolution tracking.
# @RELATION: DEPENDS_ON -> [DatasetReviewSession]
class ValidationFinding(Base):
__tablename__ = "validation_findings"
finding_id = Column(String, primary_key=True, default=lambda: str(uuid.uuid4()))
session_id = Column(
String, ForeignKey("dataset_review_sessions.session_id"), nullable=False
)
area = Column(SQLEnum(FindingArea), nullable=False)
severity = Column(SQLEnum(FindingSeverity), nullable=False)
code = Column(String, nullable=False)
title = Column(String, nullable=False)
message = Column(Text, nullable=False)
resolution_state = Column(
SQLEnum(ResolutionState), nullable=False, default=ResolutionState.OPEN
)
resolution_note = Column(Text, nullable=True)
caused_by_ref = Column(String, nullable=True)
created_at = Column(DateTime, default=datetime.utcnow, nullable=False)
resolved_at = Column(DateTime, nullable=True)
session = relationship("DatasetReviewSession", back_populates="findings")
# [/DEF:ValidationFinding:Class]
# [/DEF:DatasetReviewFindingModels:Module]