testimonials 0.1.0

data/config/locales/testimonials.tr.yml

@@ -0,0 +1,101 @@
+tr:
+  testimonials:
+    questions:
+      - "Kimsiniz ve %{app} uygulamasını nasıl kullanıyorsunuz?"
+      - "%{app} size nasıl yardımcı oldu?"
+      - "%{app} uygulamasının en iyi yanı nedir?"
+    consent: "Bu yorumun sosyal medyada ve diğer pazarlama çalışmalarında kullanılmasına izin veriyorum."
+    cta: "Yorum bırak"
+    update_title: "Yorumunuzu güncelleyin"
+    enjoying: "%{app} hoşunuza gidiyor mu?"
+    not_now: "Şimdi değil"
+    rate_aria: "5 üzerinden %{count} puan ver"
+    share_title: "Deneyiminizi paylaşın"
+    promoter_title: "Bunu duymak güzel! Herkese açık söylemek ister misiniz?"
+    questions_title: "Sorular"
+    message: "Görüşünüz"
+    message_placeholder: "Bir arkadaşınıza %{app} hakkında ne söylerdiniz?"
+    record_video: "Video kaydet"
+    record_video_hint: "Kısa bir video, bir sayfa metinden fazlasını anlatır."
+    name: "Adınız"
+    email: "E-postanız"
+    title_company: "Unvan, şirket"
+    photo: "Fotoğrafınız"
+    optional: "isteğe bağlı"
+    submit: "Gönder"
+    cancel: "İptal"
+    close: "Kapat"
+    thanks: "Çok teşekkürler!"
+    video_check_title: "Kamera kontrolü"
+    video_hint: "En fazla %{seconds} saniye. Göndermeden önce izleyebilirsiniz."
+    start_recording: "Kaydı başlat"
+    stop_recording: "Bitir"
+    record_again: "Yeniden kaydet"
+    use_video: "Bu videoyu kullan"
+    upload_instead: "Bunun yerine video dosyası yükle"
+    video_attached: "Video eklendi"
+    remove: "Kaldır"
+    nps_question: "%{app} uygulamasını bir arkadaşınıza veya meslektaşınıza önerme olasılığınız nedir?"
+    nps_low: "Hiç olası değil"
+    nps_high: "Son derece olası"
+    nps_comment_label: "Puanınızın ana nedeni nedir?"
+    error_blank: "Lütfen bir şeyler yazın veya video kaydedin."
+    error_contact: "Lütfen adınızı ve e-postanızı girin."
+    error_save: "Gönderilemedi. Lütfen tekrar deneyin."
+    error_video_too_large: "Video çok büyük (en fazla %{size} MB)."
+    error_camera: "Kameraya erişilemedi. Bunun yerine bir video dosyası yükleyebilirsiniz."
+    error_rate_limited: "Çok fazla gönderim. Lütfen biraz bekleyip tekrar deneyin."
+    page:
+      title: "%{app} deneyiminizi paylaşın"
+      subtitle: "Sözleriniz başkalarının karar vermesine yardımcı olur — teşekkürler!"
+    kinds:
+      text: "Metin"
+      video: "Video"
+    sources:
+      widget: "Uygulama içi bileşen"
+      page: "Toplama sayfası"
+      nps: "NPS takibi"
+      collection_page: "Görüş isteyin"
+      download_video: "Videoyu indir"
+    statuses:
+      pending: "Beklemede"
+      approved: "Onaylandı"
+      archived: "Arşivlendi"
+    dashboard:
+      title: "Görüşler"
+      nps: "NPS"
+      all_kinds: "Tüm türler"
+      search: "Ara"
+      search_placeholder: "Metin, ad, e-posta ara…"
+      rating: "Puan"
+      testimonial: "Görüş"
+      from: "Kimden"
+      consent: "Onay"
+      no_consent: "Yayın onayı yok. API üzerinden sunulmaz."
+      received: "Alındı"
+      featured: "Öne çıkan"
+      approve: "Onayla"
+      feature: "Öne çıkar"
+      unfeature: "Öne çıkarmayı kaldır"
+      best_line: "En iyi cümle"
+      best_line_hint: "Sitenizde gösterilecek alıntı. Tam metni kullanmak için boş bırakın. Videolarda söylenen en iyi cümleyi yazın."
+      save_best_line: "Kaydet"
+      email: "E-posta"
+      source: "Kaynak"
+      page: "Sayfa"
+      locale: "Dil"
+      browser: "Tarayıcı"
+      empty: "Henüz burada bir şey yok."
+      newer: "← Daha yeni"
+      older: "Daha eski →"
+      move_to_pending: "Beklemeye al"
+      move_to_approved: "Onayla"
+      move_to_archived: "Arşivle"
+      delete: "Sil"
+      delete_confirm: "Bu görüş silinsin mi?"
+      nps_score: "NPS puanı"
+      promoters: "Destekleyenler (9–10)"
+      passives: "Pasifler (7–8)"
+      detractors: "Eleştirenler (0–6)"
+      score: "Puan"
+      comment: "Yorum"

