# Как устроен CaelixFlow

По сути — самодельный файлообменник, который подняли, чтобы не зависеть от Google Drive и не забивать Telegram архивами по 2 ГБ.

## Схема

```
браузер → CDN (cdn.caelixflow.com) → mirror1 (основной)
                                         ↓
                                    mirror2 (запасной)
```

- **mirror1** — главный сервер, сюда льём файлы
- **mirror2** — копия, подтягивается раз в ~15 минут
- **CDN** — раздаёт статику побыстрее, когда кто-то качает одно и то же

## Что можно делать

| Действие | Как |
|----------|-----|
| Смотреть файлы | GET |
| Скачать | GET |
| Залить новый файл | POST |
| Перезаписать существующий | PUT |
| Удалить | DELETE (только у кого есть права) |

**POST** — новые файлы, multipart, chunked upload.  
**PUT** — когда файл уже есть и надо заменить по тому же пути (синк, правка дока, замена картинки в Meridian). Без PUT каждый раз плодятся дубликаты или ломается синхронизация.

## Лимиты

- Файл до **4 ГБ**
- Вложенность папок — до **12 уровней** (больше — уже перебор)
- Старое в `/tmp` чистится через 30 дней — см. `retention-policy.md`