User Story #938
openEPIC #930: CS Trust Score
Feature #937: Trust Token Management
Frontend User Story – Trust Token Management
0%
Description
As a ConnectSouq member, I want to award my monthly Trust Tokens to members who have genuinely helped me so that I can recognize their contribution and increase their Community Impact score.
Business Background¶
Trust Tokens encourage members to acknowledge valuable contributions within the ConnectSouq community. Every active member receives a fixed number of Trust Tokens each month, which can only be awarded to other members. Members cannot award tokens to themselves, buy additional tokens, or transfer unused tokens between months. Each received Trust Token contributes to the recipient's Community Impact score. These rules are defined in the Trust Framework.
Functional Requirements¶
The member shall be able to:
- View available monthly Trust Tokens.
- Search members.
- View recipient profile summary before sending.
- Send one or more Trust Tokens to another member.
- Add an optional appreciation message.
- View token transaction history.
- View remaining token balance.
- View monthly token usage.
UI Components¶
- Available Token Card
- Remaining Token Counter
- Search Member
- Member List
- Member Profile Preview
- Send Token Button
- Appreciation Message (Optional)
- Confirmation Dialog
- Transaction History Grid
- Monthly Usage Summary
Acceptance Criteria¶
Scenario 1 – Send Trust Token¶
Given
- Member has available Trust Tokens.
When
- Member selects another member and clicks Send Token.
Then
- Trust Token is transferred successfully.
- Remaining balance is updated.
- Recipient's Community Impact score increases.
- Transaction is recorded.
Scenario 2 – Insufficient Tokens¶
Given
- Member has no remaining Trust Tokens.
When
- Member attempts to send another token.
Then
Display:
You have used all your monthly Trust Tokens.
Scenario 3 – Self Award¶
Given
- Member selects their own profile.
When
- Member clicks Send Token.
Then
Display:
You cannot award Trust Tokens to yourself.
Scenario 4 – Monthly Reset¶
Given
A new monthly cycle begins.
Then
The available Trust Token balance is automatically reset according to platform configuration.
Validation Rules¶
- Member must be active.
- Member cannot send tokens to themselves.
- Member cannot exceed the monthly token allocation.
- Tokens cannot be withdrawn after confirmation.
- Recipient must have an active account.
Button Actions¶
| Button | Action |
|---|---|
| Send Token | Transfer selected token(s) |
| Cancel | Close dialog |
| Search | Find members |
| View History | Open transaction history |
| Refresh | Reload balances |
Error Messages¶
| Scenario | Message |
|---|---|
| No tokens remaining | You have used all your monthly Trust Tokens. |
| Self award | You cannot send Trust Tokens to yourself. |
| Member unavailable | Selected member is unavailable. |
| Network issue | Unable to process your request. Please try again. |
In Scope (MVP)¶
- Monthly token balance
- Member search
- Send Trust Token
- Transaction history
- Community Impact update
- Monthly balance reset
- Confirmation message
Out of Scope¶
- Purchasing additional tokens
- Token transfer between members
- Token withdrawal
- Anonymous token awards
- Public comments
- Token gifting campaigns
Dependencies¶
- Authentication
- Member Directory
- Trust Score Engine
- Community Impact Module
- Notification Module
Definition of Done¶
- Token sending interface completed.
- Monthly balance displayed.
- Validation rules implemented.
- Backend integration completed.
- Responsive UI tested.
- Product Owner approval received.
No data to display