docs/README.md

# Quoter Documentation

Simple file upload proxy with S3 storage and user quotas.

## 📚 Documentation

- **[SETUP.md](./SETUP.md)** - Installation, configuration, and deployment
- **[architecture.md](./architecture.md)** - Technical details for developers
- **[configuration.md](./configuration.md)** - Environment variables reference
- **[features.md](./features.md)** - What Quoter does  
- **[how-it-works.md](./how-it-works.md)** - System overview
- **[hybrid-architecture.md](./hybrid-architecture.md)** - Vercel + Quoter integration
- **[vercel-og-integration.md](./vercel-og-integration.md)** - OpenGraph integration

## 🎯 Key Concept

**Quoter = Upload + Storage. Vercel = Thumbnails + Optimization.**

Upload files to Quoter → Store in S3 → Serve via Vercel Edge API for best performance.
[0.6.1] - 2025-09-02 ### 🚀 Изменено - Упрощение архитектуры - Генерация миниатюр: Полностью удалена из Quoter, теперь управляется Vercel Edge API - Очистка legacy кода: Удалены все функции генерации миниатюр и сложность - Документация: Сокращена с 17 файлов до 7, следуя принципам KISS/DRY - Смена фокуса: Quoter теперь сосредоточен на upload + storage, Vercel обрабатывает миниатюры - Логирование запросов: Добавлена аналитика источников для оптимизации CORS whitelist - Реализация таймаутов: Добавлены настраиваемые таймауты для S3, Redis и внешних операций - Упрощенная безопасность: Удален сложный rate limiting, оставлена только необходимая защита upload ### 📝 Обновлено - Консолидирована документация в практическую структуру: - Основной README.md с быстрым стартом - docs/SETUP.md для конфигурации и развертывания - Упрощенный features.md с фокусом на основную функциональность - Добавлен акцент на Vercel по всему коду и документации ### 🗑️ Удалено - Избыточные файлы документации (api-reference, deployment, development, и т.д.) - Дублирующийся контент в нескольких документах - Излишне детальная документация для простого файлового прокси 💋 Упрощение: KISS принцип применен - убрали избыточность, оставили суть. 2025-09-02 14:00:54 +03:00			`# Quoter Documentation`
docs 2025-08-02 00:18:09 +03:00
[0.6.1] - 2025-09-02 ### 🚀 Изменено - Упрощение архитектуры - Генерация миниатюр: Полностью удалена из Quoter, теперь управляется Vercel Edge API - Очистка legacy кода: Удалены все функции генерации миниатюр и сложность - Документация: Сокращена с 17 файлов до 7, следуя принципам KISS/DRY - Смена фокуса: Quoter теперь сосредоточен на upload + storage, Vercel обрабатывает миниатюры - Логирование запросов: Добавлена аналитика источников для оптимизации CORS whitelist - Реализация таймаутов: Добавлены настраиваемые таймауты для S3, Redis и внешних операций - Упрощенная безопасность: Удален сложный rate limiting, оставлена только необходимая защита upload ### 📝 Обновлено - Консолидирована документация в практическую структуру: - Основной README.md с быстрым стартом - docs/SETUP.md для конфигурации и развертывания - Упрощенный features.md с фокусом на основную функциональность - Добавлен акцент на Vercel по всему коду и документации ### 🗑️ Удалено - Избыточные файлы документации (api-reference, deployment, development, и т.д.) - Дублирующийся контент в нескольких документах - Излишне детальная документация для простого файлового прокси 💋 Упрощение: KISS принцип применен - убрали избыточность, оставили суть. 2025-09-02 14:00:54 +03:00			`Simple file upload proxy with S3 storage and user quotas.`
docs 2025-08-02 00:18:09 +03:00
[0.6.1] - 2025-09-02 ### 🚀 Изменено - Упрощение архитектуры - Генерация миниатюр: Полностью удалена из Quoter, теперь управляется Vercel Edge API - Очистка legacy кода: Удалены все функции генерации миниатюр и сложность - Документация: Сокращена с 17 файлов до 7, следуя принципам KISS/DRY - Смена фокуса: Quoter теперь сосредоточен на upload + storage, Vercel обрабатывает миниатюры - Логирование запросов: Добавлена аналитика источников для оптимизации CORS whitelist - Реализация таймаутов: Добавлены настраиваемые таймауты для S3, Redis и внешних операций - Упрощенная безопасность: Удален сложный rate limiting, оставлена только необходимая защита upload ### 📝 Обновлено - Консолидирована документация в практическую структуру: - Основной README.md с быстрым стартом - docs/SETUP.md для конфигурации и развертывания - Упрощенный features.md с фокусом на основную функциональность - Добавлен акцент на Vercel по всему коду и документации ### 🗑️ Удалено - Избыточные файлы документации (api-reference, deployment, development, и т.д.) - Дублирующийся контент в нескольких документах - Излишне детальная документация для простого файлового прокси 💋 Упрощение: KISS принцип применен - убрали избыточность, оставили суть. 2025-09-02 14:00:54 +03:00			`## 📚 Documentation`
docs 2025-08-02 00:18:09 +03:00
[0.6.1] - 2025-09-02 ### 🚀 Изменено - Упрощение архитектуры - Генерация миниатюр: Полностью удалена из Quoter, теперь управляется Vercel Edge API - Очистка legacy кода: Удалены все функции генерации миниатюр и сложность - Документация: Сокращена с 17 файлов до 7, следуя принципам KISS/DRY - Смена фокуса: Quoter теперь сосредоточен на upload + storage, Vercel обрабатывает миниатюры - Логирование запросов: Добавлена аналитика источников для оптимизации CORS whitelist - Реализация таймаутов: Добавлены настраиваемые таймауты для S3, Redis и внешних операций - Упрощенная безопасность: Удален сложный rate limiting, оставлена только необходимая защита upload ### 📝 Обновлено - Консолидирована документация в практическую структуру: - Основной README.md с быстрым стартом - docs/SETUP.md для конфигурации и развертывания - Упрощенный features.md с фокусом на основную функциональность - Добавлен акцент на Vercel по всему коду и документации ### 🗑️ Удалено - Избыточные файлы документации (api-reference, deployment, development, и т.д.) - Дублирующийся контент в нескольких документах - Излишне детальная документация для простого файлового прокси 💋 Упрощение: KISS принцип применен - убрали избыточность, оставили суть. 2025-09-02 14:00:54 +03:00			`- [SETUP.md](./SETUP.md) - Installation, configuration, and deployment`
			`- [architecture.md](./architecture.md) - Technical details for developers`
			`- [configuration.md](./configuration.md) - Environment variables reference`
			`- [features.md](./features.md) - What Quoter does`
			`- [how-it-works.md](./how-it-works.md) - System overview`
			`- [hybrid-architecture.md](./hybrid-architecture.md) - Vercel + Quoter integration`
			`- [vercel-og-integration.md](./vercel-og-integration.md) - OpenGraph integration`
