truthound-dashboard 1.1.0__py3-none-any.whl → 1.2.0__py3-none-any.whl

truthound_dashboard/schemas/glossary.py

@@ -0,0 +1,349 @@
+"""Pydantic schemas for Business Glossary API.
+
+This module defines request/response schemas for glossary terms,
+categories, and relationships.
+"""
+
+from __future__ import annotations
+
+from datetime import datetime
+from enum import Enum
+
+from pydantic import Field, field_validator
+
+from .base import BaseSchema, IDMixin, ListResponseWrapper, TimestampMixin
+
+
+# =============================================================================
+# Enums
+# =============================================================================
+
+
+class TermStatus(str, Enum):
+    """Status of a glossary term."""
+
+    DRAFT = "draft"
+    APPROVED = "approved"
+    DEPRECATED = "deprecated"
+
+
+class RelationshipType(str, Enum):
+    """Type of relationship between terms."""
+
+    SYNONYM = "synonym"
+    RELATED = "related"
+    PARENT = "parent"
+    CHILD = "child"
+
+
+# =============================================================================
+# Category Schemas
+# =============================================================================
+
+
+class CategoryBase(BaseSchema):
+    """Base schema for glossary categories."""
+
+    name: str = Field(..., min_length=1, max_length=255, description="Category name")
+    description: str | None = Field(None, description="Category description")
+    parent_id: str | None = Field(None, description="Parent category ID")
+
+
+class CategoryCreate(CategoryBase):
+    """Schema for creating a glossary category."""
+
+    pass
+
+
+class CategoryUpdate(BaseSchema):
+    """Schema for updating a glossary category."""
+
+    name: str | None = Field(None, min_length=1, max_length=255)
+    description: str | None = None
+    parent_id: str | None = None
+
+
+class CategorySummary(BaseSchema, IDMixin):
+    """Summary schema for category references."""
+
+    name: str
+    full_path: str | None = None
+
+
+class CategoryResponse(BaseSchema, IDMixin, TimestampMixin):
+    """Response schema for a glossary category."""
+
+    name: str
+    description: str | None
+    parent_id: str | None
+    parent: CategorySummary | None = None
+    term_count: int = 0
+    full_path: str
+
+    @classmethod
+    def from_model(cls, category: any) -> CategoryResponse:
+        """Create response from model."""
+        parent_summary = None
+        if category.parent:
+            parent_summary = CategorySummary(
+                id=category.parent.id,
+                name=category.parent.name,
+                full_path=category.parent.full_path,
+            )
+        return cls(
+            id=category.id,
+            name=category.name,
+            description=category.description,
+            parent_id=category.parent_id,
+            parent=parent_summary,
+            term_count=category.term_count,
+            full_path=category.full_path,
+            created_at=category.created_at,
+            updated_at=category.updated_at,
+        )
+
+
+class CategoryListResponse(ListResponseWrapper[CategoryResponse]):
+    """Paginated list of categories."""
+
+    pass
+
+
+# =============================================================================
+# Term Schemas
+# =============================================================================
+
+
+class TermBase(BaseSchema):
+    """Base schema for glossary terms."""
+
+    name: str = Field(..., min_length=1, max_length=255, description="Term name")
+    definition: str = Field(..., min_length=1, description="Term definition")
+    category_id: str | None = Field(None, description="Category ID")
+    status: TermStatus = Field(default=TermStatus.DRAFT, description="Term status")
+    owner_id: str | None = Field(None, description="Owner identifier")
+
+
+class TermCreate(TermBase):
+    """Schema for creating a glossary term."""
+
+    @field_validator("name")
+    @classmethod
+    def validate_name(cls, v: str) -> str:
+        """Validate term name."""
+        return v.strip()
+
+    @field_validator("definition")
+    @classmethod
+    def validate_definition(cls, v: str) -> str:
+        """Validate term definition."""
+        return v.strip()
+
+
+class TermUpdate(BaseSchema):
+    """Schema for updating a glossary term."""
+
+    name: str | None = Field(None, min_length=1, max_length=255)
+    definition: str | None = Field(None, min_length=1)
+    category_id: str | None = None
+    status: TermStatus | None = None
+    owner_id: str | None = None
+
+
+class TermSummary(BaseSchema, IDMixin):
+    """Summary schema for term references."""
+
+    name: str
+    status: TermStatus
+
+
+class RelatedTermSummary(BaseSchema, IDMixin):
+    """Summary for related terms with relationship type."""
+
+    name: str
+    status: TermStatus
+    relationship_type: RelationshipType
+
+
+class TermResponse(BaseSchema, IDMixin, TimestampMixin):
+    """Response schema for a glossary term."""
+
+    name: str
+    definition: str
+    category_id: str | None
+    category: CategorySummary | None = None
+    status: TermStatus
+    owner_id: str | None
+    synonyms: list[TermSummary] = Field(default_factory=list)
+    related_terms: list[TermSummary] = Field(default_factory=list)
+    mapped_column_count: int = 0
+
+    @classmethod
+    def from_model(cls, term: any) -> TermResponse:
+        """Create response from model."""
+        category_summary = None
+        if term.category:
+            category_summary = CategorySummary(
+                id=term.category.id,
+                name=term.category.name,
+                full_path=term.category.full_path,
+            )
+
+        synonyms = [
+            TermSummary(id=t.id, name=t.name, status=TermStatus(t.status))
+            for t in term.synonyms
+        ]
+
+        related = [
+            TermSummary(id=t.id, name=t.name, status=TermStatus(t.status))
+            for t in term.related_terms
+        ]
+
+        return cls(
+            id=term.id,
+            name=term.name,
+            definition=term.definition,
+            category_id=term.category_id,
+            category=category_summary,
+            status=TermStatus(term.status),
+            owner_id=term.owner_id,
+            synonyms=synonyms,
+            related_terms=related,
+            mapped_column_count=len(term.mapped_columns),
+            created_at=term.created_at,
+            updated_at=term.updated_at,
+        )
+
+
+class TermListItem(BaseSchema, IDMixin, TimestampMixin):
+    """List item schema for terms (lighter than full response)."""
+
+    name: str
+    definition: str
+    category_id: str | None
+    category_name: str | None = None
+    status: TermStatus
+    owner_id: str | None
+    synonym_count: int = 0
+    related_count: int = 0
+
+    @classmethod
+    def from_model(cls, term: any) -> TermListItem:
+        """Create list item from model."""
+        return cls(
+            id=term.id,
+            name=term.name,
+            definition=term.definition,
+            category_id=term.category_id,
+            category_name=term.category.name if term.category else None,
+            status=TermStatus(term.status),
+            owner_id=term.owner_id,
+            synonym_count=len(term.synonyms),
+            related_count=len(term.related_terms),
+            created_at=term.created_at,
+            updated_at=term.updated_at,
+        )
+
+
+class TermListResponse(ListResponseWrapper[TermListItem]):
+    """Paginated list of terms."""
+
+    pass
+
+
+# =============================================================================
+# Relationship Schemas
+# =============================================================================
+
+
+class RelationshipBase(BaseSchema):
+    """Base schema for term relationships."""
+
+    source_term_id: str = Field(..., description="Source term ID")
+    target_term_id: str = Field(..., description="Target term ID")
+    relationship_type: RelationshipType = Field(..., description="Relationship type")
+
+
+class RelationshipCreate(RelationshipBase):
+    """Schema for creating a term relationship."""
+
+    @field_validator("target_term_id")
+    @classmethod
+    def validate_different_terms(cls, v: str, info) -> str:
+        """Validate that source and target are different."""
+        if info.data.get("source_term_id") == v:
+            raise ValueError("Source and target terms must be different")
+        return v
+
+
+class RelationshipResponse(BaseSchema, IDMixin):
+    """Response schema for a term relationship."""
+
+    source_term_id: str
+    target_term_id: str
+    source_term: TermSummary
+    target_term: TermSummary
+    relationship_type: RelationshipType
+    created_at: datetime
+
+    @classmethod
+    def from_model(cls, rel: any) -> RelationshipResponse:
+        """Create response from model."""
+        return cls(
+            id=rel.id,
+            source_term_id=rel.source_term_id,
+            target_term_id=rel.target_term_id,
+            source_term=TermSummary(
+                id=rel.source_term.id,
+                name=rel.source_term.name,
+                status=TermStatus(rel.source_term.status),
+            ),
+            target_term=TermSummary(
+                id=rel.target_term.id,
+                name=rel.target_term.name,
+                status=TermStatus(rel.target_term.status),
+            ),
+            relationship_type=RelationshipType(rel.relationship_type),
+            created_at=rel.created_at,
+        )
+
+
+class RelationshipListResponse(ListResponseWrapper[RelationshipResponse]):
+    """List of relationships."""
+
+    pass
+
+
+# =============================================================================
+# History Schemas
+# =============================================================================
+
+
+class TermHistoryResponse(BaseSchema, IDMixin):
+    """Response schema for term change history."""
+
+    term_id: str
+    field_name: str
+    old_value: str | None
+    new_value: str | None
+    changed_by: str | None
+    changed_at: datetime
+
+    @classmethod
+    def from_model(cls, history: any) -> TermHistoryResponse:
+        """Create response from model."""
+        return cls(
+            id=history.id,
+            term_id=history.term_id,
+            field_name=history.field_name,
+            old_value=history.old_value,
+            new_value=history.new_value,
+            changed_by=history.changed_by,
+            changed_at=history.changed_at,
+        )
+
+
+class TermHistoryListResponse(ListResponseWrapper[TermHistoryResponse]):
+    """List of term history entries."""
+
+    pass

