# Wood DaVinci

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

## About

[Wood DaVinci](https://www.woodsdavinci.com) 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.

## Products

- [3D wooden puzzle models](https://www.woodsdavinci.com/catalogo) (vehicles, aircraft, ships, architecture)
- [Collections](https://www.woodsdavinci.com/colecciones) — themed product groupings
- 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](https://www.woodsdavinci.com/.well-known/x402) payment protocol for AI agent payments. Agents can pay per request using USDC on Base Mainnet.

- Network: Base Mainnet (`eip155:8453`)
- Currency: USDC
- Wallet: `0x917c011d17d45cda32b90bf9bd6e862897b201bb`

## Pages

- [Home](https://www.woodsdavinci.com/) — Homepage with hero, featured products, and CTAs
- [Catalog](https://www.woodsdavinci.com/catalogo) — Full product catalog with search and filters
- [Collections](https://www.woodsdavinci.com/colecciones) — Product collections grouped by theme
- [Profile](https://www.woodsdavinci.com/perfil) — User profile and order history
- [Policies](https://www.woodsdavinci.com/politicas) — Store policies
- [User Profile](https://www.woodsdavinci.com/perfil) — Order history and account settings

## 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](https://wa.me/...v1) available for customer support