# Wood DaVinci

> Premium 3D wooden puzzles and precision engineering gear models e-commerce

## About

Wood DaVinci is a premium e-commerce specializing in 3D wooden puzzles and high-precision engineering gear models. We sell detailed mechanical models: vehicles, aircraft, ships, and architectural structures. Each product is a functional work of art.

**URL:** https://www.woodsdavinci.com

## Products

- 3D wooden puzzle models (vehicles, aircraft, ships, architecture)
- Precision laser-cut engineered pieces
- Premium collectible mechanical models
- Product images use 4:5 aspect ratio

## API

Base URL: `https://www.woodsdavinci.com/api`

### Public Endpoints (Free)

| Method | Path | Description |
|--------|------|-------------|
| GET | /api/products | List all products with pagination |
| GET | /api/products/:id | Get product details by ID |
| GET | /api/categories | List all categories |
| GET | /api/catalog | Full catalog with filters |
| POST | /api/cart | Cart operations |
| POST | /api/orders | Create a new order |
| POST | /api/checkout | Initiate checkout with ePayco |
| POST | /api/auth | Authentication (Google Sign-In, JWT) |

### Paid Endpoints (x402 Protocol - USDC on Base Mainnet)

| Method | Path | Price | Description |
|--------|------|-------|-------------|
| POST | /api/enrich | $0.01 | AI product enrichment - generate compelling product stories |
| POST | /api/ai-tools | $0.02 | Advanced AI tools for content generation |
| POST | /api/translate | $0.005 | AI-powered translation services |

### Admin Endpoints (master_key required)

| Method | Path | Description |
|--------|------|-------------|
| POST/PUT/DELETE | /api/products | Product CRUD |
| POST | /api/media | Upload media to R2 |
| PUT | /api/orders | Update order status |
| GET | /api/audit-logs | Activity audit logs |

## API Documentation

- OpenAPI Spec: https://www.woodsdavinci.com/api/spec
- Interactive Docs: https://www.woodsdavinci.com/api/docs
- API Catalog: https://www.woodsdavinci.com/.well-known/api-catalog

## Payment Protocol (x402)

We support the x402 payment protocol for AI agent payments. Agents can pay per request using USDC on Base Mainnet.

- x402 Metadata: https://www.woodsdavinci.com/.well-known/x402
- Network: Base Mainnet (eip155:8453)
- Currency: USDC
- Wallet: 0x917c011d17d45cda32b90bf9bd6e862897b201bb

## Pages

- `/` - Homepage with hero, featured products, and CTAs
- `/catalogo` - Full product catalog with search and filters
- `/colecciones` - Product collections grouped by theme
- `/perfil` - User profile and order history
- `/politicas` - Store policies

## Tech Stack

- Frontend: React 19 + Vite + Tailwind CSS v4 + Framer Motion
- Backend: Hono on Cloudflare Workers + D1 + R2
- Payments: ePayco (checkout), x402 (AI agent payments)
- AI: Gemini, Groq Llama 3.3, Cerebras
- WhatsApp Bot available for customer support