Files
pipu-music/AGENTS.md
T
mrleo1nid e158558da3
ci / module boundaries / boundaries (push) Successful in 6s
ci / api / api (push) Successful in 47s
ci / contract / contract (сгенерированный код совпадает с openapi.yaml) (push) Successful in 1m2s
ci / db / db (push) Successful in 1m4s
ci / docker / docker (образы собираются — их сервер собирает сам при обновлении) (push) Successful in 1m30s
ci / ts / ts (packages + web) (push) Successful in 2m54s
ci / mobile / mobile (Metro-бандл Android) (push) Successful in 1m14s
refactor: isolate playback and upload use cases
2026-10-22 13:52:16 +03:00

2.0 KiB
Raw Blame History

Работа с проектом

  • Начинай с ближайшего локального AGENTS.md и файлов конкретной возможности. Карта документов: docs/README.md; реализация архитектуры: docs/architecture.md.
  • Web/desktop UI: apps/web/src; Android: apps/mobile/src; общие правила клиентов: packages/core/src; Go API: services/api/internal; рекомендации: services/recommender/pipu_rec.
  • Контракт HTTP — api/openapi.yaml. Читай нужную операцию и связанные схемы. Generated-код (**/gen/**, **/generated/**) и lock-файлы исследуй точечно; не редактируй вручную.
  • После изменения OpenAPI: pnpm --filter @pipu/api-client generate, затем из services/api: go generate ./.... Проверяй и коммить результат генерации.
  • Новые правила размещай у владельца сценария, IO — в адаптере. Сохраняй явные границы транзакций и платформенные особенности. Узкий интерфейс вводи для конкретного потребителя.
  • Промежуточно запускай проверки затронутой области; перед сдачей — необходимые связанные проверки. Команды запускаются из корня, если не сказано иначе.
  • Общие проверки: pnpm typecheck, pnpm test, pnpm i18n:check, pnpm test:scripts. Go: из services/api — go vet ./..., go test ./.... Python: из services/recommender — uv run ruff check ., uv run mypy pipu_rec, uv run pytest.
  • Не меняй пользовательские артефакты, локальные бинарники и посторонние незакоммиченные файлы.