refactor

backend/src/models/dataset_review_pkg/_finding_models.py

@@ -0,0 +1,59 @@
+# [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]