`QUICK_START.md`

111 lines
# Handbag Affiliate & RSS System - Quick Start

## 5-Minute Setup

### 1. View Your Data
```bash
# See all 27 affiliate programs
npm run affiliates:list

# Example output:
# RETAILER (13): Moda Operandi, Farfetch, MyTheresa...
# RESELLER (10): Fashionphile, Rebag, The RealReal...
# AUCTION (4): Sotheby's, Christie's, Heritage Auctions...
```

### 2. Collect RSS Data
```bash
# Poll all RSS feeds once
npm run poll-rss

# Saves new items to: data/handbag_rss_items.json
```

### 3. Track Prices Daily
```bash
# Collect today's price snapshots
npm run price-snapshot

# Saves to: data/price_snapshots.json
```

### 4. Automate Collection
```bash
# Install cron jobs (RSS every 15min, prices daily)
./scripts/setup-cron.sh

# View logs
tail -f /var/log/handbag-auth/rss-poll.log
```

---

## npm Scripts Cheat Sheet

```bash
npm run poll-rss              # Poll RSS feeds for new items
npm run price-snapshot        # Collect daily prices
npm run price-history stats   # View snapshot statistics
npm run affiliates:list       # List all affiliates by type
npm run affiliates:signup fashionphile  # Auto-fill signup form
```

---

## React Components

### Price Comparison
```tsx
import { HandbagCompareOffers } from "@/components/HandbagCompareOffers";

<HandbagCompareOffers
  brand="Hermès"
  modelName="Birkin 30"
  offers={realOffersFromRssData}
/>
```

### Historical Chart
```tsx
import { HandbagPriceChart } from "@/components/HandbagPriceChart";

<HandbagPriceChart
  brand="Hermès"
  model="Birkin 30"
  series={realPriceSeriesFromSnapshots}
/>
```

---

## Data Files

All in `/root/Projects/handbag-auth-nextjs/data/`:

- `handbag_rss_sources.json` - 27 RSS feed configs
- `handbag_rss_items.json` - All collected items
- `handbag_affiliates.json` - 27 affiliate programs
- `price_snapshots.json` - Daily price history
- `handbag_merchants.csv` - Source CSV

---

## What's Built

✅ 27 handbag merchants configured
✅ RSS monitoring (new, used, auction)
✅ Daily price snapshots
✅ Historical price charts
✅ Price comparison UI
✅ Affiliate signup automation
✅ Cron job automation
✅ **Real data only - no samples**

---

## Full Documentation

- `HANDBAG_AFFILIATE_RSS_COMPLETE.md` - Complete guide
- `AFFILIATE_RSS_SETUP.md` - Detailed setup instructions
- `src/types/*.ts` - TypeScript definitions