Gurbani Translation Feedback Collection

[prebhdevsingh]

Title

As a user of SikhiToTheMax, I want to provide feedback on Gurbani translations so that translation sevadars can improve accuracy, clarity, and spelling.

✅ Acceptance Criteria

1. Feedback Scope Options

• Users can submit feedback on:
  • Entire Ang
  • Specific Shabad
  • Individual Panktee
  • Single Word
  • General translation feedback
• Users can report spelling mistakes in Gurbani text.

2. Metadata Capture

• When feedback is submitted, the system captures:
  • Search query used by the user
  • Highlighted artifact (e.g., the panktee) at the time of submission
  • User settings (e.g., enabled translations, language, etc.)
  • Specific translation selected or viewed
  • Timestamp and user ID (if logged in)

3. Feedback Storage

• Feedback is stored in a structured database with:
  • Feedback type and content
  • Associated metadata
  • Review status (e.g., pending, resolved)
• Feedback entries are retrievable for review and analysis.

4. Metrics Dashboard

• Admins can view metrics such as:
  • Total number of feedback submissions
  • Breakdown by feedback type (Ang, Shabad, etc.)
  • Submission trends over time
  • Most flagged translations or spelling issues

5. User Confirmation

• After submission, users receive a confirmation message:

  “Thank you! Your feedback has been received and will be reviewed by our translation sevadars.”

---

🔒 Privacy & Consent

• Users can submit feedback anonymously.
• A consent notice informs users that metadata will be collected and stored.

---

🧠 Feedback Categorization & Prioritization

• Users can tag feedback as:
  • “Translation issue”
  • “Spelling mistake”
  • “Suggestion”
  • “General comment”
• Allow users to enter free form comments
• Allow users to upload attachments (images / pdf)

---

🧑‍💻 Admin & Sevadar Tools

• Admin dashboard includes:
  • Filters by feedback type, ang, shabad, etc.
  • Status tracking (reviewed, resolved, escalated)
  • Internal notes and responses
  • Bulk actions and export options

---

🌐 User Experience Enhancements

• Inline feedback buttons next to each ang, shabad, panktee, and word.
• Auto-fill context when feedback is initiated.
• Multilingual support (Punjabi and English - later phase)

---

🔁 Feedback Loop (later phase)

• Optionally notify users when feedback is reviewed or acted upon.
• Highlight contributors whose feedback led to improvements.

---

🧪 Test Scenarios

• ✅ User submits feedback on a panktee and sees confirmation.
• ✅ System logs the search term and translation settings used.
• ✅ Admin dashboard shows 50 feedback entries this week.
• ✅ User reports a spelling mistake in a word and it’s stored with metadata.
• ✅ Feedback on general translation is stored without a specific Gurbani reference.