Use cases
...
In the second phase, we could add new features so that a user could help the community by marking a Thread is helpful, and by marking a Reply is helpful or unhelpful.
Mockups
Phase 1
Summary View
Paginated Threads
Thread View
...
Removed (Hidden) Replies
New Thread
New Reply
Models
Image RemovedImage Added
API
ActionAction | Intended User | URI | Method | Request Parameters | Request Body | Response Body | Notification Sent to ( |
Phase 2P2) |
1 | Get Forum Metadata for a Project | authorized user | /forum/{projectId} | GET |
| | Update Forum Description | Moderator | /forum/{forumId}/description | PUT | | String | | 2 | Get Threads of a Forum | authorized user | /forum/{forumId}/threads | GET | order, limit, offset |
|
3 | Create a Thread | authorized user | /thread | POST |
|
4 | Get a Thread by its ID | authorized user | /thread/{threadId} | GET |
| |
|
5 | Create a Reply | authorized user | /reply | POST |
|
| CreateReply | Reply | Thread’s Author |
6 | Get a Reply by its ID | authorized user | /reply/{replyId} | GET |
| Flag authorized userModerator | /thread/{threadId} |
/flagPUTFlag | | | Moderator | authorized userModerator | /reply/{replyId} |
/flagPUT | | | Moderator | Pin
|
|
|
|
9 | Get Replies for a Thread |
Moderatorauthorized user | /thread/{threadId}/ |
pinUnpin a Thread | ModeratorPUT | | | | | GET | order, limit, offset |
| PaginatedReplies |
|
10 | Update a Thread’s Message | Author | /thread/{threadId}/ |
unpin Remove a Flag on a Thread | Moderator | /thread/{threadId}/unflag | PUT | | | | |
Remove a Flag on a Reply | Moderator | /reply/{replyId}/unflag | PUT | | | | |
Remove a Reply | Moderator | /reply/{replyId} | DELETE | | | | |
Remove a Thread | Moderator | / | | | 11 | Update a Reply’s Message | Author | /reply/{replyId}/message | PUT |
| String |
|
|
12 | Update a Thread's title | Author | /thread/{threadId}/title | PUT |
| String |
|
|
13 | Restore a deleted thread | Moderator | /thread/{threadId}/restore |
DELETE | | | | Get Replies for a Thread
|
|
|
|
14 | Retrieve a paginated list of moderator for a given forum | authorized user | / |
threadthreadIdrepliesorder, PaginatedReplies Future Potential Extensions
...
...
Search
Notification
Vote (up and down) on responses
Flag a thread/ response as inappropriate
Mark a thread as helpful
Be able to see that there are discussions on a file / table* - DONE
Be able to link to a thread - DONE
- Moderator would be able to close a thread and link to another thread