data/config/locales/testimonials.uk.yml

@@ -0,0 +1,101 @@
+uk:
+  testimonials:
+    questions:
+      - "Хто ви і як ви використовуєте %{app}?"
+      - "Як %{app} вам допоміг?"
+      - "Що найкраще в %{app}?"
+    consent: "Я дозволяю використовувати цей відгук у соцмережах та інших маркетингових матеріалах."
+    cta: "Залишити відгук"
+    update_title: "Оновити ваш відгук"
+    enjoying: "Подобається %{app}?"
+    not_now: "Не зараз"
+    rate_aria: "Оцінити на %{count} з 5"
+    share_title: "Поділіться своїм досвідом"
+    promoter_title: "Приємно чути! Розкажете про це публічно?"
+    questions_title: "Питання"
+    message: "Ваш відгук"
+    message_placeholder: "Що б ви розповіли другові про %{app}?"
+    record_video: "Записати відео"
+    record_video_hint: "Коротке відео скаже більше, ніж сторінка тексту."
+    name: "Ваше ім'я"
+    email: "Ваша електронна пошта"
+    title_company: "Посада, компанія"
+    photo: "Ваше фото"
+    optional: "необов'язково"
+    submit: "Надіслати"
+    cancel: "Скасувати"
+    close: "Закрити"
+    thanks: "Щиро дякуємо!"
+    video_check_title: "Перевірка камери"
+    video_hint: "До %{seconds} секунд. Ви зможете переглянути перед надсиланням."
+    start_recording: "Почати запис"
+    stop_recording: "Завершити"
+    record_again: "Записати ще раз"
+    use_video: "Використати це відео"
+    upload_instead: "Натомість завантажити відеофайл"
+    video_attached: "Відео додано"
+    remove: "Прибрати"
+    nps_question: "Наскільки ймовірно, що ви порекомендуєте %{app} другові чи колезі?"
+    nps_low: "Зовсім неймовірно"
+    nps_high: "Дуже ймовірно"
+    nps_comment_label: "Яка головна причина вашої оцінки?"
+    error_blank: "Напишіть щось або запишіть відео."
+    error_contact: "Вкажіть ваше ім'я та електронну пошту."
+    error_save: "Не вдалося надіслати. Спробуйте ще раз."
+    error_video_too_large: "Відео завелике (макс. %{size} МБ)."
+    error_camera: "Немає доступу до камери. Можете натомість завантажити відеофайл."
+    error_rate_limited: "Забагато надсилань. Зачекайте хвилинку і спробуйте знову."
+    page:
+      title: "Поділіться своїм досвідом із %{app}"
+      subtitle: "Ваші слова допомагають іншим зважитися — дякуємо!"
+    kinds:
+      text: "Текст"
+      video: "Відео"
+    sources:
+      widget: "Віджет у застосунку"
+      page: "Сторінка збору"
+      nps: "Після NPS"
+      collection_page: "Попросити відгуки"
+      download_video: "Завантажити відео"
+    statuses:
+      pending: "Очікує"
+      approved: "Схвалено"
+      archived: "В архіві"
+    dashboard:
+      title: "Відгуки"
+      nps: "NPS"
+      all_kinds: "Усі типи"
+      search: "Пошук"
+      search_placeholder: "Шукати текст, ім'я, пошту…"
+      rating: "Оцінка"
+      testimonial: "Відгук"
+      from: "Від"
+      consent: "Згода"
+      no_consent: "Немає згоди на публікацію. Не віддається через API."
+      received: "Отримано"
+      featured: "Обране"
+      approve: "Схвалити"
+      feature: "В обране"
+      unfeature: "Прибрати з обраного"
+      best_line: "Найкраща фраза"
+      best_line_hint: "Цитата, яку показуватиме ваш сайт. Залиште порожнім, щоб використати повний текст. Для відео впишіть найкращу сказану фразу."
+      save_best_line: "Зберегти"
+      email: "Пошта"
+      source: "Джерело"
+      page: "Сторінка"
+      locale: "Мова"
+      browser: "Браузер"
+      empty: "Поки що тут нічого немає."
+      newer: "← Новіші"
+      older: "Старіші →"
+      move_to_pending: "Позначити як очікує"
+      move_to_approved: "Схвалити"
+      move_to_archived: "В архів"
+      delete: "Видалити"
+      delete_confirm: "Видалити цей відгук?"
+      nps_score: "Показник NPS"
+      promoters: "Промоутери (9–10)"
+      passives: "Нейтральні (7–8)"
+      detractors: "Критики (0–6)"
+      score: "Оцінка"
+      comment: "Коментар"

