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/main.py

@@ -0,0 +1,68 @@
+"""RehearsalHub FastAPI application entry point."""
+
+from contextlib import asynccontextmanager
+
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+
+from rehearsalhub.config import get_settings
+from rehearsalhub.routers import (
+    annotations_router,
+    auth_router,
+    bands_router,
+    internal_router,
+    members_router,
+    songs_router,
+    versions_router,
+    ws_router,
+)
+
+
+@asynccontextmanager
+async def lifespan(app: FastAPI):
+    yield
+    # Clean up DB connections on shutdown
+    from rehearsalhub.db.engine import get_engine
+
+    engine = get_engine()
+    await engine.dispose()
+
+
+def create_app() -> FastAPI:
+    settings = get_settings()
+
+    app = FastAPI(
+        title="RehearsalHub API",
+        version="0.1.0",
+        docs_url="/api/docs",
+        redoc_url="/api/redoc",
+        openapi_url="/api/openapi.json",
+        lifespan=lifespan,
+    )
+
+    app.add_middleware(
+        CORSMiddleware,
+        allow_origins=[f"https://{settings.domain}", "http://localhost:3000"],
+        allow_credentials=True,
+        allow_methods=["*"],
+        allow_headers=["*"],
+    )
+
+    prefix = "/api/v1"
+    app.include_router(auth_router, prefix=prefix)
+    app.include_router(bands_router, prefix=prefix)
+    app.include_router(songs_router, prefix=prefix)
+    app.include_router(versions_router, prefix=prefix)
+    app.include_router(annotations_router, prefix=prefix)
+    app.include_router(members_router, prefix=prefix)
+    app.include_router(internal_router, prefix=prefix)
+    app.include_router(ws_router)  # WebSocket routes don't use /api/v1 prefix
+
+    @app.get("/api/health")
+    async def health():
+        return {"status": "ok"}
+
+    return app
+
+
+app = create_app()