From 81f9bbef22d5e9a4164c6899aa98aaf9be3c9f9b Mon Sep 17 00:00:00 2001
From: Cristhian Garcia <crisgarta8@gmail.com>
Date: Fri, 2 Jun 2023 11:20:36 -0500
Subject: [PATCH] feat: add signal for event-tracking emission

---
 openedx_events/analytics/__init__.py |  6 ++++++
 openedx_events/analytics/data.py     | 31 ++++++++++++++++++++++++++++
 openedx_events/analytics/signals.py  | 23 +++++++++++++++++++++
 3 files changed, 60 insertions(+)
 create mode 100644 openedx_events/analytics/__init__.py
 create mode 100644 openedx_events/analytics/data.py
 create mode 100644 openedx_events/analytics/signals.py

diff --git a/openedx_events/analytics/__init__.py b/openedx_events/analytics/__init__.py
new file mode 100644
index 00000000..5410a5f4
--- /dev/null
+++ b/openedx_events/analytics/__init__.py
@@ -0,0 +1,6 @@
+"""
+Package where events related to the analytics subdomain are implemented.
+
+The analytics subdomain corresponds to {Architecture Subdomain} defined in
+the OEP-41.
+"""
diff --git a/openedx_events/analytics/data.py b/openedx_events/analytics/data.py
new file mode 100644
index 00000000..67f2e6cc
--- /dev/null
+++ b/openedx_events/analytics/data.py
@@ -0,0 +1,31 @@
+"""
+Data attributes for events within the architecture subdomain ``analytics``.
+
+These attributes follow the form of attr objects specified in OEP-49 data
+pattern.
+
+The attributes for the events come from the CourseDetailView in the LMS, with some unused fields removed
+(see deprecation proposal at https://github.com/openedx/public-engineering/issues/160)
+"""
+
+from datetime import datetime
+
+import attr
+
+
+@attr.s(frozen=True)
+class TrackingLogData:
+    """
+    Data describing tracking log data.
+
+    Arguments:
+        name (str): course name
+        timestamp (datetime): course start date
+        data (dict): dictionary of extra data (optional)
+        context (dict): dictionary of context data.
+    """
+
+    name = attr.ib(type=str)
+    timestamp = attr.ib(type=datetime)
+    data = attr.ib(type=dict, default={})
+    context = attr.ib(type=dict, factory=dict)
diff --git a/openedx_events/analytics/signals.py b/openedx_events/analytics/signals.py
new file mode 100644
index 00000000..4513cbd5
--- /dev/null
+++ b/openedx_events/analytics/signals.py
@@ -0,0 +1,23 @@
+"""
+Standardized signals definitions for events within the architecture subdomain ``analytics``.
+
+All signals defined in this module must follow the name and versioning
+conventions specified in OEP-41.
+
+They also must comply with the payload definition specified in
+docs/decisions/0003-events-payload.rst
+"""
+
+from openedx_events.analytics.data import TrackingLogData
+from openedx_events.tooling import OpenEdxPublicSignal
+
+# .. event_type: org.openedx.analytics.event_tracking.emitted.v1
+# .. event_name: TRACKING_EVENT_EMITTED
+# .. event_description: emitted when a grade changes in the course
+# .. event_data: TrackingLogData
+TRACKING_EVENT_EMITTED = OpenEdxPublicSignal(
+    event_type="org.openedx.analytics.event_tracking.emitted.v1",
+    data={
+        "tracking_log": TrackingLogData,
+    }
+)