feat(awooop): show inbound event dossiers

apps/api/src/api/v1/platform/events.py

@@ -13,6 +13,7 @@ from uuid import UUID
 from fastapi import APIRouter, Query
 from pydantic import BaseModel
 
+from src.services.channel_event_dossier_service import fetch_channel_event_dossier
 from src.services.platform_operator_service import list_recent_channel_events
 
 router = APIRouter()
@@ -35,6 +36,70 @@ class RecentEventsResponse(BaseModel):
     limit: int
 
 
+class ChannelEventDossierItem(BaseModel):
+    event_id: UUID
+    project_id: str
+    channel_type: str
+    provider: str | None
+    stage: str
+    provider_event_id: str
+    content_preview: str | None
+    content_redacted: str | None
+    has_redacted_content: bool
+    redaction_version: str | None
+    source_url: str | None
+    content_sha256: str | None
+    content_length: int | None
+    source_refs: dict[str, Any]
+    source_ref_count: int
+    log_correlation: dict[str, Any]
+    alertname: str | None
+    severity: str | None
+    namespace: str | None
+    target_resource: str | None
+    fingerprint: str | None
+    is_duplicate: bool
+    provider_ts: datetime | None
+    received_at: datetime
+
+
+class ChannelEventDossierSummary(BaseModel):
+    source_count: int
+    duplicate_total: int
+    redacted_total: int
+    source_ref_total: int
+
+
+class ChannelEventDossierResponse(BaseModel):
+    events: list[ChannelEventDossierItem]
+    total: int
+    limit: int
+    summary: ChannelEventDossierSummary
+
+
+@router.get(
+    "/events/dossier",
+    response_model=ChannelEventDossierResponse,
+    summary="查詢 Channel Event 來源卷宗",
+    description=(
+        "返回 redacted inbound source envelope，供 AwoooP Run Detail 顯示"
+        "告警來源、source refs、Sentry / SignOz / Alertmanager 關聯與去重狀態。"
+    ),
+)
+async def get_event_dossier(
+    project_id: str | None = Query(None, description="租戶 ID（可選）"),
+    run_id: UUID | None = Query(None, description="Run ID（可選）"),
+    provider_event_id: str | None = Query(None, description="provider_event_id（可選）"),
+    limit: int = Query(20, ge=1, le=50, description="最多返回筆數"),
+) -> dict[str, Any]:
+    return await fetch_channel_event_dossier(
+        project_id=project_id,
+        run_id=run_id,
+        provider_event_id=provider_event_id,
+        limit=limit,
+    )
+
+
 @router.get(
     "/events/recent",
     response_model=RecentEventsResponse,