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>

watcher/tests/conftest.py

@@ -0,0 +1,17 @@
+"""Watcher test fixtures."""
+
+import pytest
+
+from watcher.config import WatcherSettings
+
+
+@pytest.fixture
+def settings():
+    return WatcherSettings(
+        nextcloud_url="http://nc.test",
+        nextcloud_user="admin",
+        nextcloud_pass="secret",
+        api_url="http://api.test",
+        redis_url="redis://localhost:6379/0",
+        poll_interval=5,
+    )

watcher/tests/test_event_loop.py

@@ -0,0 +1,118 @@
+"""Tests for watcher event loop logic."""
+
+from unittest.mock import AsyncMock, patch
+
+import pytest
+
+from watcher.event_loop import (
+    extract_nc_file_path,
+    is_audio_file,
+    is_band_audio_path,
+    poll_once,
+)
+
+
+def test_is_audio_file_matches_extensions():
+    extensions = [".wav", ".mp3", ".flac"]
+    assert is_audio_file("/bands/foo/songs/bar/take1.wav", extensions)
+    assert is_audio_file("/bands/foo/songs/bar/take1.MP3", extensions)
+    assert not is_audio_file("/bands/foo/songs/bar/cover.jpg", extensions)
+    assert not is_audio_file("/bands/foo/songs/bar/notes.txt", extensions)
+
+
+def test_is_band_audio_path():
+    assert is_band_audio_path("/bands/myband/songs/mysong/take.wav")
+    assert is_band_audio_path("bands/slug/songs/")
+    assert not is_band_audio_path("/nextcloud/files/random.wav")
+    assert not is_band_audio_path("/")
+
+
+def test_extract_nc_file_path_from_objects():
+    activity = {"objects": {"42": "/bands/foo/songs/bar/take.wav"}}
+    path = extract_nc_file_path(activity)
+    assert path == "/bands/foo/songs/bar/take.wav"
+
+
+def test_extract_nc_file_path_from_object_name():
+    activity = {"objects": {}, "object_name": "/bands/foo/songs/bar/take.wav"}
+    path = extract_nc_file_path(activity)
+    assert path == "/bands/foo/songs/bar/take.wav"
+
+
+def test_extract_nc_file_path_returns_none_when_missing():
+    activity = {"objects": {}}
+    path = extract_nc_file_path(activity)
+    assert path is None
+
+
+@pytest.mark.asyncio
+async def test_poll_once_ignores_non_audio_files(settings):
+    from watcher.nc_client import NextcloudWatcherClient
+
+    nc = AsyncMock(spec=NextcloudWatcherClient)
+    nc.get_activities.return_value = [
+        {
+            "activity_id": 1,
+            "subject": "file_created",
+            "objects": {"1": "/bands/foo/songs/bar/image.jpg"},
+        }
+    ]
+
+    with patch("watcher.event_loop.register_version_with_api") as mock_register:
+        await poll_once(nc, settings)
+        mock_register.assert_not_called()
+
+
+@pytest.mark.asyncio
+async def test_poll_once_registers_audio_upload(settings):
+    from watcher.nc_client import NextcloudWatcherClient
+
+    nc = AsyncMock(spec=NextcloudWatcherClient)
+    nc.get_activities.return_value = [
+        {
+            "activity_id": 5,
+            "subject": "file_created",
+            "objects": {"10": "/bands/myband/songs/mysong/take1.wav"},
+        }
+    ]
+    nc.get_file_etag.return_value = "abc123"
+
+    with patch(
+        "watcher.event_loop.register_version_with_api", new_callable=AsyncMock, return_value=True
+    ) as mock_register:
+        await poll_once(nc, settings)
+        mock_register.assert_called_once_with(
+            "/bands/myband/songs/mysong/take1.wav",
+            "abc123",
+            settings.api_url,
+        )
+
+
+@pytest.mark.asyncio
+async def test_poll_once_ignores_non_file_events(settings):
+    from watcher.nc_client import NextcloudWatcherClient
+
+    nc = AsyncMock(spec=NextcloudWatcherClient)
+    nc.get_activities.return_value = [
+        {
+            "activity_id": 2,
+            "subject": "shared",  # not file_created or file_changed
+            "objects": {"5": "/bands/foo/songs/bar/take.wav"},
+        }
+    ]
+
+    with patch("watcher.event_loop.register_version_with_api") as mock_register:
+        await poll_once(nc, settings)
+        mock_register.assert_not_called()
+
+
+@pytest.mark.asyncio
+async def test_poll_once_empty_activities_does_nothing(settings):
+    from watcher.nc_client import NextcloudWatcherClient
+
+    nc = AsyncMock(spec=NextcloudWatcherClient)
+    nc.get_activities.return_value = []
+
+    with patch("watcher.event_loop.register_version_with_api") as mock_register:
+        await poll_once(nc, settings)
+        mock_register.assert_not_called()

watcher/tests/test_nc_client.py

@@ -0,0 +1,80 @@
+"""Tests for Nextcloud OCS client."""
+
+import pytest
+import respx
+import httpx
+
+from watcher.nc_client import NextcloudWatcherClient
+
+
+@pytest.fixture
+def client():
+    return NextcloudWatcherClient(
+        base_url="http://nc.test", username="admin", password="secret"
+    )
+
+
+@pytest.mark.asyncio
+async def test_get_activities_returns_list(client):
+    mock_response = {
+        "ocs": {
+            "data": [
+                {
+                    "activity_id": 1,
+                    "subject": "file_created",
+                    "objects": {"123": "/bands/myband/songs/song1/take1.wav"},
+                }
+            ]
+        }
+    }
+    with respx.mock:
+        respx.get("http://nc.test/ocs/v2.php/apps/activity/api/v2/activity/files").mock(
+            return_value=httpx.Response(200, json=mock_response)
+        )
+        activities = await client.get_activities(since_id=0)
+
+    assert len(activities) == 1
+    assert activities[0]["subject"] == "file_created"
+
+
+@pytest.mark.asyncio
+async def test_get_activities_returns_empty_on_no_data(client):
+    mock_response = {"ocs": {"data": []}}
+    with respx.mock:
+        respx.get("http://nc.test/ocs/v2.php/apps/activity/api/v2/activity/files").mock(
+            return_value=httpx.Response(200, json=mock_response)
+        )
+        activities = await client.get_activities()
+
+    assert activities == []
+
+
+@pytest.mark.asyncio
+async def test_is_healthy_true_when_installed(client):
+    with respx.mock:
+        respx.get("http://nc.test/status.php").mock(
+            return_value=httpx.Response(200, json={"installed": True, "version": "28.0.0"})
+        )
+        result = await client.is_healthy()
+
+    assert result is True
+
+
+@pytest.mark.asyncio
+async def test_is_healthy_false_when_not_installed(client):
+    with respx.mock:
+        respx.get("http://nc.test/status.php").mock(
+            return_value=httpx.Response(200, json={"installed": False})
+        )
+        result = await client.is_healthy()
+
+    assert result is False
+
+
+@pytest.mark.asyncio
+async def test_is_healthy_false_on_connection_error(client):
+    with respx.mock:
+        respx.get("http://nc.test/status.php").mock(side_effect=httpx.ConnectError("refused"))
+        result = await client.is_healthy()
+
+    assert result is False