mrleo1nidandClaude Opus 5.5
4fa1add80d
ci / contract (сгенерированный код совпадает с openapi.yaml) (push) Successful in 48s
ci / api (push) Successful in 51s
ci / recommender (push) Canceled after 2s
ci / ts (packages + web) (push) Canceled after 0s
ci / docker (образы собираются — их сервер собирает сам при обновлении) (apps/web/Dockerfile, web, ) (push) Canceled after 0s
ci / docker (образы собираются — их сервер собирает сам при обновлении) (services/api/Dockerfile, api, api) (push) Canceled after 0s
ci / docker (образы собираются — их сервер собирает сам при обновлении) (services/api/Dockerfile, storage-agent, storage-agent) (push) Canceled after 0s
ci / docker (образы собираются — их сервер собирает сам при обновлении) (services/recommender/Dockerfile, recommender, ) (push) Canceled after 0s
ci / mobile (Metro-бандл Android) (push) Canceled after 0s
Security and robustness: - storage-agent rejects an empty INTERNAL_TOKEN (config notEmpty + middleware) - api takes the client IP only from X-Real-IP (chi RealIP trusted True-Client-IP) - /readyz reports ok/fail and logs the cause; checks run in parallel with a timeout - storage-agent shuts down gracefully; shared httpx.NewServer/Serve with IdleTimeout - goose migrations take a Postgres advisory lock - recommender readyz: per-check timeout, redis socket timeouts Clients: - Android release allows cleartext HTTP for LAN servers (expo-build-properties) - checkServer times out after 10s; connect button is disabled while checking Deploy and CI: - install.sh hands cache/uploads/updates/models to the non-root service users - update.sh refuses downgrades unless PIPU_ALLOW_DOWNGRADE=1 - recommender/analyzer get only the env they need; required secrets fail fast - nginx security headers and CSP; strip True-Client-IP - dev compose binds ports to 127.0.0.1; postgres/redis images pinned - version.mjs fails on a malformed explicit tag instead of releasing 0.0.0-dev - contract check catches untracked generated files - final releases fail without a release keystore; changelog skips rc tags Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Документация Pipu Music
Pipu Music — self-hosted музыкальный сервис (веб + Android) с умной бесконечной лентой «Моя волна».
Карта документов
| Документ | О чём |
|---|---|
| IDEA.md | Исходная идея продукта глазами пользователя (вход для дизайна) |
| design.md | Дизайн-система (токены, шрифты, анимация), кнопка волны, решения по вариантам прототипа, ссылки на макеты |
| architecture.md | Общая архитектура, компоненты, потоки данных, структура репозитория |
| decisions.md | ADR — принятые архитектурные решения и их обоснование |
| 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, расширяемость) |
| testing.md | Стратегия тестирования |
| ci-cd.md | Gitea Actions: проверки и релиз по тегу |
| install-guide.md | Пошагово: установка сервера на домен с HTTPS, подключение веба и Android |
| deployment.md | Справочник по развёртыванию: сервисы, каталоги, переменные, бэкапы |
| conventions.md | Соглашения по коду, git, версиям |
| roadmap.md | Этапы разработки и критерии готовности |
Стек в одном абзаце
Backend API — Go; рекомендации и аудиоанализ — Python; БД — PostgreSQL + pgvector; поиск — Meilisearch; кэш / очереди событий — Redis; раздача аудио — nginx (X-Accel-Redirect); веб — React + TypeScript + Vite; мобильное — React Native (Expo, Android); монорепо — pnpm + Turborepo; CI/CD — Gitea Actions; деплой — Docker Compose.