{truthound_dashboard-1.1.0.dist-info → truthound_dashboard-1.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: truthound-dashboard
-Version: 1.1.0
+Version: 1.2.0
 Summary: Open-source data quality dashboard - GX Cloud alternative
 Author-email: Truthound Team <team@truthound.dev>
 License-Expression: Apache-2.0
@@ -75,6 +75,8 @@ truthound-dashboard provides a graphical interface for managing data sources, ex
 | Webhook Notifications | Available | Available |
 | Drift Detection | Available | Available |
 | Data Profiling | Available | Available |
+| Business Glossary | Available | Available |
+| Data Catalog | Available | Available |
 | Dark Mode | Available | Available |
 | Multi-language (en/ko) | Not Available | Available |
 | License | Commercial | Apache 2.0 |
@@ -147,6 +149,24 @@ The dashboard interface is accessible at `http://localhost:8765`.
 - Statistical profiling using `th.profile`
 - Column-level statistics
 
+### Business Glossary
+- Business term definitions with categories
+- Term relationships (synonyms, related terms)
+- Term lifecycle management (draft, approved, deprecated)
+- Change history tracking
+
+### Data Catalog
+- Data asset registration (tables, files, APIs)
+- Column-level metadata management
+- Column-to-term mapping
+- Quality score tracking
+- Sensitivity classification (public, internal, confidential, restricted)
+- Custom tagging
+
+### Collaboration
+- Comments on terms, assets, and columns
+- Activity feed for tracking changes
+
 ### User Interface
 - Light and dark theme support
 - Internationalization: English, Korean

{truthound_dashboard-1.1.0.dist-info → truthound_dashboard-1.2.0.dist-info}/RECORD

@@ -4,21 +4,24 @@ truthound_dashboard/cli.py,sha256=1x7AN2g9H5pZ4sG2PakCpSdBYnviknJv7LRIauAPzgU,19
 truthound_dashboard/config.py,sha256=fBSxoGitTe-9SeKkkQHtqNTcVxws5fvJ0YhF0EMuqG4,4089
 truthound_dashboard/main.py,sha256=tfwmNCRZ2RBub68KwAvO6a6d9LJB-S5YwZtjR6X0ywk,8129
 truthound_dashboard/api/__init__.py,sha256=rnbuYRDgh0GcqkR-d9Trkc8L0O34K4tMH6flyeQ9U98,361
+truthound_dashboard/api/catalog.py,sha256=qQlsM4ubzjvI6rXwSY5214C-W93Ai-Xu1YjGVs1OoxE,10928
+truthound_dashboard/api/collaboration.py,sha256=DxfpdUl_e8NfvDzv6-uwR32NN3Us7lLkzcif8RhvKyg,4720
 truthound_dashboard/api/deps.py,sha256=RqfEi6tp0OO9n5_Sh6QqoiiS4Gr7z77VMS-M6gEcbUY,3700
 truthound_dashboard/api/drift.py,sha256=pqpifxAifYVy2xr5EmGtLqZHfYYJ5exvrpWoB9eSEWo,5682
 truthound_dashboard/api/error_handlers.py,sha256=agovu0-CgMevgSvHh2aQnPjFpu1Wul_e67Vh9FAX_vM,8682
+truthound_dashboard/api/glossary.py,sha256=Zdks7iHC9OLovgMJ28TELaET74OTQmUjP2TEwRLC8K4,10705
 truthound_dashboard/api/health.py,sha256=84UPWmnS-9Fqs39SyRD2gu4QPE3ZJkaqkp5qCHkizsw,1927
 truthound_dashboard/api/history.py,sha256=b6fy1pZfuwBqk3Yfeqnu8kaQcdNgWFMT7-0_29jLGOI,1792
 truthound_dashboard/api/middleware.py,sha256=4oqRCT6UhY-7HwoCy96b3vhaO7XBSrCW912IxAoDm-Q,19598
 truthound_dashboard/api/notifications.py,sha256=U1_VvgzAI3x5aKRg3zces1UwpbN9g-Tt6WFaOJziNfc,16800
 truthound_dashboard/api/profile.py,sha256=VtBpYGXuY1KbksWAornAVvrHsFnMjFXuKiUb6qp8Q3A,1389
-truthound_dashboard/api/router.py,sha256=abwYifmVaW6nUY-GyDvvQfqjkHQ9C82OHz6OK4Sqik0,1397
+truthound_dashboard/api/router.py,sha256=ygiG6SzTETRQt5ystM1vJ2W-hDOwbpAt_ZzzRYyYKj0,2067
 truthound_dashboard/api/rules.py,sha256=6xcE5g7w9e_mt4M_XS7egIa16zcynYmXctmyayAKICs,7453
 truthound_dashboard/api/schedules.py,sha256=NMLU0szgZ2lGvVGuSJuEACZvc2qoeN65H-d2ANprj6E,8716
 truthound_dashboard/api/schemas.py,sha256=zkx3RNffRxtON-XUo1Xu5h13eIg63qs5pLdcM5atHuQ,3759
 truthound_dashboard/api/sources.py,sha256=uerDNqqQ4OVua_JbsDVS0fMMis-Q09mwQf6FiiOqRPU,5967
 truthound_dashboard/api/validations.py,sha256=D-8OyV8SuEAphTBhXEyclEZO_Jc-CjQ3ZqgZhXZLWHg,3557
-truthound_dashboard/core/__init__.py,sha256=gTKyzGPV8tfT6aFcLAC9bK0p4LKWjoq1yw3w1gtA5ME,6581
+truthound_dashboard/core/__init__.py,sha256=AZryDS-BFT-LGsSJVqKXfe1iahf3AUsdpPFq2VgJVe8,6829
 truthound_dashboard/core/base.py,sha256=Jp2NFNCacIt2DStGOSvyUYnx1wV-FqDkX9gLroCbo5I,5293
 truthound_dashboard/core/cache.py,sha256=AP_7S5mK44vpQaTn5j2caQ5zumVdiQ7mICA4lIeK9y8,13937
 truthound_dashboard/core/connections.py,sha256=tytG1eyvRDXtfxIHvzInMAKtvZXYjXWgCvtrACH_RAk,9997
@@ -36,14 +39,22 @@ truthound_dashboard/core/notifications/channels.py,sha256=Z2TNrW81u2QJWvhd4Z6n2m
 truthound_dashboard/core/notifications/dispatcher.py,sha256=GXwqcss8_jnJL68BDaLy1Ld7OkLh4TiO3zj0Zf4l9_M,14077
 truthound_dashboard/core/notifications/events.py,sha256=mIkbW4m_8ofj1oYxm7o5FAxxJzP7_SIAz8WB1SeRdm4,4913
 truthound_dashboard/core/notifications/service.py,sha256=sPgfT-kow_gHoN9FaTuWXLXjo_LLwzJogelNPv5GiHM,21169
-truthound_dashboard/db/__init__.py,sha256=L4kwPQfFPw5rT0X7q-6V6zSHYDYgVpAB4Ti7SEJPZVc,1419
+truthound_dashboard/core/phase5/__init__.py,sha256=-TNyj28lQC1YjoUtBBJj3ztksN65820Y-BWZRGIEOWA,447
+truthound_dashboard/core/phase5/activity.py,sha256=GFCh4eU7ovDKUC_nE4j7Rk5CdxVLeUoF50A3_a6MvJk,4272
+truthound_dashboard/core/phase5/catalog.py,sha256=hLVaIHxe9BxNp2Tdf7Ru-IIH-xDqUOOitN17zQmLuis,24241
+truthound_dashboard/core/phase5/collaboration.py,sha256=5c2UXVZDGGTkAZ3N3onagNof-hza31tE1ak8t5uM4o0,8331
+truthound_dashboard/core/phase5/glossary.py,sha256=6v3hYXpCQTZ5xaFwBM0IrXMiOeW4giNldHIjdY88ROA,24751
+truthound_dashboard/db/__init__.py,sha256=e9jfHGvyNErb1RnA5x5ZXCIEenXxLjROP_yxQAu9oZk,2169
 truthound_dashboard/db/base.py,sha256=nj6DbYxAl5JoY0hC5rtM7pshOKpe-OH-AFsQqPGQzsM,2832
 truthound_dashboard/db/database.py,sha256=yQ9FsQSi29HvvW0t6BrkyX5YcHijRJEjGTTGfcCCw10,5078
-truthound_dashboard/db/models.py,sha256=spBx2_pWKutb-H6H-c31ByQvpS4kNmhTXA5kTvOtWME,25742
+truthound_dashboard/db/models.py,sha256=rlVOcDCgHbup_L1wH6D9FICc_ZcVyHaQDYT_94s6LZY,47138
 truthound_dashboard/db/repository.py,sha256=48AJd65rwTSt1XqTN4vUeJ8nk416buE254JqipDCEEE,6890
-truthound_dashboard/schemas/__init__.py,sha256=8TQsBDD6X3vFspkz8s4qvbW9QPdjiGkYCDiUKQOdEUs,3156
+truthound_dashboard/schemas/__init__.py,sha256=V-nrFHeKTSY55X6KyV2x0f0_-NgDLYrq8YeN8hlsb0Q,5546
 truthound_dashboard/schemas/base.py,sha256=lJUWh47Lz4E4sBGQDSS8jIfuSsTDbfxuOxvAMsvxfOg,2977
+truthound_dashboard/schemas/catalog.py,sha256=Gc0ky7kuWyo7naJqyyJe-S9JDF5Ge_c9oeVpUEarQqw,10556
+truthound_dashboard/schemas/collaboration.py,sha256=llFr14sm634pbqR9db4l8wH979jn2VpVUmi6DJ6dtHk,4864
 truthound_dashboard/schemas/drift.py,sha256=84jUqv6eTwdRlTwA1ZHf_BgnZej4gImyMcYEmAL3dDU,4361
+truthound_dashboard/schemas/glossary.py,sha256=pY35k4zIf_4FYsdElD5fZJdJsPPQCn0Kk-EdwF8OCmI,10240
 truthound_dashboard/schemas/history.py,sha256=OVzBmbw7uz0C4IWt43P8QxNl9_OO_-WZRdA7L44_9yo,2771
 truthound_dashboard/schemas/profile.py,sha256=doM_RadBzXW5nt3_jus1AcExSjqa0BUYrE-qJb-GI_s,2920
 truthound_dashboard/schemas/rule.py,sha256=eIx9CdQ-gC6i-BpVsX714y-l0-TWY6VOVr0nSTkn_bk,5207
@@ -67,8 +78,8 @@ truthound_dashboard/translate/providers/mistral.py,sha256=j0oh_mGksdMuIfbuZKq0yo
 truthound_dashboard/translate/providers/ollama.py,sha256=XlAHE14VvdSPKFbrJIbB3KUHzrgQm0Zj08snL71otUQ,7286
 truthound_dashboard/translate/providers/openai.py,sha256=AeaOfRjNgCIgBdcX1gcYqqf41fXeEIyN3AiLAOy3SZc,6760
 truthound_dashboard/translate/providers/registry.py,sha256=iwfcWYJ2uKfwWjsalhV4jSoyZC7bSeujK6sTMuylMMY,6474
-truthound_dashboard-1.1.0.dist-info/METADATA,sha256=cQtjDqPX43DuUrf6ahIiIk2bf3OGpJQPYiAS78e_QsI,10494
-truthound_dashboard-1.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-truthound_dashboard-1.1.0.dist-info/entry_points.txt,sha256=Xq8qadJ-Sqk4_0Ss_rhCqCv7uxPZZdwO3WUnbK0r6Hw,135
-truthound_dashboard-1.1.0.dist-info/licenses/LICENSE,sha256=qrBWTDMS8ZvwVJl3Yo2n8_AxOos3s8S9pcOzLW5Nivg,10763
-truthound_dashboard-1.1.0.dist-info/RECORD,,
+truthound_dashboard-1.2.0.dist-info/METADATA,sha256=zXyFedj1mi9MsRFA150nzYTGciHnDGk1bWNVQ3c40IA,11118
+truthound_dashboard-1.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+truthound_dashboard-1.2.0.dist-info/entry_points.txt,sha256=Xq8qadJ-Sqk4_0Ss_rhCqCv7uxPZZdwO3WUnbK0r6Hw,135
+truthound_dashboard-1.2.0.dist-info/licenses/LICENSE,sha256=qrBWTDMS8ZvwVJl3Yo2n8_AxOos3s8S9pcOzLW5Nivg,10763
+truthound_dashboard-1.2.0.dist-info/RECORD,,