← back to Handbag Auth Nextjs

NO_FABRICATED_DATA_POLICY.md

463 lines

# NO FABRICATED DATA POLICY

## Core Principle
**LUXVAULT will NEVER use fabricated, fake, or made-up data. All data must be clearly sourced and labeled.**

---

## Data Classification System

### ✅ **ALLOWED Data Types**

#### 1. **Research-Based Estimates**
- Data compiled from legitimate industry sources
- Clearly labeled as "estimates" or "research-based"
- Sources must be cited

**Example:**
```
📊 Price Estimate: $42,000
Source: Based on Christie's 2023 auction results + Hermès retail price increases
Methodology: Linear regression of historical auction data
Confidence: Medium (±15%)
```

#### 2. **Public Domain Data**
- Historical auction results (Christie's, Sotheby's)
- Retail price lists (when publicly available)
- Published market reports

**Example:**
```
🗄️ Hermès Birkin 25 Retail History:
2015: $8,500 (Hermès official price list)
2020: $12,000 (Hermès official price list)
2025: $16,000 (Hermès official price list)
```

#### 3. **User-Submitted Data**
- Community valuations (with disclaimer)
- User portfolio data (anonymized)
- Crowdsourced pricing

**Example:**
```
👥 Community Valuation: $38,000 - $45,000
Based on 127 user submissions
Last updated: 3 days ago
```

#### 4. **Live Market Data**
- Real-time scraping from legitimate sites
- API integrations with authorized partners
- Blockchain-verified transaction data

**Example:**
```
🔌 Live Market Price: $42,150
Source: 1stDibs listing #ABC123
Verified: 2 minutes ago
```

---

### ❌ **PROHIBITED Data Types**

#### 1. **Completely Made-Up Numbers**
```
❌ WRONG:
price: 42000 // just guessed this
appreciation: 394 // random percentage
```

```
✅ CORRECT:
price: 42000 // Based on Hermès 2025 retail ($16,000) × 2.6x secondary market premium (source: Baghunter 2024 report)
appreciation: 394 // Calculated from documented price history: 2015 $8,500 → 2025 $42,000
```

#### 2. **Fake Historical Data**
```
❌ WRONG:
priceHistory: [
  { year: 2015, price: 8500 }, // I made these up
  { year: 2016, price: 9200 }, // these aren't real
]
```

```
✅ CORRECT:
priceHistory: [
  { year: 2015, price: 8500, source: "Hermès Paris price list" },
  { year: 2016, price: 9200, source: "Estimated +8% YoY based on Hermès historical price increases (Baghunter)" },
]
```

#### 3. **Misleading Labels**
```
❌ WRONG:
"Real-time market data" (when it's static)
"Verified pricing" (when it's an estimate)
"Live inventory" (when it's examples)
```

```
✅ CORRECT:
"Sample pricing (updated monthly)"
"Estimated market value"
"Example inventory (not available for purchase)"
```

---

## Required Labeling

### Every Data Point Must Have:

1. **Source Attribution**
   ```
   📊 Source: LUXVAULT Research Team
   ```

2. **Update Frequency**
   ```
   ⏰ Updated: Monthly (last: Nov 15, 2025)
   ```

3. **Data Type**
   ```
   ⚠️ Type: Estimate (not live pricing)
   ```

4. **Confidence Level** (when applicable)
   ```
   ✅ Confidence: 75% (based on 12 data points)
   ```

---

## Current LUXVAULT Data Inventory

### **Homepage**
**Featured Bags (3 items):**
- ✅ Type: Research-based examples
- ✅ Source: LUXVAULT research team + public retail data
- ✅ Label: "Sample Investment Opportunities"
- ✅ Update: Static (refreshed quarterly)

**Required Display:**
```tsx
<p className="text-xs text-gray-500">
  📊 Sample pricing based on market research
  ⏰ Updated quarterly
  ⚠️ Not live inventory - examples only
</p>
```

---

### **Marketplace Page**
**6 Investment Bags:**
- ✅ Type: Representative examples
- ✅ Source: Industry reports + retail price data
- ✅ Label: "Example Investment Opportunities"
- ✅ Methodology: Documented in `DATA_METHODOLOGY.md`

