Brief

To build a basic functioning version of a discussion forum, so we can experience it and understand potential capabilities/limitations of the implementation.

Terms

For the sake of clarity, here are the terms we’ll use:

1. Admin: Administrator of a discussion forum.

2. Moderator: Lesser privileges than admin, and can moderate behaviour in a forum.

3. Member: Lesser privilege than moderator, usually restricted to creating/editing posts.

4. Visitor: Lesser privilege than a member, usually restricted to seeing conversations within a forum but not adding to it.

5. Forum: An area dedicated to interaction between people.

6. Sub-forum: A section within a forum, for organized communication amongst people (E.g. General, Tech, Fun etc.)

7. Discussion: An activity that can be initiated inside a sub-forum or a forum (if there are zero sub-forums).

8. Post: An element for starting a discussion or replying to it.

9. Comment: A time-series trail of responses to any post.

User flow (only for MVP)

1. Go to a specific URL (e.g. https://discussions.sunbird.org/abc123 )

2. Based on user profile:

   1. If not logged in, user is prompted to sign-in.

   2. If logged in, and user is not authenticated to see this forum, a wall saying “Please request authorities for access to this forum.”

   3. If logged in and access is enabled for this profile, user can see the discussion forum.

3. Admin capabilities:

   1. Assign/remove moderator

   2. Delete a discussion, post or comment

   3. + All abilities of moderator + member

4. Moderator capabilities:

   1. Invite/remove user

   2. Archive a discussion, post or comment (equivalent to acting on a flag/report)

   3. + all abilities of member

5. Member capabilities (based on permissions above):

   1. Initiate a discussion

   2. Reply as a post to a discussion

   3. Delete own discussion or post

   4. Upvote/downvote a discussion, post or comment

   5. Sort posts in a discussion by newest / top-voted(default)

   6. Sort discussions by newest / recently updated / top-voted.

NFRs

1. Mobile-responsive view

2. Has to load within 5 seconds.

Potential other capabilities to be handled in later phase

User flow (later phases)

1. Admin > Set permissions for user activity (for moderators and users separately, no outsiders for now):

   1. Create discussion

   2. Delete own post

   3. Comment on post

   4. Upvote/downvote post

   5. Report a post

   6. Mark post as favourite/starred

   7. Archive others' post

   8. Delete others' post

   9. Invite user

   10. Remove user

   11. Create subforum/channel

2. Admin > Set permissions for user activity:

   1. React to post (Like, celebrate, sad, angry etc.)

   2. Mark post to follow/watch it (or unfollow/unwatch it

   3. Silence user (no new posts/comments until further notice)

   4. Silence moderator (no moderator activity until further notice)

3. Moderator > Capabilities:

   1. Flag/report a discussion/post with accompanying reason

   2. Close a discussion (no further discussion or comments within that)

4. User > Capabilities:

   1. If originator of discussion, mark a particular post as pinned (Best answer/takeaway).

   2. Flag/report a discussion/post with accompanying reason.

   3. If originator of discussion, mark it as closed (no further posts or comments).

   4. Edit post (no history needed, just an ‘edited’ text near it)

   5. Keep an eye on discussions they were interacting with / following / starred.

5. Users should be able to follow other users’ activity.

6. Users should be able to search for some text across the forum.