data/config/locales/testimonials.ur.yml

@@ -0,0 +1,101 @@
+ur:
+  testimonials:
+    questions:
+      - "آپ کون ہیں اور %{app} کیسے استعمال کرتے ہیں؟"
+      - "%{app} نے آپ کی کیسے مدد کی؟"
+      - "%{app} کی سب سے اچھی بات کیا ہے؟"
+    consent: "میں اس تعریفی کلمات کو سوشل میڈیا اور دیگر مارکیٹنگ سرگرمیوں میں استعمال کرنے کی اجازت دیتا/دیتی ہوں۔"
+    cta: "تبصرہ چھوڑیں"
+    update_title: "اپنا تبصرہ اپ ڈیٹ کریں"
+    enjoying: "%{app} پسند آ رہا ہے؟"
+    not_now: "ابھی نہیں"
+    rate_aria: "5 میں سے %{count} دیں"
+    share_title: "اپنا تجربہ شیئر کریں"
+    promoter_title: "سن کر خوشی ہوئی! کیا آپ یہ عوامی طور پر کہنا چاہیں گے؟"
+    questions_title: "سوالات"
+    message: "آپ کی رائے"
+    message_placeholder: "آپ کسی دوست کو %{app} کے بارے میں کیا بتائیں گے؟"
+    record_video: "ویڈیو ریکارڈ کریں"
+    record_video_hint: "ایک مختصر ویڈیو ایک صفحہ تحریر سے زیادہ کہتی ہے۔"
+    name: "آپ کا نام"
+    email: "آپ کا ای میل"
+    title_company: "عہدہ، کمپنی"
+    photo: "آپ کی تصویر"
+    optional: "اختیاری"
+    submit: "بھیجیں"
+    cancel: "منسوخ"
+    close: "بند کریں"
+    thanks: "بہت شکریہ!"
+    video_check_title: "کیمرے کی جانچ"
+    video_hint: "زیادہ سے زیادہ %{seconds} سیکنڈ۔ بھیجنے سے پہلے دیکھ سکتے ہیں۔"
+    start_recording: "ریکارڈنگ شروع کریں"
+    stop_recording: "مکمل کریں"
+    record_again: "دوبارہ ریکارڈ کریں"
+    use_video: "یہ ویڈیو استعمال کریں"
+    upload_instead: "اس کے بجائے ویڈیو فائل اپ لوڈ کریں"
+    video_attached: "ویڈیو منسلک ہے"
+    remove: "ہٹائیں"
+    nps_question: "کتنا امکان ہے کہ آپ %{app} کسی دوست یا ساتھی کو تجویز کریں؟"
+    nps_low: "بالکل امکان نہیں"
+    nps_high: "انتہائی امکان ہے"
+    nps_comment_label: "آپ کے اسکور کی بنیادی وجہ کیا ہے؟"
+    error_blank: "براہ کرم کچھ لکھیں یا ویڈیو ریکارڈ کریں۔"
+    error_contact: "براہ کرم اپنا نام اور ای میل درج کریں۔"
+    error_save: "بھیجا نہیں جا سکا۔ دوبارہ کوشش کریں۔"
+    error_video_too_large: "ویڈیو بہت بڑی ہے (زیادہ سے زیادہ %{size} MB)۔"
+    error_camera: "کیمرے تک رسائی نہیں ہو سکی۔ آپ اس کے بجائے ویڈیو فائل اپ لوڈ کر سکتے ہیں۔"
+    error_rate_limited: "بہت زیادہ اندراجات۔ تھوڑا انتظار کر کے دوبارہ کوشش کریں۔"
+    page:
+      title: "%{app} کے ساتھ اپنا تجربہ شیئر کریں"
+      subtitle: "آپ کے الفاظ دوسروں کو فیصلہ کرنے میں مدد دیتے ہیں — شکریہ!"
+    kinds:
+      text: "متن"
+      video: "ویڈیو"
+    sources:
+      widget: "ایپ کے اندر ویجیٹ"
+      page: "جمع کرنے کا صفحہ"
+      nps: "NPS فالو اپ"
+      collection_page: "تعریفی کلمات طلب کریں"
+      download_video: "ویڈیو ڈاؤن لوڈ کریں"
+    statuses:
+      pending: "زیر التوا"
+      approved: "منظور شدہ"
+      archived: "محفوظ شدہ"
+    dashboard:
+      title: "تعریفی کلمات"
+      nps: "NPS"
+      all_kinds: "تمام اقسام"
+      search: "تلاش"
+      search_placeholder: "متن، نام، ای میل تلاش کریں…"
+      rating: "درجہ بندی"
+      testimonial: "تعریفی کلمات"
+      from: "منجانب"
+      consent: "رضامندی"
+      no_consent: "اشاعت کی رضامندی نہیں۔ API سے فراہم نہیں کیا جاتا۔"
+      received: "موصول ہوا"
+      featured: "نمایاں"
+      approve: "منظور کریں"
+      feature: "نمایاں کریں"
+      unfeature: "نمایاں سے ہٹائیں"
+      best_line: "بہترین جملہ"
+      best_line_hint: "وہ اقتباس جو آپ کی سائٹ دکھائے گی۔ پورا متن استعمال کرنے کے لیے خالی چھوڑیں۔ ویڈیو کے لیے ان کا کہا بہترین جملہ لکھیں۔"
+      save_best_line: "محفوظ کریں"
+      email: "ای میل"
+      source: "ماخذ"
+      page: "صفحہ"
+      locale: "زبان"
+      browser: "براؤزر"
+      empty: "یہاں ابھی کچھ نہیں ہے۔"
+      newer: "→ نئے"
+      older: "پرانے ←"
+      move_to_pending: "زیر التوا نشان زد کریں"
+      move_to_approved: "منظور کریں"
+      move_to_archived: "محفوظ کریں"
+      delete: "حذف کریں"
+      delete_confirm: "یہ تعریفی کلمات حذف کریں؟"
+      nps_score: "NPS اسکور"
+      promoters: "حامی (9–10)"
+      passives: "غیر جانبدار (7–8)"
+      detractors: "ناقدین (0–6)"
+      score: "اسکور"
+      comment: "تبصرہ"

