Files
pipu-music/docs
mrleo1nidandClaude Opus 5.5 4d2c6ce22f
ci / mobile / mobile (Metro-бандл Android) (push) Successful in 1m30s
ci / ts / ts (packages + web) (push) Successful in 2m11s
fix(web): treat AIFF and WavPack as lossless in the upload format hint
The web check only accepted FLAC and WAV, so AIFF files were flagged
"needs attention" although the server already counts them as lossless.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-21 10:35:43 +03:00
..

Документация Pipu Music

Pipu Music — self-hosted музыкальный сервис (веб + Android) с умной бесконечной лентой «Моя волна».

Карта документов

Документ О чём
IDEA.md Продукт глазами пользователя
design.md Дизайн-система: токены, шрифты, анимация, кнопка волны, каркас экранов
architecture.md Общая архитектура, компоненты, потоки данных, структура репозитория
data-model.md Схема БД PostgreSQL
api.md REST API: соглашения, эндпоинты, ошибки
auth-and-roles.md Аутентификация, токены, роли и права, первый запуск
library-and-storage.md Хранилища (NFS), шаблоны путей, сканер, метаданные, поиск
uploads.md Предложение треков модераторами: очередь, квота, дубли, одобрение, раскладка в хранилище
playback.md Стриминг, транскодинг, состояние плеера, офлайн
recommendations.md Рекомендательная система и «Моя волна»
web.md Веб-клиент
mobile.md Android-приложение, офлайн, самообновление
i18n.md Локализация (ru / en, расширяемость)
install-guide.md Пошагово: установка сервера на домен с HTTPS, подключение веба и Android
admin-guide.md Администратору: пользователи, хранилища, очередь, волна, обновления, диагностика
deployment.md Справочник по развёртыванию: сервисы, каталоги, переменные

Стек в одном абзаце

Backend API — Go; рекомендации и аудиоанализ — Python; БД — PostgreSQL + pgvector; поиск — Meilisearch; кэш / очереди событий — Redis; раздача аудио — nginx (X-Accel-Redirect); веб — React + TypeScript + Vite; мобильное — React Native (Expo, Android); деплой — Docker Compose.