mrleo1nidandClaude Opus 5.5 ed4a492dba
ci / contract / contract (сгенерированный код совпадает с openapi.yaml) (push) Successful in 1m15s
ci / api / api (push) Successful in 1m31s
ci / mobile / mobile (Metro-бандл Android) (push) Successful in 47s
ci / ts / ts (packages + web) (push) Successful in 39s
ci / docker / docker (образы собираются — их сервер собирает сам при обновлении) (push) Successful in 26s
feat(api): sign-in, refresh rotation and bootstrap admin (M1)
- users, refresh_tokens and audit_log schema (migration 00002)
- argon2id passwords with rehash on login, password policy, lockout
  with exponential back-off and a per-IP rate limit in Redis
- Ed25519 JWT access tokens with kid-based key rotation; rotating
  refresh tokens with reuse detection (cookie for web, body for Android)
- bootstrap admin on first start; must_change_credentials and
  must_change_password gate every other endpoint
- /auth/login, /auth/refresh, /auth/logout(-all), /me, /me/password,
  /me/bootstrap-credentials, /me/sessions; server-info reports
  bootstrap_required
- role policy from docs/auth-and-roles.md with table tests
- problem+json errors with field errors; ru/en translations of the codes
- install.sh and update.sh generate JWT_PRIVATE_KEY

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-20 06:12:25 +03:00

pipu-music

Self-hosted музыкальный сервис: веб и Android-приложение, библиотека на NFS, умная бесконечная лента «Моя волна» с учётом вкуса, звучания треков и настроения.

Структура

Путь Что
api/openapi.yaml Контракт публичного API — источник истины для сервера и клиентов
services/api Go: публичный API (cmd/api) и агент хранилищ (cmd/storage-agent)
services/recommender Python: рекомендации (pipu-rec serve) и аудиоанализ (pipu-rec analyze)
apps/web Веб-клиент (React + Vite)
apps/mobile Android-приложение (React Native + Expo)
packages/* Общий TS-код: api-client, core, i18n, design-tokens
deploy/ Docker Compose, nginx, скрипты установки и обновления
tests/fixtures/music Генератор тестовой библиотеки (нужен ffmpeg)
.gitea/workflows CI по областям (ci-*.yml, docker.yml) и релиз по тегу (release.yml)

Разработка

Нужны: Go 1.24+, Node 22 + pnpm 11, uv, Docker; для Android — JDK 17 и Android SDK.

pnpm install
docker compose -f deploy/compose.dev.yaml up -d

API (из services/api):

DATABASE_URL="postgres://pipu:pipu@localhost:5432/pipu?sslmode=disable" REDIS_URL="redis://localhost:6379/0" go run ./cmd/api

Веб на http://localhost:5173 (проксирует /api на :8080):

pnpm --filter @pipu/web dev

Проверки — те же, что в CI:

pnpm typecheck && pnpm test && pnpm i18n:check && pnpm test:scripts
cd services/api && go vet ./... && go test ./...
cd services/recommender && uv run ruff check . && uv run mypy pipu_rec && uv run pytest

После изменения api/openapi.yaml или packages/design-tokens/tokens.json перегенерируйте код и закоммитьте результат:

pnpm generate && (cd services/api && go generate ./...)

Релиз

Тег vX.Y.Z (или vX.Y.Z-rc.N) запускает .gitea/workflows/release.yml: Gitea Release с заметками → подписанный APK докладывается в него. Docker-образы не публикуются: сервер клонирует репозиторий и собирает их сам (deploy/update.sh, docs/install-guide.md). Нужные секреты — в шапке workflow и в docs/ci-cd.md.

S
Description
No description provided
Readme
5.7 MiB
0 Stars 1 Watchers 0 Forks
2026-10-30 08:26:39 +00:00
Languages
TypeScript 47.7%
Go 37.4%
Python 6.6%
CSS 4.1%
JavaScript 2%
Other 2.2%