data/config/locales/testimonials.vi.yml

@@ -0,0 +1,101 @@
+vi:
+  testimonials:
+    questions:
+      - "Bạn là ai và bạn dùng %{app} như thế nào?"
+      - "%{app} đã giúp bạn ra sao?"
+      - "Điều tuyệt nhất ở %{app} là gì?"
+    consent: "Tôi cho phép sử dụng cảm nhận này trên mạng xã hội và các hoạt động tiếp thị khác."
+    cta: "Để lại đánh giá"
+    update_title: "Cập nhật đánh giá của bạn"
+    enjoying: "Bạn thích %{app} chứ?"
+    not_now: "Để sau"
+    rate_aria: "Chấm %{count} trên 5"
+    share_title: "Chia sẻ trải nghiệm của bạn"
+    promoter_title: "Thật vui khi nghe điều đó! Bạn có muốn nói công khai không?"
+    questions_title: "Câu hỏi"
+    message: "Cảm nhận của bạn"
+    message_placeholder: "Bạn sẽ nói gì với một người bạn về %{app}?"
+    record_video: "Quay video"
+    record_video_hint: "Một video ngắn nói lên nhiều hơn một trang chữ."
+    name: "Tên của bạn"
+    email: "Email của bạn"
+    title_company: "Chức danh, công ty"
+    photo: "Ảnh của bạn"
+    optional: "không bắt buộc"
+    submit: "Gửi"
+    cancel: "Hủy"
+    close: "Đóng"
+    thanks: "Cảm ơn bạn rất nhiều!"
+    video_check_title: "Kiểm tra camera"
+    video_hint: "Tối đa %{seconds} giây. Bạn có thể xem lại trước khi gửi."
+    start_recording: "Bắt đầu quay"
+    stop_recording: "Hoàn tất"
+    record_again: "Quay lại"
+    use_video: "Dùng video này"
+    upload_instead: "Tải lên tệp video thay thế"
+    video_attached: "Đã đính kèm video"
+    remove: "Gỡ bỏ"
+    nps_question: "Khả năng bạn giới thiệu %{app} cho bạn bè hoặc đồng nghiệp là bao nhiêu?"
+    nps_low: "Hoàn toàn không"
+    nps_high: "Rất có thể"
+    nps_comment_label: "Lý do chính cho điểm số của bạn là gì?"
+    error_blank: "Vui lòng viết gì đó hoặc quay video."
+    error_contact: "Vui lòng nhập tên và email của bạn."
+    error_save: "Không gửi được. Vui lòng thử lại."
+    error_video_too_large: "Video quá lớn (tối đa %{size} MB)."
+    error_camera: "Không truy cập được camera. Bạn có thể tải lên tệp video thay thế."
+    error_rate_limited: "Gửi quá nhiều lần. Vui lòng đợi một chút rồi thử lại."
+    page:
+      title: "Chia sẻ trải nghiệm của bạn với %{app}"
+      subtitle: "Lời của bạn giúp người khác quyết định — cảm ơn bạn!"
+    kinds:
+      text: "Văn bản"
+      video: "Video"
+    sources:
+      widget: "Widget trong ứng dụng"
+      page: "Trang thu thập"
+      nps: "Tiếp nối NPS"
+      collection_page: "Xin cảm nhận"
+      download_video: "Tải video xuống"
+    statuses:
+      pending: "Đang chờ"
+      approved: "Đã duyệt"
+      archived: "Đã lưu trữ"
+    dashboard:
+      title: "Cảm nhận khách hàng"
+      nps: "NPS"
+      all_kinds: "Tất cả các loại"
+      search: "Tìm kiếm"
+      search_placeholder: "Tìm văn bản, tên, email…"
+      rating: "Đánh giá"
+      testimonial: "Cảm nhận"
+      from: "Từ"
+      consent: "Sự đồng ý"
+      no_consent: "Chưa đồng ý công bố. Không được cung cấp qua API."
+      received: "Đã nhận"
+      featured: "Nổi bật"
+      approve: "Duyệt"
+      feature: "Đặt nổi bật"
+      unfeature: "Bỏ nổi bật"
+      best_line: "Câu hay nhất"
+      best_line_hint: "Trích dẫn mà trang của bạn sẽ hiển thị. Để trống để dùng toàn văn. Với video, hãy gõ câu hay nhất họ đã nói."
+      save_best_line: "Lưu"
+      email: "Email"
+      source: "Nguồn"
+      page: "Trang"
+      locale: "Ngôn ngữ"
+      browser: "Trình duyệt"
+      empty: "Chưa có gì ở đây."
+      newer: "← Mới hơn"
+      older: "Cũ hơn →"
+      move_to_pending: "Đánh dấu đang chờ"
+      move_to_approved: "Duyệt"
+      move_to_archived: "Lưu trữ"
+      delete: "Xóa"
+      delete_confirm: "Xóa cảm nhận này?"
+      nps_score: "Điểm NPS"
+      promoters: "Người ủng hộ (9–10)"
+      passives: "Trung lập (7–8)"
+      detractors: "Người phản đối (0–6)"
+      score: "Điểm"
+      comment: "Bình luận"