📚 Complete documentation overhaul ### New Documentation: - URL Format Guide: Complete guide for image resizer URL patterns - Hybrid Architecture: Vercel Edge + Quoter integration strategy - Updated How-it-works: Comprehensive system architecture with diagrams - Enhanced Configuration: Security settings, troubleshooting, Vercel integration ### Documentation Structure: 📋 Architecture & Principles: - 🚀 How Quoter Works (detailed system architecture) - 🔀 Hybrid Architecture (Vercel + Quoter best practices) - 📐 URL Format (complete resizer URL guide) 🛡️ Security & Configuration: - 🔒 Security & DDoS Protection (comprehensive guide) - ⚙️ Configuration (updated with new settings) - 🚀 Deployment & 📊 Monitoring 🎨 Integrations: - Vercel OG Integration guides - Edge Function examples ### Key Features Documented: - Complete URL patterns for image resizing - Security rate limiting configuration - Hybrid upload (Quoter) + download (Vercel) strategy - JWT validation and session management - Multi-cloud storage (Storj + AWS fallback) - Performance optimization techniques - Production deployment strategies All documentation is now production-ready and includes practical examples! 📖✨ 2025-09-02 12:32:15 +03:00
[0.6.1] - 2025-09-02 ### 🚀 Изменено - Упрощение архитектуры - Генерация миниатюр: Полностью удалена из Quoter, теперь управляется Vercel Edge API - Очистка legacy кода: Удалены все функции генерации миниатюр и сложность - Документация: Сокращена с 17 файлов до 7, следуя принципам KISS/DRY - Смена фокуса: Quoter теперь сосредоточен на upload + storage, Vercel обрабатывает миниатюры - Логирование запросов: Добавлена аналитика источников для оптимизации CORS whitelist - Реализация таймаутов: Добавлены настраиваемые таймауты для S3, Redis и внешних операций - Упрощенная безопасность: Удален сложный rate limiting, оставлена только необходимая защита upload ### 📝 Обновлено - Консолидирована документация в практическую структуру: - Основной README.md с быстрым стартом - docs/SETUP.md для конфигурации и развертывания - Упрощенный features.md с фокусом на основную функциональность - Добавлен акцент на Vercel по всему коду и документации ### 🗑️ Удалено - Избыточные файлы документации (api-reference, deployment, development, и т.д.) - Дублирующийся контент в нескольких документах - Излишне детальная документация для простого файлового прокси 💋 Упрощение: KISS принцип применен - убрали избыточность, оставили суть. 2025-09-02 14:00:54 +03:00			`## 🎯 Key Concept`
build-reconfig2 2025-09-02 10:46:51 +03:00
[0.6.1] - 2025-09-02 ### 🚀 Изменено - Упрощение архитектуры - Генерация миниатюр: Полностью удалена из Quoter, теперь управляется Vercel Edge API - Очистка legacy кода: Удалены все функции генерации миниатюр и сложность - Документация: Сокращена с 17 файлов до 7, следуя принципам KISS/DRY - Смена фокуса: Quoter теперь сосредоточен на upload + storage, Vercel обрабатывает миниатюры - Логирование запросов: Добавлена аналитика источников для оптимизации CORS whitelist - Реализация таймаутов: Добавлены настраиваемые таймауты для S3, Redis и внешних операций - Упрощенная безопасность: Удален сложный rate limiting, оставлена только необходимая защита upload ### 📝 Обновлено - Консолидирована документация в практическую структуру: - Основной README.md с быстрым стартом - docs/SETUP.md для конфигурации и развертывания - Упрощенный features.md с фокусом на основную функциональность - Добавлен акцент на Vercel по всему коду и документации ### 🗑️ Удалено - Избыточные файлы документации (api-reference, deployment, development, и т.д.) - Дублирующийся контент в нескольких документах - Излишне детальная документация для простого файлового прокси 💋 Упрощение: KISS принцип применен - убрали избыточность, оставили суть. 2025-09-02 14:00:54 +03:00			`Quoter = Upload + Storage. Vercel = Thumbnails + Optimization.`
docs 2025-08-02 00:18:09 +03:00
[0.6.1] - 2025-09-02 ### 🚀 Изменено - Упрощение архитектуры - Генерация миниатюр: Полностью удалена из Quoter, теперь управляется Vercel Edge API - Очистка legacy кода: Удалены все функции генерации миниатюр и сложность - Документация: Сокращена с 17 файлов до 7, следуя принципам KISS/DRY - Смена фокуса: Quoter теперь сосредоточен на upload + storage, Vercel обрабатывает миниатюры - Логирование запросов: Добавлена аналитика источников для оптимизации CORS whitelist - Реализация таймаутов: Добавлены настраиваемые таймауты для S3, Redis и внешних операций - Упрощенная безопасность: Удален сложный rate limiting, оставлена только необходимая защита upload ### 📝 Обновлено - Консолидирована документация в практическую структуру: - Основной README.md с быстрым стартом - docs/SETUP.md для конфигурации и развертывания - Упрощенный features.md с фокусом на основную функциональность - Добавлен акцент на Vercel по всему коду и документации ### 🗑️ Удалено - Избыточные файлы документации (api-reference, deployment, development, и т.д.) - Дублирующийся контент в нескольких документах - Излишне детальная документация для простого файлового прокси 💋 Упрощение: KISS принцип применен - убрали избыточность, оставили суть. 2025-09-02 14:00:54 +03:00			`Upload files to Quoter → Store in S3 → Serve via Vercel Edge API for best performance.`