Background

ShareThrift allows users who have been blocked by an admin to submit an appeal request to have their block reviewed. The appeal is a text-based message attached to the user’s block, which admins can view and respond to. This enables blocked users to seek reinstatement and ensures that moderation actions are transparent and reviewable. The process and requirements are documented in the BRD/SRD under "User Standing System" and "Appeal Block."

Task Description

• Enable blocked users to submit an appeal request after being blocked.
• Capture the appeal message and associate it with the user's block for admin review.
• Ensure the appeal request is visible to admins in the dashboard (with context: reason for block, user details, and submitted appeal).
• Notify admins when a new appeal request is received.
• Provide status feedback to users on their appeal (e.g., pending, accepted, rejected).
• Log all appeal submission events for audit and observability (OpenTelemetry/Azure Monitor integration).
• Update system documentation to clarify the user appeal block flow and requirements.

Acceptance Criteria

• Blocked users can submit a text-based appeal request from their user dashboard/profile.
• Each appeal is stored and linked to the specific block record.
• Admins can view appeal requests, review the block, and take action (accept/reject).
• Both users and admins receive notifications about appeal status changes.
• Appeal events are observable in logs and metrics.
• Documentation is updated to reflect the user appeal block workflow.

References

• BRD/SRD: User Standing System – Appeal Block
• ADR: OpenTelemetry, Observability
• Admin Dashboard: Blocked Users and Appeal Requests
• documents/share-thrift-srd-bronze.md
• documents/share-thrift-brd.md