data/config/locales/testimonials.zh-CN.yml

@@ -0,0 +1,101 @@
+zh-CN:
+  testimonials:
+    questions:
+      - "您是谁？您如何使用 %{app}？"
+      - "%{app} 是如何帮助您的？"
+      - "%{app} 最棒的地方是什么？"
+    consent: "我允许在社交媒体和其他营销活动中使用这条评价。"
+    cta: "写评价"
+    update_title: "更新您的评价"
+    enjoying: "喜欢 %{app} 吗？"
+    not_now: "暂不"
+    rate_aria: "评 %{count} 分（满分 5 分）"
+    share_title: "分享您的体验"
+    promoter_title: "很高兴听到！愿意公开说说吗？"
+    questions_title: "问题"
+    message: "您的评价"
+    message_placeholder: "您会如何向朋友介绍 %{app}？"
+    record_video: "录制视频"
+    record_video_hint: "一段简短的视频胜过一页文字。"
+    name: "您的姓名"
+    email: "您的邮箱"
+    title_company: "职位、公司"
+    photo: "您的照片"
+    optional: "可选"
+    submit: "发送"
+    cancel: "取消"
+    close: "关闭"
+    thanks: "非常感谢！"
+    video_check_title: "摄像头检查"
+    video_hint: "最长 %{seconds} 秒。发送前可以先查看。"
+    start_recording: "开始录制"
+    stop_recording: "完成"
+    record_again: "重新录制"
+    use_video: "使用此视频"
+    upload_instead: "改为上传视频文件"
+    video_attached: "已附加视频"
+    remove: "移除"
+    nps_question: "您向朋友或同事推荐 %{app} 的可能性有多大？"
+    nps_low: "完全不可能"
+    nps_high: "非常可能"
+    nps_comment_label: "您打这个分数的主要原因是什么？"
+    error_blank: "请写点什么或录制一段视频。"
+    error_contact: "请输入您的姓名和邮箱。"
+    error_save: "发送失败，请重试。"
+    error_video_too_large: "视频太大（最大 %{size} MB）。"
+    error_camera: "无法访问摄像头。您可以改为上传视频文件。"
+    error_rate_limited: "提交过于频繁，请稍候再试。"
+    page:
+      title: "分享您使用 %{app} 的体验"
+      subtitle: "您的评价能帮助他人做出选择——谢谢！"
+    kinds:
+      text: "文字"
+      video: "视频"
+    sources:
+      widget: "应用内组件"
+      page: "收集页面"
+      nps: "NPS 跟进"
+      collection_page: "征集用户评价"
+      download_video: "下载视频"
+    statuses:
+      pending: "待处理"
+      approved: "已批准"
+      archived: "已归档"
+    dashboard:
+      title: "用户评价"
+      nps: "NPS"
+      all_kinds: "所有类型"
+      search: "搜索"
+      search_placeholder: "搜索文字、姓名、邮箱…"
+      rating: "评分"
+      testimonial: "评价"
+      from: "来自"
+      consent: "授权"
+      no_consent: "未授权发布。API 不会提供此条。"
+      received: "收到时间"
+      featured: "精选"
+      approve: "批准"
+      feature: "设为精选"
+      unfeature: "取消精选"
+      best_line: "最佳金句"
+      best_line_hint: "网站将展示的引言。留空则使用全文。视频请写下他们说的最精彩的一句。"
+      save_best_line: "保存"
+      email: "邮箱"
+      source: "来源"
+      page: "页面"
+      locale: "语言"
+      browser: "浏览器"
+      empty: "这里还没有内容。"
+      newer: "← 较新"
+      older: "较旧 →"
+      move_to_pending: "标为待处理"
+      move_to_approved: "批准"
+      move_to_archived: "归档"
+      delete: "删除"
+      delete_confirm: "删除这条评价？"
+      nps_score: "NPS 得分"
+      promoters: "推荐者（9–10）"
+      passives: "中立者（7–8）"
+      detractors: "贬损者（0–6）"
+      score: "分数"
+      comment: "评论"

