# Information Architecture — Noble Collectable

## Sitemap

```
Home
├── Hero section (tagline, call-to-action to browse)
├── Featured products carousel (recent/best-sellers)
├── Grading & Authenticity explainer
├── About the shop
├── Newsletter signup
└── Footer

Shop / Collection
├── Product grid with filters/search
│   ├── Filter by Category (League, Team, Player, Set, Era)
│   ├── Filter by Attribute (Grade, Condition, Type, Autograph)
│   └── Sort (newest, price, rating)
└── View switcher (grid vs. list)

Product Detail
├── High-res image gallery (multiple angles)
├── Title, player/set info
├── Grade (PSA/BGS), certification number
├── Condition description
├── Edition/serial number
├── Autograph (if applicable)
├── Price
├── Stock status
├── Add to cart
├── Share/wishlist (optional, Phase 3)
├── Related products
└── Customer reviews (optional, Phase 3)

Grading & Authenticity
├── Explanation of PSA/BGS grading scale
├── Certificate verification
├── How to inspect a card
└── Shipping & insurance details

About
├── Shop story
├── Team/owner
├── Why collect football cards
└── Contact info

Contact
├── Email form or contact info
└── FAQ

Account (WooCommerce default)
├── Login / Register
├── My Orders
├── My Address(es)
├── Account Settings
└── Wishlist (optional, Phase 3)

Cart (WooCommerce default)
├── Review items
├── Update quantities
├── Promo code
└── Proceed to checkout

Checkout (WooCommerce default)
├── Billing address
├── Shipping address
├── Shipping method (standard/express/international)
├── Payment method
└── Order review

Order Confirmation (WooCommerce default)
├── Order number
├── Items, total, tracking
└── Shipping/payment info
```

## Product Data Model (WooCommerce)

### Core Fields
- **Title:** Player name + set/edition descriptor (e.g., "Kylian Mbappé, PSA 9, 2024 Heritage Chrome")
- **Description:** Short player bio, set details, notable facts
- **Image:** High-quality primary card photo + gallery (3–6 images)
- **Price:** Current asking price
- **Stock:** Quantity available
- **SKU:** Unique identifier (e.g., `NC-PSA-001`)

### Categories (Taxonomy: WooCommerce Product Categories)
- **League:** Premier League, La Liga, Serie A, Ligue 1, Bundesliga, International, MLS, etc.
- **Team:** Chelsea, PSG, Real Madrid, Bayern, etc.
- **Player:** Auto-generated from title, searchable
- **Set:** Topps 2024, Panini Adrenalyn, Heritage Chrome, Donruss, etc.
- **Era:** Vintage (pre-2000), Modern (2000–2015), Current (2015+)

### Attributes (WooCommerce Product Attributes)
These are filterable characteristics:

1. **Grade (Select):** PSA 10, PSA 9, PSA 8.5, BGS 9.5, BGS 9, Ungraded, Raw
2. **Grading Body (Select):** PSA (Professional Sports Authenticator), BGS (Beckett Grading Services), None (raw)
3. **Condition (Select):** Mint, Near Mint, Excellent, Very Good, Good, Fair, Poor
4. **Certification Number (Text):** Serial/lot number from grading cert
5. **Edition Type (Select):** Standard, Refractor, Chrome, Hologram, Autographed, Serial #/xxx, 1 of 1
6. **Autograph (Yes/No):** Boolean
7. **Language/Region (Select):** English, French, International
8. **Release Year (Number):** 2024, 2023, etc.

### Custom Meta Fields (Optional, Phase 3)
- **Player Nationality:** Country code for filtering
- **Player Position:** Forward, Midfielder, Defender, Goalkeeper
- **Card Rarity:** Common, Rare, Very Rare, Ultra Rare
- **Certification Link:** Direct URL to PSA/BGS verification

## Filtering & Search

**Customers can:**
- Search by player name, team, set
- Filter by league, team, set, era
- Filter by grade, condition, edition type
- Sort by date (newest), price (low–high, high–low), rating
- Save filters (wishlist, if enabled)

**Admin can:**
- Bulk edit products (prices, stock, attributes)
- Set featured/promoted products (homepage carousel)
- Create product bundles (e.g., "Starter Collector Set")

## Checkout Flow

1. **Cart:** Customer reviews items, applies promo codes (optional)
2. **Checkout:** Standard WooCommerce with fields for shipping address, billing address
3. **Shipping Options:**
   - Standard (5–7 business days, EU-only initially)
   - Express (1–2 business days, EU-only initially)
   - International (14–21 days, worldwide)
   - Insured shipping is recommended for high-value cards (details added at checkout)
4. **Payment:** Customer selects from available gateways (Stripe, PayPal, etc.)
5. **Confirmation:** Email receipt with tracking once shipped

## Admin Workflow

**Adding a Product:**
1. Go to Products → Add New
2. Fill in title, description, upload images
3. Set price, stock, SKU
4. Assign categories (League, Team, Set, Era)
5. Add attributes (Grade, Condition, Edition, Autograph, etc.)
6. Publish

**Managing Orders:**
1. View Orders → Woocommerce default
2. Mark as processing/shipped
3. Print label (via shipping integration, Phase 3)
4. Customer gets email notification with tracking

**Inventory Updates:**
1. Bulk edit stock quantities (Products → CSV import or inline edit)
2. Archive/delete sold items
3. Set low-stock alerts

## Bilingual Content (FR/EN)

- All text strings (nav, product descriptions, CTA buttons) are translated via **Polylang**
- Product descriptions can be translated separately per language
- Site switching: Language switcher in header, or `/fr/` URL structure

## Performance & UX Notes

- Product images: Lazy-loaded, optimized (JPEG ~150KB, WebP if supported)
- Grid view: 12–24 products per page (adjust per preference)
- Mobile: Stack to single column, touch-friendly buttons
- Accessibility: Alt text on all images, proper heading hierarchy, color contrast

---

**Next:** See [`BRAND_GUIDE.md`](./BRAND_GUIDE.md) for visual design direction and [`ADMIN_GUIDE.md`](./ADMIN_GUIDE.md) for client-facing instructions.
