:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
from typing import Any, Literal
import structlog
from posthog.dataclasses import frozen
from posthog.models import User
from products.error_tracking.backend.logic import build_issue_permalink_path, get_canonical_fingerprint
from products.error_tracking.backend.models import ErrorTrackingIssueAssignment
from products.notifications.backend.facade.api import (
NotificationData,
NotificationType,
Priority,
RecipientsResolver,
SourceType,
TargetType,
create_notification,
)
logger = structlog.get_logger(__name__)
class _AssignerExcludingResolver(RecipientsResolver):
def __init__(self, assigner_id: int) -> None:
super().__init__()
self._assigner_id = assigner_id
def resolve(self, target_type: TargetType, target_id: str, team_id: int | None) -> list[int]:
users = super().resolve(target_type, target_id, team_id)
return [uid for uid in users if uid != self._assigner_id]
@frozen
class AssignmentActor:
label: str
user_id: int | None
def __post_init__(self) -> None:
if not self.label:
raise ValueError("label is required")
@property
def trigger(self) -> Literal["manual", "automatic"]:
return "manual" if self.user_id is not None else "automatic"
@classmethod
def from_user(cls, user: User) -> "AssignmentActor":
return cls(label=user.first_name or user.email, user_id=user.id)
@classmethod
def automatic(cls, label: str) -> "AssignmentActor":
return cls(label=label, user_id=None)
def dispatch_issue_assigned_realtime(
*,
assignment: ErrorTrackingIssueAssignment,
assignee: dict[str, Any],
actor: AssignmentActor,
) -> None:
"""Fire one in-app issue_assigned notification for the new assignee.
- User assignment: skip if the actor is the assignee.
- Role assignment: target the role; resolver excludes the acting user.
Never raises — caller's email enqueue must succeed independently.
"""
try:
if assignment.team_id is None:
return
team = assignment.team
assert team is not None # team_id is set, so the FK is non-null (Django stubs disagree)
issue = assignment.issue
title = f"{actor.label} assigned an issue to you"[:100]
metadata = {"trigger": actor.trigger}
body = (issue.name or "")[:200]
fingerprint = get_canonical_fingerprint(team_id=assignment.team_id, issue_id=issue.id)
source_url = build_issue_permalink_path(project_id=team.project_id, issue_id=issue.id, fingerprint=fingerprint)
if assignee["type"] == "user":
if int(assignee["id"]) == actor.user_id:
return
target_type = TargetType.USER
resolver = None
elif assignee["type"] == "role":
target_type = TargetType.ROLE
resolver = _AssignerExcludingResolver(assigner_id=actor.user_id) if actor.user_id is not None else None
else:
return
create_notification(
NotificationData(
team_id=assignment.team_id,
notification_type=NotificationType.ISSUE_ASSIGNED,
priority=Priority.NORMAL,
title=title,
body=body,
target_type=target_type,
target_id=str(assignee["id"]),
resource_type="error_tracking",
resource_id=str(issue.id),
source_url=source_url,
source_type=SourceType.ERROR_TRACKING,
source_id=str(issue.id),
metadata=metadata,
resolver=resolver,
)
)
except Exception as e:
logger.exception(
"issue_assigned.realtime_failed",
issue_id=str(assignment.issue_id),
error=str(e),
)