Initial Aurora Core 0.1 implementation

Production-grade media metadata backend per docs/aurora-core-spec.md: Aurora-owned UUIDv7 identity system, normalized movie/TV/people/credits schema, provider abstraction with a TMDb adapter, an idempotent async ingestion pipeline (normalize -> match -> upsert -> provenance), a Postgres FTS/trigram search layer, a stateless FastAPI v1 API with Redis caching/rate-limiting, arq workers, dev/prod Docker Compose topologies, unit + integration + load tests, CI, and architecture/ database/API/ERD documentation. Co-Authored-By: Claude Sonnet 5 <[email protected]>
2026-09-04 17:34:03 -05:00
commit c20df1c503
111 changed files with 10041 additions and 0 deletions
@@ -0,0 +1,44 @@
+# Copy to .env and fill in real values for local development.
+# NEVER commit a real .env file.
+
+# --- Runtime ---
+AURORA_ENV=development
+AURORA_LOG_LEVEL=INFO
+AURORA_API_DOCS_ENABLED=true
+
+# --- Database ---
+# Async URL used by the application (asyncpg driver).
+DATABASE_URL=postgresql+asyncpg://aurora:aurora@localhost:5432/aurora_core
+# Sync URL used by Alembic migrations (psycopg2 driver).
+DATABASE_URL_SYNC=postgresql+psycopg2://aurora:aurora@localhost:5432/aurora_core
+DATABASE_POOL_SIZE=10
+DATABASE_MAX_OVERFLOW=20
+
+# --- Redis ---
+REDIS_URL=redis://localhost:6379/0
+# If false, the app runs without caching/rate-limiting when Redis is unreachable
+# instead of failing readiness checks.
+REDIS_REQUIRED=false
+
+# --- Security ---
+# Generate with: python -c "import secrets; print(secrets.token_urlsafe(48))"
+AURORA_SECRET_KEY=changeme-generate-a-real-secret
+# Comma-separated API keys allowed to call /api/v1/admin/* endpoints.
+AURORA_ADMIN_API_KEYS=changeme-admin-key
+
+# --- CORS ---
+CORS_ORIGINS=http://localhost:3000,http://localhost:5173
+
+# --- Providers ---
+# https://www.themoviedb.org/settings/api
+TMDB_API_KEY=
+
+# --- Workers ---
+WORKER_CONCURRENCY=4
+
+# --- Caching ---
+CACHE_DEFAULT_TTL=300
+
+# --- Rate limiting ---
+RATE_LIMIT_ENABLED=true
+RATE_LIMIT_PER_MINUTE=120