Decidim: Follow a proposal

[josepjaume]

:tophat: User Story

We'll start with allowing users to follow a proposal, but we should keep in mind that users can follow other entities (like other users, a process, etc), so we have to implement it in a polymorphic, decoupled way.

When some action happens in a proposal we'll create a notification for each of its followers. We'll notify a user via email when a new notification has been created.

Creating the notification and sending the email should be done asynchronously.

:clipboard: Related documentation

• Button design: http://decidim-design.herokuapp.com/proposal-view/
• Notifications design: http://decidim-design.herokuapp.com/user-notifications/

Email example text:

[user name] has add a comment to [link to proposal] that you're following in [organization name]. To see more proposals [link to proposal index]. Unfollow this proposal [link to unfollow this proposal]

:dart: Acceptance criteria

As a user I can:

• Follow a proposal
• Unfollow a proposal
• Have a new notification when someone comments on the proposal
• Have a new notification if the proposal is approved or rejected (depends on https://github.com/AjuntamentdeBarcelona/decidim/issues/419)

:pushpin: Related issues

https://github.com/AjuntamentdeBarcelona/decidim.barcelona/issues/308

[andreslucena]

This feature should be Polymorphic: there should be possible to "Follow/Subscribe" to a Proposal/Debate/Participatory Process/etc.

[oriolgual]

@AjuntamentdeBarcelona/developers @arnaumonty check this please!

[josepjaume]

@oriolgual @andreslucena I've updated the description to include that polymorphic note.

[xabier]

Traceability demands that this "follow" be inherited to results and then result monitoring, so that proposals that have been accepted or merged into other results deliver notifications. The same goes for citizen monitoring of results (see issue #586). This is not urgent right now but desirable in the near future.