# Veliu Bag - AI Agent Documentation Index

> Veliu Bag è la piattaforma italiana per la compravendita di articoli di lusso usati. 
> Stima AI-powered, rete di buyer certificata e pagamenti sicuri.
> 
> Token count: ~2.5K (this file) | Language: Italian/English

## Platform Overview

Veliu Bag operates a two-sided marketplace for luxury fashion resale:
- **SELLERS** get instant AI valuations and sell to certified buyers
- **BUYERS** browse curated inventory from individual sellers and professional dealers
- **PLATFORM** handles authentication, secure payments, and shipping logistics

## Core User Flows

### Sell Flow (Valutazione e Vendita)
1. [Homepage](/) - Search or browse to start (1.5K tokens)
2. [Product Search](/search-results) - Find your item via text/image/voice (3K tokens)
3. [Valuation](/bag-page) - AI-powered price estimate and condition assessment (4K tokens)
4. [Order Creation](/orders) - Accept offer, provide address/IBAN, ship item (3K tokens)
5. [Order Tracking](/orders) - Monitor status: received → authenticated → paid (2K tokens)

### Buy Flow (Acquisto)
1. [Buy Search](/buy-search) - Browse catalog with filters (brand, price, condition) (3K tokens)
2. [Product Detail](/buy-product) - View item details, photos, seller info (2.5K tokens)
3. [Checkout](/buy-checkout) - Secure payment via Stripe (2K tokens)
4. [Order Confirmation](/buy-checkout-success) - Track delivery and authentication (1.5K tokens)

## Key Pages & Content

### Public Pages (No Auth Required)
- [/](/) - Homepage with search, featured items, value proposition (2K tokens)
- [/search-results](/search-results) - AI search results with valuation previews (3K tokens)
- [/buy-search](/buy-search) - Buyer catalog with advanced filters (3.5K tokens)
- [/buy-product/:id](/buy-product) - Product detail with photos and pricing (2.5K tokens)
- [/market-insights](/market-insights) - Price trends and market data (2K tokens)
- [/help-center](/help-center) - FAQ, shipping info, authentication process (3K tokens)
- [/brand/:slug](/brand) - Brand-specific landing pages (2K tokens)

### Authenticated Pages
- [/bag-page](/bag-page) - Seller valuation and offer management (4K tokens)
- [/orders](/orders) - Order history and tracking (2.5K tokens)
- [/profile](/profile) - User settings, addresses, IBAN, notifications (2K tokens)
- [/favorites](/favorites) - Saved items and wishlist (1.5K tokens)
- [/balance](/balance) - Transaction history and payouts (1.5K tokens)

### Admin Portal (Restricted)
- [/portal](/portal) - Order management dashboard (blocked in robots.txt)

## Platform Capabilities

### For Sellers
- **AI Valuation**: Upload photos → instant price estimate based on market data
- **Multi-channel Search**: Text, image upload, or voice search to find items
- **Secure Shipping**: Prepaid labels with tracking and insurance
- **Authentication Guarantee**: Items verified by experts before payout
- **Fast Payout**: Direct bank transfer within 24h of authentication

### For Buyers
- **Curated Catalog**: Filter by brand, price, condition, size, color
- **Authentication Service**: Every item verified before shipping
- **Secure Payments**: Stripe-powered checkout with buyer protection
- **Price Transparency**: Market insights and price history
- **Deferred Listings**: Save items and get notified of price drops

### Trust & Safety
- **KYC Verification**: Identity verification for all sellers
- **Expert Authentication**: Professional authenticators check every item
- **Secure Escrow**: Funds held until buyer confirms receipt
- **Insurance Coverage**: Shipping insurance on all transactions
- **Return Policy**: 14-day return window for authenticated items

## Technology Stack
- React 18 + TypeScript + Vite
- Tailwind CSS + shadcn/ui
- Supabase (backend)
- Stripe (payments)
- Capacitor (mobile apps)

## Agent Instructions
For detailed platform documentation, see:
- [AGENTS.md](/AGENTS.md) - Complete agent instructions and project context
- [skill.md](/skill.md) - Platform capabilities and constraints
- [agent-permissions.json](/agent-permissions.json) - Access rules and rate limits

## Contact
- Support: support@veliu.com
- Business: business@veliu.com
- Website: https://veliu.com