mrleo1nidandCursor
73ad61e7a5
ci / ts / ts (packages + web) (push) Canceled after 1m0s
ci / api / api (push) Successful in 46s
ci / contract / contract (сгенерированный код совпадает с openapi.yaml) (push) Successful in 56s
ci / db / db (push) Successful in 1m32s
ci / mobile / mobile (Metro-бандл Android) (push) Successful in 1m27s
ci / docker / docker (образы собираются — их сервер собирает сам при обновлении) (push) Successful in 1m31s
Search hits omit album covers and artist images. The worker now reads the full song and artist, stores the description, and leaves Genius image URLs unchanged on mobile. Co-authored-by: Cursor <cursoragent@cursor.com>
Документация 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 | Стриминг, транскодинг, состояние плеера, офлайн |
| genius.md | Genius: токен, поиск метаданных, парсинг текстов и проверочная команда |
| playlists.md | Личные плейлисты: API, веб и Android |
| recommendations.md | Рекомендательная система и «Моя волна» |
| web.md | Веб-клиент |
| desktop.md | Десктоп Windows / Linux / macOS (Tauri) |
| 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.