testimonials 0.9.0 → 0.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b79e1e2893951f81ee3c7144fd2c2eaba89d6b6753e75b243b7ec961aa5ec39b
-  data.tar.gz: c55a34d075dfa5604b302a21a3c75d317fcef8253420799a343b64878b8fb65f
+  metadata.gz: 0cbc7f22314c712ecb0e1eb5d92a3d66981193bc1fc19f8664f635d381db0045
+  data.tar.gz: '020981c67a45702104ebf9cdfd9f685ffc17d44653a3476560c0fb662176e445'
 SHA512:
-  metadata.gz: 6fb8c825f96b096352a4f181de4b6da669bead079925461b0cff538ee79cbd31d77917a834c07abf621e4f7a49835c66740b84b175ebb0575f522692f1e8e91c
-  data.tar.gz: 8f28f17a353aa422e90fed7949f9cd991bf5d47f60e8d396cd4f4086e21daa0da4dd2c11d4ba521a5cbf6429c139303db99e52c32dcc969ea49d037576e5f69c
+  metadata.gz: 1ca4a49fd102d401ae88b344c951655e68e88af3fb0da1a11819b7b600edb9ad11543feb5440a25f2127e138f4da54d9d7447a3b260a79d7e3cb59b5abcdbfb2
+  data.tar.gz: d8c94fe02b56b3e91adf3eb39e1c87e88b70d4f0d9ed4102e8058901b019f0a1c5fb4d1d02327be255c18b5ca58afedae06e7386efd58978d16d017fde1bc8d5

data/AGENTS.md

@@ -210,6 +210,6 @@ Conventions this codebase holds to — follow them rather than the first thing t
 - **Every install shape gets a test that drops the table for real** (`test/integration/skip_nps_test.rb`, `skip_prompt_events_test.rb`), so a slipped guard raises `no such table` instead of passing quietly. Generator tests pin each migration and initializer shape and check the ERB still compiles as Ruby.
 - **The widget is plain ES5-style JS in `lib/testimonials/widget.js`**, served by the engine, no build step, no framework. It reads its config from a JSON block on every `turbo:load`.
 - **Display stays headless.** New display UI belongs in `examples/`, not in `app/views`.
-- **`lib/testimonials/dashboard.css` is half shared.** Everything above the `GEM-SPECIFIC` banner is the design system all five gems in the family ship — the same tokens, the same `.page-head`/`.tabs`/`.filters`/`.card`/`.badge`/`button`, the same `.dashboard-shell` + `.record-row` + `.detail-panel` two-pane dashboard — identical in every repo apart from the `tml` prefix. Diff it against a sibling before changing it, and carry the change to the other four. Anything only this gem has goes below the banner. New dashboard markup reuses the shared class names rather than inventing a domain-specific one.
+- **`lib/testimonials/dashboard.css` is half shared.** Everything above the `GEM-SPECIFIC` banner is the design system all five gems in the family ship — the same tokens, the same `.page-head`/`.tabs`/`.filters`/`.card`/`.badge`/`button`/`.status-switch`, the same `.dashboard-shell` + `.record-row` + `.detail-panel` two-pane dashboard — identical in every repo apart from the `tml` prefix. Diff it against a sibling before changing it, and carry the change to the other four. Anything only this gem has goes below the banner. New dashboard markup reuses the shared class names rather than inventing a domain-specific one.
 - Every user-facing change bumps `lib/testimonials/version.rb` and adds a `CHANGELOG.md` entry that says what it costs, not only what it adds.
 - Commit messages are prose that explains the tradeoff — read `git log` before writing one.

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.9.1
+
+- **The demo data now teaches responsible collection.** Its testimonials cover
+  success-moment prompting, pending moderation, public consent, private
+  archiving, best lines, and the shared approval rules for text and video. The
+  promoter, passive, and detractor comments explain why the balanced sample has
+  an NPS of zero.
+- The bundled video remains intentionally generic: it proves protected upload
+  and playback without pretending to be customer evidence. Rerunning
+  `testimonials:seed_demo` refreshes the existing demo rows and can overwrite
+  edits to them; non-demo customer records are not touched.
+
 ## 0.9.0
 
 - **One design system across the family.** The stylesheet now opens with a

data/lib/testimonials/dashboard.css

@@ -144,6 +144,19 @@
   & .actions form { display: inline; }
   & .form-actions { padding-top: 12px; }
 
+  /* Status switch: one pill holding every state a record can be in, the state it
+     is in now lit. Each other segment is a submit button, so moving a record
+     takes one click and no JavaScript; the current segment is a `type="button"`
+     so clicking it cannot re-file the record it is already filed under. Two
+     states or five, the pill sizes itself. A gem tints the lit segment with its
+     own status colour — see the `GEM-SPECIFIC` section. */
+  & .status-switch { display: inline-flex; flex: 0 0 auto; margin: 0; padding: 3px; border: 1px solid var(--tml-border); border-radius: 999px; background: var(--tml-bg); }
+  & .status-switch button { min-height: 30px; padding: 0 12px; border: 0; border-radius: 999px; background: none; color: var(--tml-muted); font-size: 13px; font-weight: 700; white-space: nowrap; transition: background .16s ease, color .16s ease; }
+  & .status-switch button:hover { border: 0; background: color-mix(in srgb, var(--tml-muted) 12%, transparent); color: var(--tml-text); }
+  & .status-switch button.current { background: var(--tml-surface); color: var(--tml-text); box-shadow: 0 1px 2px rgba(15, 23, 42, .12); cursor: default; }
+  & .status-switch button.current:hover { background: var(--tml-surface); }
+  & .panel-head .status-switch { margin-left: auto; }
+
   & .card { overflow: hidden; border: 1px solid var(--tml-border); border-radius: 12px; background: var(--tml-surface); }
   & .card.pad { padding: 16px; overflow: visible; }
   & table { width: 100%; border-collapse: collapse; }
