-
Notifications
You must be signed in to change notification settings - Fork 197
General merit workflow
This is an explanation of how does merit process reputation starting from an HTTP request made to an endpoint with associated rules[1]. It's meant for merit developers, not directly helpful for application set up.
-
Merit sets an application-wide
after_filter
, which creates amerit_action
for the request if that controller/action pair has associated rules. -
Controller
after_filter
tellsMeritAction
class to process it's unprocessed activity (will typically be the newly createdmerit_action
). It can be done synchronously (default) or as a background job. -
merit_action
asks ajudge
to grant reputation, given the sash and rule in question. -
The
judge
will grant or remove badges and points from it'ssash
according torule
[1] conditions.
[1] Reputation rules are set in the application via the DSL defined in files rules_{badge|points|rank}_methods.rb
Merit installs following tables to the app:
-
merit_actions
is meant for internal merit usage. It is the log of "meritable" actions and who triggered them, so that then it can compute per action if points or a badge is to be granted to someone. -
sashes
defines the Sash model, which has a one-to-one relationship with your "meritable" resources. It has some internally used methods, and it avoids join models. -
badges_sashes
is a relation table between Badges and "meritable" resources. There's only one join model per app, no matter how many meritable resources it has, thanks to theSash
model. Sash indirection should be invisible for the application, and should not be used. -
merit_score_points
holds an entry for each point granting/removing, with anum_points
integer and an optionallog
string. They belong tomerit_scores
which is an indirection between meritable resources and points, meant to hold (still to do) different categories for which a meritable resource may be scored. - It also adds new attributes on each resource:
sash_id
andlevel
.