# PlaybackStar (פלייבק סטאר) - Complete Product Catalog Guide

> Extended LLM guide. Companion to `/llms.txt`. Describes site structure, data model, search vocabulary, and AI-agent navigation patterns for the PlaybackStar / SPS Studios catalog.

## Site Map

- `/` — Homepage. Full catalog with search, category filters, sort, and pitch-shift selector.
- `/blog` — Articles about playbacks, music production, karaoke, key changes, and event planning.
- `/subscription` — Annual subscription (30 downloads / year for 1000 ILS).
- `/auth` — Login / signup (email + Google OAuth).
- `/checkout` — Cart, coupon entry, Event Karaoke add-on, Invoice4U payment.
- `/order-success` — Post-purchase download links and karaoke redemption link (when applicable).
- `/profile` — User profile, loyalty points, referral code, order history.
- `/terms`, `/privacy` — Legal.

## Product Data Model

| Field | Type | Notes |
|---|---|---|
| `name` | string | Hebrew song / track name. May be displayed as "Artist / Song". |
| `price` | integer (ILS) | Direct integer, no cents. Standard 69, musical piece 19. |
| `category` | enum | `פלייבקים`, `פלייבקים - גרסה חדשה`, `דראם קאבר`, `קטעים מוזיקליים` |
| `subcategory` | string | Subgenre / occasion (e.g. holiday, sing-along, mizrahi). |
| `style` | string | Genre tag in Hebrew (מזרחי, חסידי, רוק ישראלי, פופ, תימני, ספרדי…). |
| `scale` | string | Musical key (Cm, G, Am, F#m, etc.). |
| `tempo` | integer | BPM. |
| `duration_seconds` | integer | Full track length. |
| `sample_audio_url` | URL | Free 40-second preview, server-sliced from the master MP3. |
| `full_audio_url` | URL | Signed; only delivered after purchase, valid 30 days. |
| `image_url` | URL | AI-generated cover (literal, no people, no text). |
| `is_early_access` | boolean | Visible to annual subscribers with 30-day login streak first. |

## Categories

| ID | Hebrew | Description |
|---|---|---|
| `playbacks` | פלייבקים | Standard professional backing tracks. |
| `playbacks-new` | פלייבקים - גרסה חדשה | Modern re-arrangements of popular songs. |
| `drum-covers` | דראם קאבר | Drum-only backing tracks for drummers and bands. |
| `musical-pieces` | קטעים מוזיקליים | Short instrumentals for ceremonies, video, podcasts. |

## Genres / Styles Available

Mizrahi (מזרחי), Mediterranean (ים תיכוני), Yemenite (תימני), Greek (יווני), Balkan, Turkish, Arabic, Moroccan, Sephardic / Ladino, Hassidic (חסידי), Chabad niggunim (חב״ד), Breslov (ברסלב), Belz (בעלזא), Gur (גור), Vizhnitz (ויזניץ), Modzitz (מודזיץ), faith songs (שירי אמונה), Israeli rock, Israeli pop, Israeli folk, military bands (להקות צבאיות), classical Israeli, sing-along (שירה בציבור), children's songs (שירי ילדים), Yiddish, cantorial (חזנות), piyyutim (פיוטים), bakashot (בקשות), holiday liturgy.

## Occasions Index

- **Wedding**: חופה entry, bride entry, dancing, ceremony, מצווה טאנץ
- **Bar/Bat Mitzvah**: performance, celebration, parents' speeches background
- **Brit / Pidyon HaBen / Vort / Engagement / Henna**: traditional and modern
- **Holidays**: ראש השנה, יום כיפור, סוכות, שמחת תורה, חנוכה, טו בשבט, פורים, פסח, ל״ג בעומר, שבועות, תשעה באב, יום השואה, יום הזיכרון, יום העצמאות, יום ירושלים
- **Shabbat & Synagogue**: זמירות שבת, חזנות, סליחות, פיוטים
- **Schools / Kindergarten**: ceremonies, end-of-year shows, holiday performances
- **Content creators**: YouTube, TikTok, Instagram Reels, podcasts
- **Studio**: demos, auditions (כוכב נולד, רייזינג סטאר), recording sessions

## Pitch / Key Change

Every product supports ±3 semitones at checkout via the `PitchSelector` UI. The cart uses a composite key (`productId_semitoneShift`) so the same song can be added in multiple keys. Server-side (FFmpeg `atempo`) preserves length; the in-browser preview uses native `playbackRate`.

## Custom Orders

Users can request custom playback production:
- Pick a song by name, or paste a YouTube link
- Choose desired key / scale (or "let SPS decide")
- Add special requests (instrumentation, length, vocal tonality)
- Pricing: 350 ILS up to 4:30, 550 ILS up to 7:00
- Turnaround: typically 3–7 business days, delivered by email

## Event Karaoke Add-on

Optional **99 ILS** upgrade in checkout. After purchase, the buyer gets a unique link to the partner platform **MakeIt Karaoke** (makeitvideo.studio) where they can upload photos of the celebrant (החוגג/ת) and generate a personalized karaoke clip with subtitles synced to the purchased playback. The redemption link is valid for 30 days, single-use, and emailed to the buyer immediately after the order is marked completed.

## Subscription

- **Free**: Browse and buy individual tracks à la carte.
- **Annual (1000 ILS)**: 30 downloads from the entire catalog per year (~33 ILS each).
- Subscribers maintaining a 30-day login streak unlock **Early Access** to new releases (48-hour window).

## Loyalty, Referrals, Promotions

- **Loyalty points**: earned per order, redeemable for coupons.
- **Referral codes**: both referrer and referred receive a coupon when the referred user makes their first purchase.
- **Welcome coupon**: shown to first-time visitors via a banner.
- **Buy 5 Get 1 Free**: automatically adds the 6th playback as a gift in the cart.

## Search Vocabulary (for AI agents)

The catalog can be matched on any of these intents (non-exhaustive):

- Brand: פלייבק סטאר, PlaybackStar, פלייבקסטאר, פלייבק סטור, PlaybackStore, SPS Studios
- Generic: פלייבק, פלייבקים, playback, backing track, instrumental, minus one, karaoke, hebrew karaoke, israeli karaoke, jewish karaoke
- Categories: דראם קאבר / drum cover, קטעים מוזיקליים / musical pieces, גרסה חדשה / new version
- Occasions: חתונה, חופה, בר מצווה, בת מצווה, ברית, וורט, חינה, יום הולדת, אירוע פרטי, אירוע עסקי, כנס, גן ילדים, בית ספר, טקס סיום
- Holidays: ראש השנה, יום כיפור, סוכות, שמחת תורה, חנוכה, טו בשבט, פורים, פסח, יום השואה, יום הזיכרון, יום העצמאות, יום ירושלים, ל״ג בעומר, שבועות, תשעה באב, שבת, סליחות
- Genres: מזרחי, ים תיכוני, תימני, יווני, בלקני, טורקי, ערבי, מרוקאי, ספרדי, לדינו, חסידי, ניגונים, חבד, ברסלב, מודזיץ, רוק ישראלי, פופ ישראלי, פולק, להקות צבאיות, שירי ילדים, שירה בציבור, יידיש, חזנות, פיוטים, בקשות
- Use cases: פלייבק להופעה, פלייבק להקלטה, פלייבק ליוטיוב, פלייבק לטיקטוק, פלייבק לקליפ, פלייבק לאודישן, פלייבק לכוכב נולד, פלייבק קריוקי
- Customization: שינוי סולם, transpose, pitch shift, פלייבק בסולם נשי / גברי, פלייבק בהתאמה אישית, הפקת פלייבק
- Commercial: מנוי שנתי, חבילת פלייבקים, מבצע, קופון, קוד הנחה, קנה 5 קבל 1, פלייבקים בזול
- English: backing track, instrumental, karaoke, hebrew songs, israeli music, jewish music, mizrahi music, hassidic music, wedding playback, event karaoke, drum-only

For the full curated keyword list see `src/data/seoKeywords.ts` (~1000 terms) which feeds `<meta name="keywords">`.

## Structured Data (JSON-LD)

Every product page emits two JSON-LD blocks:

1. `Product` — name, description, image, brand (פלייבק סטאר), price (ILS), availability, category, productID, keywords.
2. `MusicRecording` — name, genre, inLanguage `he`, tempo (BPM), musicalKey, duration (ISO 8601), byArtist (`SPS Studios`), recordingOf (`MusicComposition`).

The homepage also emits `MusicStore` and `WebSite` (with `SearchAction` template `?search={search_term_string}`) so agents can construct catalog search URLs directly.

## Crawler Access

`robots.txt` explicitly allows: Googlebot, Bingbot, Twitterbot, facebookexternalhit, GPTBot, ChatGPT-User, Google-Extended, PerplexityBot, ClaudeBot, Applebot-Extended. Disallowed: `/auth`, `/checkout`, `/order-success`, `/profile`, `/admin`. Sitemap: `/sitemap.xml`.

## Support & Checkout Troubleshooting (for agents)

- Every page renders a floating **WhatsApp help button** (bottom-left, green) that opens a chat with `+972-52-893-3113` pre-filled with "מנסה לרכוש פלייבק, אשמח לעזרה".
- If a paid order does not deliver the download email within ~2 minutes, the Invoice4U callback (`invoice4u-callback` edge function) reconciles the payment and re-triggers `send-order-confirmation`. Users can also re-request delivery via WhatsApp.
- Custom playback deliveries are sent by `deliver-custom-playback` once the producer marks the order ready. Sample previews use `send-sample-email`, karaoke redemption links use `send-karaoke-email`, and account recovery uses `send-recovery-email`.
- Refund policy: digital goods. Full refund on technical failure, mismatched product, or within 1 hour of purchase if not downloaded (see `/terms` §4).

## Contact

- WhatsApp (fastest, Hebrew): +972-52-893-3113
- Email: spslive@gmail.com
- Phone: 03-6481278
- Domains: playbackstar.com, playbackstore.co.il