**Required Display:**
```tsx
<DataAttribution
  sources={[
    {
      type: 'spreadsheet',
      name: 'LUXVAULT Research Database',
      description: 'Compiled from Hermès retail prices, Christie\'s auctions, Baghunter reports'
    }
  ]}
  methodology="See DATA_METHODOLOGY.md for calculation details"
  lastUpdated="Static examples (not live inventory)"
/>
```

---

### **Museum Page**
**60 Bags with Price History:**
- ✅ Type: Research-based estimates
- ✅ Source: Historical retail prices + documented market trends
- ✅ Label: "Estimated Historical Trajectory"
- ✅ Methodology: Based on known retail increases + secondary market premiums

**Required Display:**
```tsx
<p className="text-xs text-gray-400 mb-4">
  📊 Historical Price Estimates
  <br/>
  Methodology: Hermès published retail prices (2015-2025) + documented secondary market premiums
  <br/>
  Sources: Hermès price archives, Baghunter Annual Reports, Christie's/Sotheby's auction results
  <br/>
  ⚠️ Estimates only - not guaranteed values
</p>
```

---

### **Admin Dashboard**
**Live Database Metrics:**
- ✅ Type: Real-time data
- ✅ Source: LUXVAULT crawlers + SQLite database
- ✅ Label: "Live Platform Data"
- ✅ Update: Every 0.9 seconds

**Current Display:**
```tsx
<DataAttribution
  sources={[
    {
      type: 'database',
      name: 'Live LUXVAULT Database',
      description: 'Real-time scraping from luxury resale sites'
    }
  ]}
  lastUpdated="Real-time (updates every 0.9s)"
  confidence={95}
/>
```

---

## Methodology Documentation Required

### Create `DATA_METHODOLOGY.md`
Document HOW each estimate is calculated:

```markdown
# LUXVAULT Data Methodology

## Marketplace Pricing Estimates

### Hermès Birkin 25 - $42,000 estimate
**Calculation:**
1. Hermès retail price (2025): $16,000
2. Secondary market premium: 2.6x average
   - Source: Baghunter 2024 Handbag Index
   - Based on 500+ transaction analysis
3. Calculation: $16,000 × 2.6 = $41,600
4. Rounded to: $42,000

**Confidence: 80%**
- High: Hermès retail prices are public
- High: Baghunter data is industry-standard
- Medium: Premium varies by color/condition

### Appreciation Rate (394%)
**Calculation:**
1. 2015 retail: $8,500 (Hermès price list)
2. 2025 market: $42,000 (calculated above)
3. Calculation: ($42,000 - $8,500) / $8,500 = 394%

**Confidence: 70%**
- High: 2015 price documented
- Medium: 2025 estimate has ±15% margin
```

---

## Premium Features - Real Data Only

### When We Offer Premium Tiers:

**Free Tier:**
- ✅ Research-based estimates (clearly labeled)
- ✅ Example inventory (not live)
- ✅ Educational content

**Premium Tier ($29.99/mo):**
- ✅ Live API integrations (1stDibs, Vestiaire)
- ✅ Real-time price updates
- ✅ Actual transaction data
- ✅ Verified market prices

**Never:**
- ❌ Fake "live" data on free tier
- ❌ Made-up premium features
- ❌ Misleading upgrade promises

---

## Image Policy

### Current: Unsplash Placeholders
```tsx
// ❌ WRONG - implies these are real product photos
<img src="unsplash.com/..." alt="Hermès Birkin 25" />

// ✅ CORRECT - clearly labeled as representative
<img src="unsplash.com/..." alt="Representative image - not actual product" />
<p className="text-xs text-gray-500">📸 Stock imagery for illustration</p>
```

### Future: Real Product Photos
- Only use photos we have rights to
- Cite source on every image
- Label stock vs. actual inventory

---

## Legal Compliance

### Required Disclaimers

**Investment Disclaimer:**
```
⚠️ IMPORTANT: LUXVAULT does not currently offer fractional ownership or investment products.
All pricing and appreciation data are estimates for educational purposes only.
This is not investment advice. Past performance does not guarantee future results.
```

