quoter/docs/features.md

# Quoter Features

Simple file upload/download proxy with thumbnail generation and S3 storage.

## What Quoter Does

### 📤 File Upload
- **Multipart uploads** to S3/Storj storage
- **User quotas** (5GB default per user)
- **JWT authentication** with session management
- **MIME type detection** from file content
- **Rate limiting** to prevent abuse

### 📁 File Storage  
- **S3-compatible storage** (Storj primary, AWS fallback)
- **Redis caching** for file metadata and quotas (graceful fallback)
- **Multi-cloud support** with automatic migration

### 🖼️ Thumbnail Generation
- **On-demand WebP thumbnails** with configurable dimensions
- **Storj caching** for generated thumbnails
- **Smart fallback** to original images if generation fails
- **ETag caching** for optimal performance

### 🌐 File Serving
- **Direct file access** via filename
- **Thumbnail access** via `filename_width.ext` pattern
- **Fast response** optimized for Vercel Edge caching
- **CORS whitelist** for secure access (includes Vercel domains)
- **Vercel-compatible headers** for optimal edge caching

## 🚀 Modern Architecture

**Quoter**: File upload/download + thumbnail generation + S3 storage  
**Vercel**: Global CDN + edge optimization

💋 **Self-contained**: Quoter handles everything - uploads, thumbnails, and serving.
💋 **Reliable**: No external dependencies for core functionality.

## Technical Stack

- **Backend**: Rust + Actix Web
- **Storage**: Redis (metadata) + S3/Storj (files)  
- **Auth**: JWT tokens
- **Tests**: 36 passing tests with full coverage

## Status

- ✅ Upload API with quotas
- ✅ Static file server
- ✅ S3 storage integration  
- ✅ JWT authentication
- ✅ Rate limiting & security
- ✅ Thumbnail generation with Storj caching
- ✅ ETag caching for performance
- ✅ Full test coverage
- 🚀 Production ready