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:
Admin: Administrator of a discussion forum.
Moderator: Lesser privileges than admin, and can moderate behaviour in a forum.
Member: Lesser privilege than moderator, usually restricted to creating/editing posts.
Visitor: Lesser privilege than a member, usually restricted to seeing conversations within a forum but not adding to it.
Forum: An area dedicated to interaction between people.
Sub-forum: A section within a forum, for organized communication amongst people (E.g. General, Tech, Fun etc.)
Discussion: An activity that can be initiated inside a sub-forum or a forum (if there are zero sub-forums).
Post: An element for starting a discussion or replying to it.
Comment: A time-series trail of responses to any post.
User flow (only for MVP)
Go to a specific URL (e.g. https://www.sunbird.org/discussions/abc123 ). Each URL is a separate forum space, therefore membership to one URL is not sufficient to see all other forums from other URLs.
Based on user profile:
If not logged in, user is prompted to sign-in.
If logged in, and user is not authenticated to see this forum, a wall saying “Please request authorities for access to this forum”. There should also be a button that user can tap to ‘request access’.
If logged in and access is enabled for this profile, user can see the discussion forum. Otherwise, user should not be able to see the discussion forum.
Admin capabilities:
Assign/remove moderator
Delete a discussion, post or comment
+ All abilities of moderator + member
Moderator capabilities:
Invite/remove user
See a list of users who are awaiting approval to join forum
There should be an option to accept all or reject all.
There should be the list of individual users, with the options to accept or reject. Each user should be accompanied with whether this is a verified state user, which state and block they belong to (and which school they belong to).
Archive a discussion, post or comment (equivalent to acting on a flag/report)
See list of reported posts:
Options should be available to ‘hide <discussion/post/comment>' or ‘allow’.
Block / ban users [akin to not allowing membership, posts, comments or votes]
+ all abilities of member
Member capabilities (based on permissions above):
Initiate a discussion
Initiate a discussion anonymously (if so, the role and district of the user should be visible, e.g. Teacher, Guntur district).
Reply as a post to a discussion
Delete own discussion or post
Upvote/downvote a discussion, post or comment
Sort posts in a discussion by newest / top-voted(default)
Sort discussions by newest / recently updated / top-voted.
User interface:
Allow sorting (globally across categories) based on popular (default) / new. On opening a particular category, the user can see sort options here also - popular (default) / new.
Each category should be opened up for limited viewing (Upto 5 posts), with a view more button below.
Order of categories should be customizable by the admin.
Telemetry
https://docs.google.com/spreadsheets/d/1dbKeKp9Pw9O3VoumPK4cJIooAZZy_mCqa-ashMcbuEY/edit#gid=0
NFRs
Mobile-responsive view
Has to load within 5 seconds.
Potential other capabilities to be handled in later phase
User flow (later phases)
Admin > Set permissions for user activity (for moderators and users separately, no outsiders for now):
Create discussion
Delete own post
Comment on post
Upvote/downvote post
Report a post
Mark post as favourite/starred
Archive others' post
Delete others' post
Invite user
Remove user
Create subforum/channel
Admin > Set permissions for user activity:
React to post (Like, celebrate, sad, angry etc.)
Mark post to follow/watch it (or unfollow/unwatch it
Silence user (no new posts/comments until further notice)
Silence moderator (no moderator activity until further notice)
Moderator > Capabilities:
Flag/report a discussion/post with accompanying reason
Close a discussion (no further discussion or comments within that)
Bulk upload a list of users to be added into the group.
User > Capabilities:
If originator of discussion, mark a particular post as pinned (Best answer/takeaway).
Flag/report a discussion/post with accompanying reason.
If originator of discussion, mark it as closed (no further posts or comments).
Edit post (no history needed, just an ‘edited’ text near it)
Keep an eye on discussions they were interacting with / following / starred.
Users should be able to follow other users’ activity.
Users should be able to search for some text across the forum.