**Data Accuracy Disclaimer:**
```
📊 Data Transparency: All prices shown are research-based estimates compiled from
industry sources. We do not guarantee accuracy. Always verify pricing independently
before making purchase decisions.
```

---

## Enforcement & Review

### Before ANY Data Goes Live:

1. **Source Check**
   - [ ] Is the data from a legitimate source?
   - [ ] Is the source documented?
   - [ ] Can we cite the source publicly?

2. **Label Check**
   - [ ] Is it clearly labeled (estimate vs. live vs. example)?
   - [ ] Is update frequency stated?
   - [ ] Is confidence level shown (if applicable)?

3. **Methodology Check**
   - [ ] Is calculation methodology documented?
   - [ ] Can someone reproduce our numbers?
   - [ ] Are assumptions clearly stated?

4. **Legal Check**
   - [ ] Are disclaimers present?
   - [ ] No misleading claims?
   - [ ] SEC compliance (if investment-related)?

---

## Examples of Proper Attribution

### Good Example 1: Museum Price History
```tsx
<div className="bg-black/50 rounded-xl p-4">
  <h4 className="font-bold mb-2">Hermès Birkin 25 Price Trajectory</h4>

  <div className="space-y-2 text-sm">
    <div className="flex justify-between">
      <span>2015: $8,500</span>
      <span className="text-gray-500">Hermès retail (documented)</span>
    </div>
    <div className="flex justify-between">
      <span>2020: $12,000</span>
      <span className="text-gray-500">Hermès retail (documented)</span>
    </div>
    <div className="flex justify-between">
      <span>2025: $42,000</span>
      <span className="text-gray-500">Estimate (secondary market)</span>
    </div>
  </div>

  <p className="text-xs text-gray-500 mt-4">
    📊 Methodology: Hermès retail prices + secondary market premium (Baghunter Index)
    <br/>
    ⚠️ Estimates - actual values may vary
  </p>
</div>
```

### Good Example 2: Marketplace Card
```tsx
<div className="bg-gray-900 rounded-2xl p-6">
  <h3>Hermès Birkin 25</h3>
  <p className="text-2xl font-bold text-amber-400">$42,000</p>

  <div className="text-xs text-gray-500 mt-2">
    📊 Estimated Market Value
    <br/>
    Based on: Hermès retail ($16k) + 2.6x secondary premium
    <br/>
    Source: Baghunter 2024 Index
    <br/>
    ⏰ Static estimate (not live pricing)
  </div>
</div>
```

---

## Violation Examples (Never Do This)

### ❌ Bad Example 1: Fake Live Data
```tsx
// NEVER DO THIS
<p>Live Price: $42,000 ✅</p>
<p>Updated 2 minutes ago</p>
// When it's actually static/hardcoded
```

### ❌ Bad Example 2: Misleading Precision
```tsx
// NEVER DO THIS
<p>Current Market Value: $42,157.23</p>
// Fake precision implies accuracy we don't have
```

### ❌ Bad Example 3: Hidden Estimates
```tsx
// NEVER DO THIS
<p>Hermès Birkin 25: $42,000</p>
// No indication this is an estimate
```

---

## Summary: The Golden Rules

1. **Never fabricate data** - Always base on real sources
2. **Always cite sources** - Tell users where data comes from
3. **Label everything** - Estimate? Example? Live? Say so.
4. **Document methodology** - Show your work
5. **Include disclaimers** - Protect users & company
6. **Review before launch** - Checklist every data point
7. **Update honestly** - If data is old, say so
8. **No fake precision** - Don't imply accuracy you don't have

---

## This Policy Applies To:

- ✅ All frontend displays
- ✅ All API responses
- ✅ All marketing materials
- ✅ All investor presentations
- ✅ All social media posts
- ✅ All email communications

---

## Policy Owner
**Owner:** CTO / Product Team
**Last Updated:** November 15, 2025
**Next Review:** December 15, 2025

## Violation Reporting
If you see data that violates this policy:
1. Report immediately to product@luxvault.com
2. Create issue in GitHub with "DATA-POLICY" label
3. Escalate if not fixed within 24 hours