data/config/routes.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+Testimonials::Engine.routes.draw do
+  # Everything with a fixed name goes first; the flat testimonial routes at
+  # the bottom own "/:id".
+  get 'widget.js', to: 'widgets#show', as: :widget
+  get 'dashboard.js', to: 'widgets#dashboard', as: :dashboard_script
+  get 'new', to: 'collection#show', as: :collection
+  resources :events, only: :create
+  resource :nps, only: :create, controller: 'nps'
+  resources :nps_responses, only: :index
+
+  # Read-only JSON for rendering testimonials anywhere.
+  namespace :api do
+    resources :testimonials, only: :index
+    get 'stats', to: 'stats#show'
+  end
+
+  # Media by testimonial id, gated (admin, author, or public_api + publishable).
+  get ':id/video', to: 'media#video', as: :testimonial_video, constraints: { id: /\d+/ }
+  get ':id/avatar', to: 'media#avatar', as: :testimonial_avatar, constraints: { id: /\d+/ }
+
+  # Flat, human URLs: the mount path IS the resource. /testimonials is the
+  # dashboard, POST /testimonials the widget endpoint, /testimonials/2 a testimonial.
+  resources :testimonials, path: '', only: %i[create index show update destroy],
+                           constraints: { id: /\d+/ }
+
+  root to: 'testimonials#index'
+end

