Activity Framework
activity table to capture interesting events on server side. These events are captured to power our primary analytics needs.What is an activity?Activity is something done by an end user. It can also be things done on behalf
of end user via other systems, eg there if a PR is created on Github, it is an
activity done by an end user, and we come to know about the PR event when Github
notifies us via a webhook.
Activity is also created for offline activity done by a task. Tasks are also
created by end users, indirectly.
Ideally we want to preserve a one to one mapping between one activity done by
the end user and one row inserted in our activity table.
Activity is something done by an end user. It can also be things done on behalf of end user via other systems, eg there if a PR is created on Github, it is an activity done by an end user, and we come to know about the PR event when Github notifies us via a webhook.
Activity is also created for offline activity done by a task. Tasks are also created by end users, indirectly.
Ideally we want to preserve a one to one mapping between one activity done by the end user and one row inserted in our activity table.
okind, oid, ekindWe identify acitivities by okind/ekind pair. Each activity is assumed to
have happened on an object, eg user is an object, or pull request, github repo, github account, github app installation etc are objects.
okind represents the name of the object on which the activity happened. oid
represents unique ID of that object, and ekind represents the actual event
that happened.
The okinds that we know of right now are:
okind, oid, ekindWe identify acitivities by okind/ekind pair. Each activity is assumed to
have happened on an object, eg user is an object, or pull request, github repo, github account, github app installation etc are objects.
okind represents the name of the object on which the activity happened. oid
represents unique ID of that object, and ekind represents the actual event
that happened.
The okinds that we know of right now are:
analytics.events.OKindclass OKind(Enum): USER = "USER" PULL_REQUEST = "PULL_REQUEST" REPOSITORY = "REPOSITORY" ORGANIZATION = "ORGANIZATION" INSTALLATION = "INSTALLATION" VISIT = "VISIT"
ekind’s that we know of right now are:analytics.events.EKindclass EKind(Enum): GET = "GET" CREATE = "CREATE" UPDATE = "UPDATE" LOGIN = "LOGIN" GITHUB_HANDOVER = "GITHUB_HANDOVER" CONNECT = "CONNECT" DISCONNECT = "DISCONNECT"