feat(feedback): implement user feedback collection system with email reporting

Backend:
- Add user_feedback table with RLS policy
- Create feedback submission API (multipart/form-data)
- Implement xlsx report generation with embedded images
- Add scheduled email delivery via Feishu SMTP
- Create HTML email templates (daily_report, no_feedback)

Frontend:
- Add feedback screen with type selection and image picker
- Support anonymous submission via skipAuth flag
- Collect device info and app version

Protocol:
- Document feedback API contract and error codes
- Update http-error-codes.md with FEEDBACK_* codes
This commit is contained in:
qzl
2026-04-20 12:49:54 +08:00
parent 913ed26f8d
commit 6a2a9d2c87
46 changed files with 4768 additions and 9 deletions
+19 -1
View File
@@ -487,5 +487,23 @@
"settingsDoNotSellTitle": "Personalized Ads",
"settingsDoNotSellDescription": "When off, your personal info won't be used for ad recommendations",
"settingsDoNotSellEnabled": "Off",
"settingsDoNotSellDisabled": "On"
"settingsDoNotSellDisabled": "On",
"settingsFeedbackTitle": "Feedback",
"feedbackTitle": "Feedback",
"feedbackTypeLabel": "Feedback Type",
"feedbackTypeBug": "Bug",
"feedbackTypeSuggestion": "Suggestion",
"feedbackTypeOther": "Other",
"feedbackContentLabel": "Content",
"feedbackContentHint": "Please describe your issue or suggestion in detail...",
"feedbackImagesLabel": "Add Screenshots (max 3)",
"feedbackAnonymousLabel": "Do not upload my personal information",
"feedbackAnonymousHint": "If checked, your user ID will not be collected. Device info will still be collected for troubleshooting.",
"feedbackSubmit": "Submit Feedback",
"feedbackSubmitting": "Submitting...",
"feedbackSuccess": "Thank you for your feedback. We will process it soon.",
"feedbackContentRequired": "Please enter feedback content",
"feedbackContentTooLong": "Feedback content cannot exceed 500 characters",
"feedbackTooManyImages": "Maximum 3 images allowed",
"feedbackImageTooLarge": "Image size cannot exceed 5MB"
}
+108
View File
@@ -2324,6 +2324,114 @@ abstract class AppLocalizations {
/// In zh, this message translates to:
/// **'已开启'**
String get settingsDoNotSellDisabled;
/// No description provided for @settingsFeedbackTitle.
///
/// In zh, this message translates to:
/// **'意见反馈'**
String get settingsFeedbackTitle;
/// No description provided for @feedbackTitle.
///
/// In zh, this message translates to:
/// **'意见反馈'**
String get feedbackTitle;
/// No description provided for @feedbackTypeLabel.
///
/// In zh, this message translates to:
/// **'反馈类型'**
String get feedbackTypeLabel;
/// No description provided for @feedbackTypeBug.
///
/// In zh, this message translates to:
/// **'问题反馈'**
String get feedbackTypeBug;
/// No description provided for @feedbackTypeSuggestion.
///
/// In zh, this message translates to:
/// **'功能建议'**
String get feedbackTypeSuggestion;
/// No description provided for @feedbackTypeOther.
///
/// In zh, this message translates to:
/// **'其他'**
String get feedbackTypeOther;
/// No description provided for @feedbackContentLabel.
///
/// In zh, this message translates to:
/// **'反馈内容'**
String get feedbackContentLabel;
/// No description provided for @feedbackContentHint.
///
/// In zh, this message translates to:
/// **'请详细描述您的问题或建议...'**
String get feedbackContentHint;
/// No description provided for @feedbackImagesLabel.
///
/// In zh, this message translates to:
/// **'添加截图(最多3张)'**
String get feedbackImagesLabel;
/// No description provided for @feedbackAnonymousLabel.
///
/// In zh, this message translates to:
/// **'不上传我的个人信息'**
String get feedbackAnonymousLabel;
/// No description provided for @feedbackAnonymousHint.
///
/// In zh, this message translates to:
/// **'勾选后将不采集您的用户ID,仅采集设备信息用于问题排查'**
String get feedbackAnonymousHint;
/// No description provided for @feedbackSubmit.
///
/// In zh, this message translates to:
/// **'提交反馈'**
String get feedbackSubmit;
/// No description provided for @feedbackSubmitting.
///
/// In zh, this message translates to:
/// **'提交中...'**
String get feedbackSubmitting;
/// No description provided for @feedbackSuccess.
///
/// In zh, this message translates to:
/// **'感谢您的反馈,我们会尽快处理'**
String get feedbackSuccess;
/// No description provided for @feedbackContentRequired.
///
/// In zh, this message translates to:
/// **'请输入反馈内容'**
String get feedbackContentRequired;
/// No description provided for @feedbackContentTooLong.
///
/// In zh, this message translates to:
/// **'反馈内容不能超过500字'**
String get feedbackContentTooLong;
/// No description provided for @feedbackTooManyImages.
///
/// In zh, this message translates to:
/// **'最多只能上传3张图片'**
String get feedbackTooManyImages;
/// No description provided for @feedbackImageTooLarge.
///
/// In zh, this message translates to:
/// **'图片大小不能超过5MB'**
String get feedbackImageTooLarge;
}
class _AppLocalizationsDelegate
+58
View File
@@ -1224,4 +1224,62 @@ class AppLocalizationsEn extends AppLocalizations {
@override
String get settingsDoNotSellDisabled => 'On';
@override
String get settingsFeedbackTitle => 'Feedback';
@override
String get feedbackTitle => 'Feedback';
@override
String get feedbackTypeLabel => 'Feedback Type';
@override
String get feedbackTypeBug => 'Bug';
@override
String get feedbackTypeSuggestion => 'Suggestion';
@override
String get feedbackTypeOther => 'Other';
@override
String get feedbackContentLabel => 'Content';
@override
String get feedbackContentHint =>
'Please describe your issue or suggestion in detail...';
@override
String get feedbackImagesLabel => 'Add Screenshots (max 3)';
@override
String get feedbackAnonymousLabel => 'Do not upload my personal information';
@override
String get feedbackAnonymousHint =>
'If checked, your user ID will not be collected. Device info will still be collected for troubleshooting.';
@override
String get feedbackSubmit => 'Submit Feedback';
@override
String get feedbackSubmitting => 'Submitting...';
@override
String get feedbackSuccess =>
'Thank you for your feedback. We will process it soon.';
@override
String get feedbackContentRequired => 'Please enter feedback content';
@override
String get feedbackContentTooLong =>
'Feedback content cannot exceed 500 characters';
@override
String get feedbackTooManyImages => 'Maximum 3 images allowed';
@override
String get feedbackImageTooLarge => 'Image size cannot exceed 5MB';
}
+108
View File
@@ -1171,6 +1171,60 @@ class AppLocalizationsZh extends AppLocalizations {
@override
String get settingsDoNotSellDisabled => '已开启';
@override
String get settingsFeedbackTitle => '意见反馈';
@override
String get feedbackTitle => '意见反馈';
@override
String get feedbackTypeLabel => '反馈类型';
@override
String get feedbackTypeBug => '问题反馈';
@override
String get feedbackTypeSuggestion => '功能建议';
@override
String get feedbackTypeOther => '其他';
@override
String get feedbackContentLabel => '反馈内容';
@override
String get feedbackContentHint => '请详细描述您的问题或建议...';
@override
String get feedbackImagesLabel => '添加截图(最多3张)';
@override
String get feedbackAnonymousLabel => '不上传我的个人信息';
@override
String get feedbackAnonymousHint => '勾选后将不采集您的用户ID,仅采集设备信息用于问题排查';
@override
String get feedbackSubmit => '提交反馈';
@override
String get feedbackSubmitting => '提交中...';
@override
String get feedbackSuccess => '感谢您的反馈,我们会尽快处理';
@override
String get feedbackContentRequired => '请输入反馈内容';
@override
String get feedbackContentTooLong => '反馈内容不能超过500字';
@override
String get feedbackTooManyImages => '最多只能上传3张图片';
@override
String get feedbackImageTooLarge => '图片大小不能超过5MB';
}
/// The translations for Chinese, using the Han script (`zh_Hant`).
@@ -2096,4 +2150,58 @@ class AppLocalizationsZhHant extends AppLocalizationsZh {
@override
String get settingsDoNotSellDisabled => '已開啟';
@override
String get settingsFeedbackTitle => '意見回饋';
@override
String get feedbackTitle => '意見回饋';
@override
String get feedbackTypeLabel => '回饋類型';
@override
String get feedbackTypeBug => '問題回饋';
@override
String get feedbackTypeSuggestion => '功能建議';
@override
String get feedbackTypeOther => '其他';
@override
String get feedbackContentLabel => '回饋內容';
@override
String get feedbackContentHint => '請詳細描述您的問題或建議...';
@override
String get feedbackImagesLabel => '添加截圖(最多3張)';
@override
String get feedbackAnonymousLabel => '不上傳我的個人信息';
@override
String get feedbackAnonymousHint => '勾選後將不採集您的用戶ID,僅採集設備信息用於問題排查';
@override
String get feedbackSubmit => '提交回饋';
@override
String get feedbackSubmitting => '提交中...';
@override
String get feedbackSuccess => '感謝您的回饋,我們會盡快處理';
@override
String get feedbackContentRequired => '請輸入回饋內容';
@override
String get feedbackContentTooLong => '回饋內容不能超過500字';
@override
String get feedbackTooManyImages => '最多只能上傳3張圖片';
@override
String get feedbackImageTooLarge => '圖片大小不能超過5MB';
}
+19 -1
View File
@@ -487,5 +487,23 @@
"settingsDoNotSellTitle": "个性化广告推荐",
"settingsDoNotSellDescription": "关闭后,我们不会将您的个人信息用于广告推荐",
"settingsDoNotSellEnabled": "已关闭",
"settingsDoNotSellDisabled": "已开启"
"settingsDoNotSellDisabled": "已开启",
"settingsFeedbackTitle": "意见反馈",
"feedbackTitle": "意见反馈",
"feedbackTypeLabel": "反馈类型",
"feedbackTypeBug": "问题反馈",
"feedbackTypeSuggestion": "功能建议",
"feedbackTypeOther": "其他",
"feedbackContentLabel": "反馈内容",
"feedbackContentHint": "请详细描述您的问题或建议...",
"feedbackImagesLabel": "添加截图(最多3张)",
"feedbackAnonymousLabel": "不上传我的个人信息",
"feedbackAnonymousHint": "勾选后将不采集您的用户ID,仅采集设备信息用于问题排查",
"feedbackSubmit": "提交反馈",
"feedbackSubmitting": "提交中...",
"feedbackSuccess": "感谢您的反馈,我们会尽快处理",
"feedbackContentRequired": "请输入反馈内容",
"feedbackContentTooLong": "反馈内容不能超过500字",
"feedbackTooManyImages": "最多只能上传3张图片",
"feedbackImageTooLarge": "图片大小不能超过5MB"
}
+19 -1
View File
@@ -389,5 +389,23 @@
"settingsDoNotSellTitle": "個人化廣告推薦",
"settingsDoNotSellDescription": "關閉後,我們不會將您的個人資訊用於廣告推薦",
"settingsDoNotSellEnabled": "已關閉",
"settingsDoNotSellDisabled": "已開啟"
"settingsDoNotSellDisabled": "已開啟",
"settingsFeedbackTitle": "意見回饋",
"feedbackTitle": "意見回饋",
"feedbackTypeLabel": "回饋類型",
"feedbackTypeBug": "問題回饋",
"feedbackTypeSuggestion": "功能建議",
"feedbackTypeOther": "其他",
"feedbackContentLabel": "回饋內容",
"feedbackContentHint": "請詳細描述您的問題或建議...",
"feedbackImagesLabel": "添加截圖(最多3張)",
"feedbackAnonymousLabel": "不上傳我的個人信息",
"feedbackAnonymousHint": "勾選後將不採集您的用戶ID,僅採集設備信息用於問題排查",
"feedbackSubmit": "提交回饋",
"feedbackSubmitting": "提交中...",
"feedbackSuccess": "感謝您的回饋,我們會盡快處理",
"feedbackContentRequired": "請輸入回饋內容",
"feedbackContentTooLong": "回饋內容不能超過500字",
"feedbackTooManyImages": "最多只能上傳3張圖片",
"feedbackImageTooLarge": "圖片大小不能超過5MB"
}