Initial commit: RehearsalHub POC

Full-stack self-hosted band rehearsal platform:

Backend (FastAPI + SQLAlchemy 2.0 async):
- Auth with JWT (register, login, /me, settings)
- Band management with Nextcloud folder integration
- Song management with audio version tracking
- Nextcloud scan to auto-import audio files
- Band membership with link-based invite system
- Song comments
- Audio analysis worker (BPM, key, loudness, waveform)
- Nextcloud activity watcher for auto-import
- WebSocket support for real-time annotation updates
- Alembic migrations (0001–0003)
- Repository pattern, Ruff + mypy configured

Frontend (React 18 + Vite + TypeScript strict):
- Login/register page with post-login redirect
- Home page with band list and creation form
- Band page with member panel, invite link, song list, NC scan
- Song page with waveform player, annotations, comment thread
- Settings page for per-user Nextcloud credentials
- Invite acceptance page (/invite/:token)
- ESLint v9 flat config + TypeScript strict mode

Infrastructure:
- Docker Compose: PostgreSQL, Redis, API, worker, watcher, nginx
- nginx reverse proxy for static files + /api/ proxy
- make check runs all linters before docker compose build

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

api/src/rehearsalhub/services/band.py

@@ -0,0 +1,51 @@
+from __future__ import annotations
+
+import uuid
+
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from rehearsalhub.db.models import Band
+from rehearsalhub.repositories.band import BandRepository
+from rehearsalhub.schemas.band import BandCreate, BandReadWithMembers
+from rehearsalhub.storage.nextcloud import NextcloudClient
+
+
+class BandService:
+    def __init__(self, session: AsyncSession, storage: NextcloudClient | None = None) -> None:
+        self._repo = BandRepository(session)
+        self._storage = storage or NextcloudClient()
+
+    async def create_band(self, data: BandCreate, creator_id: uuid.UUID, creator: object | None = None) -> Band:
+        if await self._repo.get_by_slug(data.slug):
+            raise ValueError(f"Slug already taken: {data.slug}")
+
+        nc_folder = (data.nc_base_path or f"bands/{data.slug}/").strip("/") + "/"
+        storage = NextcloudClient.for_member(creator) if creator else self._storage
+        try:
+            await storage.create_folder(nc_folder)
+        except Exception:
+            pass  # NC might not be reachable during tests; folder creation is best-effort
+
+        band = await self._repo.create(
+            name=data.name,
+            slug=data.slug,
+            genre_tags=data.genre_tags,
+            nc_folder_path=nc_folder,
+        )
+        await self._repo.add_member(band.id, creator_id, role="admin")
+        return band
+
+    async def get_band_with_members(self, band_id: uuid.UUID) -> Band | None:
+        return await self._repo.get_with_members(band_id)
+
+    async def assert_membership(self, band_id: uuid.UUID, member_id: uuid.UUID) -> str:
+        """Returns the member's role or raises PermissionError."""
+        role = await self._repo.get_member_role(band_id, member_id)
+        if role is None:
+            raise PermissionError("Not a member of this band")
+        return role
+
+    async def assert_admin(self, band_id: uuid.UUID, member_id: uuid.UUID) -> None:
+        role = await self.assert_membership(band_id, member_id)
+        if role != "admin":
+            raise PermissionError("Admin role required")