chore: add project layout and dependencies

.env.example

@@ -0,0 +1,28 @@
+# ---- Application ----
+ENVIRONMENT=development
+
+# ---- Database ----
+DATABASE_URL=postgresql+psycopg://USER:PASSWORD@HOST:5432/DBNAME?sslmode=require
+DIRECT_DATABASE_URL=postgresql+psycopg://USER:PASSWORD@HOST:5432/DBNAME?sslmode=require
+TEST_DATABASE_URL=postgresql+psycopg://USER:PASSWORD@HOST:5432/DBNAME_test?sslmode=require
+
+# ---- Auth ----
+JWT_SECRET_KEY=replace-with-48-bytes-of-random-urlsafe-text
+
+# ---- Google Gemini ----
+GEMINI_API_KEY=replace-with-your-google-ai-studio-key
+GEMINI_MODEL=gemini-flash-latest
+GEMINI_EMBEDDING_MODEL=gemini-embedding-2
+
+# ---- RAG ----
+EMBEDDING_DIM=768
+CHUNK_SIZE_TOKENS=500
+CHUNK_OVERLAP_TOKENS=50
+INLINE_SYNC_MAX_CHARS=20000
+RAG_TOP_K=5
+RAG_MIN_SIMILARITY=0.55
+RAG_FAITHFULNESS_MIN=0.70
+RAG_RELEVANCY_MIN=0.70
+
+# ---- CORS ----
+CORS_ORIGINS=http://localhost:3000

.gitignore

@@ -0,0 +1,24 @@
+# Environment / secrets
+.env
+.env.*
+!.env.example
+*.pem
+*.key
+
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+*.egg-info/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# OS / editor
+.DS_Store
+Thumbs.db
+.vscode/
+.idea/

requirements-dev.txt

@@ -0,0 +1,6 @@
+pytest
+pytest-cov
+pytest-mock
+python-dotenv
+pre-commit
+ragas

requirements.txt

@@ -0,0 +1,16 @@
+fastapi
+uvicorn[standard]
+sqlalchemy>=2
+alembic
+psycopg[binary]
+pgvector
+pydantic>=2
+pydantic-settings
+email-validator
+pyjwt
+bcrypt
+google-genai
+httpx
+transparent-fastapi
+python-multipart
+pypdf