@@ -266,6 +279,7 @@
     & .dashboard-detail .detail-panel { min-height: calc(100vh - 64px); }
     & .mobile-back { display: block; flex: 0 0 auto; margin: 4px 0 10px; font-size: 13px; }
     & .panel-head h1 { font-size: 18px; }
+    & .status-switch button { padding: 0 9px; font-size: 12px; }
     & dl { grid-template-columns: 1fr; gap: 3px; }
     & dd { margin-bottom: 8px; }
   }

data/lib/testimonials/seeds.rb

@@ -9,8 +9,10 @@ module Testimonials
       {
         seed_id: 'approved-founder',
         kind: 'text',
-        body: 'We added the widget after onboarding and collected better customer quotes in the first week.',
-        best_line: 'Collected better customer quotes in the first week.',
+        body: 'We call testimonial_prompt! after a customer completes onboarding, when the value is still ' \
+              'fresh. The prompt feels earned, and the quotes are much more specific than the ones we used ' \
+              'to request by email.',
+        best_line: 'Ask after a real success moment and the quotes become specific.',
         rating: 5,
         status: 'approved',
         featured: true,
@@ -18,7 +20,7 @@ module Testimonials
         consent_text: 'You can use my testimonial publicly in your marketing and sales.',
         name: 'Maya Chen',
         email: 'maya@example.com',
-        title_company: 'Founder, DemoCRM',
+        title_company: 'Founder, Demo CRM',
         source: 'widget',
         page_url: '/onboarding/complete',
         locale: 'en'
@@ -26,7 +28,9 @@ module Testimonials
       {
         seed_id: 'pending-operator',
         kind: 'text',
-        body: 'The NPS prompt felt lightweight and did not interrupt the workflow.',
+        body: 'This response has public consent, but it is still pending. That separation gives our team a ' \
+              'chance to verify the quote, choose a best line, and approve it before anything appears on the ' \
+              'wall of love.',
         rating: 4,
         status: 'pending',
         featured: false,
@@ -34,7 +38,7 @@ module Testimonials
         consent_text: 'You can use my testimonial publicly in your marketing and sales.',
         name: 'Jon Bell',
         email: 'jon@example.com',
-        title_company: 'Operations Lead, ExampleCo',
+        title_company: 'Operations Lead, Example Co',
         source: 'nps',
         page_url: '/reports',
         locale: 'en'
@@ -42,7 +46,8 @@ module Testimonials
       {
         seed_id: 'private-archive',
         kind: 'text',
-        body: 'Useful for our internal rollout notes, but please do not publish my name.',
+        body: 'I am happy for the team to keep this feedback internally, but I did not consent to public ' \
+              'use. Archiving it keeps the learning without making it publishable.',
         rating: 3,
         status: 'archived',
         featured: false,
@@ -58,8 +63,10 @@ module Testimonials
       {
         seed_id: 'approved-video',
         kind: 'video',
-        body: 'Short demo video testimonial with a real MP4 attachment.',
-        best_line: 'A real video testimonial is ready to review.',
+        body: 'The attached clip is intentionally generic demo media. It proves the upload, review, and ' \
+              'protected playback path; replace it with a real customer recording before using this record ' \
+              'anywhere public.',
+        best_line: 'Video follows the same consent and approval workflow as text.',
         rating: 5,
         status: 'approved',
         featured: true,
@@ -67,7 +74,7 @@ module Testimonials
         consent_text: 'You can use my testimonial publicly in your marketing and sales.',
         name: 'Alex Rivera',
         email: 'alex@example.com',
-        title_company: 'Head of Product, VideoDemo',
+        title_company: 'Head of Product, Demo Video Co',
         source: 'page',
         page_url: '/testimonials/new',
         locale: 'en'
@@ -76,9 +83,12 @@ module Testimonials
 
     NPS_RESPONSES = [
       { seed_id: 'promoter', score: 10,
-        comment: 'Fast to install and easy to trust because the data stays in our app.' },
-      { seed_id: 'passive', score: 8, comment: 'The flow is useful, but I would like more display examples.' },
-      { seed_id: 'detractor', score: 4, comment: 'I was not sure when the prompt would appear again.' }
+        comment: 'A 9 or 10 is a promoter. One promoter contributes positively to the NPS score.' },
+      { seed_id: 'passive', score: 8,
+        comment: 'A 7 or 8 is passive. Keep the feedback, but this response does not move the NPS score.' },
+      { seed_id: 'detractor', score: 4,
+        comment: 'A score from 0 to 6 is a detractor. With one promoter and one detractor, this demo board ' \
+                 'totals 0 NPS.' }
     ].freeze
 
     PROMPT_EVENTS = [

data/lib/testimonials/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Testimonials
-  VERSION = '0.9.0'
+  VERSION = '0.9.1'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: testimonials
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.9.1
 platform: ruby
 authors:
 - Yaroslav Shmarov
@@ -152,7 +152,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.10
 specification_version: 4
 summary: 'Testimonials, reviews and NPS for Rails: in-app collection widget, public
   collection page, triage dashboard, and a read API.'