data/lib/generators/testimonials/install/install_generator.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'rails/generators'
+require 'rails/generators/active_record'
+
+module Testimonials
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      include ActiveRecord::Generators::Migration
+
+      source_root File.expand_path('templates', __dir__)
+
+      desc 'Installs testimonials: config initializer, migration, and engine mount.'
+
+      def create_initializer
+        copy_file 'initializer.rb', 'config/initializers/testimonials.rb'
+      end
+
+      def create_migration_file
+        migration_template 'create_testimonials_tables.rb.tt',
+                           'db/migrate/create_testimonials_tables.rb'
+      end
+
+      def mount_engine
+        route %(mount Testimonials::Engine => "/testimonials")
+      end
+
+      def post_install
+        say "\ntestimonials installed. Run `rails db:migrate`, then add", :green
+        say '`<%= testimonials_tag %>` before </body> in your layout.'
+        say 'Triage testimonials at /testimonials (development only until you set config.authorize_admin).'
+        say "Collect from outside the app via /testimonials/new.\n"
+      end
+
+      private
+
+      def migration_version
+        "[#{ActiveRecord::VERSION::MAJOR}.#{ActiveRecord::VERSION::MINOR}]"
+      end
+    end
+  end
+end

data/lib/generators/testimonials/install/templates/create_testimonials_tables.rb.tt

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+class CreateTestimonialsTables < ActiveRecord::Migration<%= migration_version %>
+  def change
+    create_table :testimonials_testimonials do |t|
+      t.string :kind, null: false, default: 'text'
+      t.text :body
+      t.integer :rating
+      t.text :best_line
+      t.string :status, null: false, default: 'pending'
+      t.boolean :featured, null: false, default: false
+      t.boolean :consent_given, null: false, default: false
+      t.string :consent_text
+      t.string :author_id
+      t.string :name
+      t.string :email
+      t.string :title_company
+      t.string :source, null: false, default: 'widget'
+      t.string :page_url
+      t.string :user_agent
+      t.string :locale
+
+      t.timestamps
+    end
+    add_index :testimonials_testimonials, :status
+    add_index :testimonials_testimonials, %i[status consent_given]
+
+    create_table :testimonials_nps_responses do |t|
+      t.integer :score, null: false
+      t.text :comment
+      t.string :author_id
+      t.string :name
+      t.string :email
+      t.string :page_url
+      t.string :user_agent
+      t.string :locale
+
+      t.timestamps
+    end
+    add_index :testimonials_nps_responses, :score
+
+    create_table :testimonials_prompt_events do |t|
+      t.string :kind, null: false
+      t.string :action, null: false
+      t.string :author_id
+      t.string :visitor_token
+
+      t.timestamps
+    end
+    add_index :testimonials_prompt_events, %i[author_id kind]
+    add_index :testimonials_prompt_events, %i[visitor_token kind]
+  end
+end