added uv and pnpm, updated readme

.env.example

@@ -1,18 +1,26 @@
-# Example Environment Variables - Copy to .env and fill in values
+# Example Environment Variables
 
-# --- Database ---
-# Example format: postgresql://user:password@host:port/dbname
+# --- PostgreSQL Config ---
+POSTGRES_USER=moss_user
+POSTGRES_PASSWORD=your_secure_password
+POSTGRES_DB=moss_db
+POSTGRES_HOST=localhost
+POSTGRES_PORT=5432
+
+# --- Redis Config ---
+REDIS_HOST=localhost
+REDIS_PORT=6379
+
+# --- Application URLs (for internal use) ---
 DATABASE_URL=postgresql://moss_user:your_secure_password@localhost:5432/moss_db
+CELERY_BROKER_URL=redis://localhost:6379/0
+CELERY_RESULT_BACKEND_URL=redis://localhost:6379/1
 
 # --- External APIs ---
-# GitHub Personal Access Token (PAT) with 'public_repo' scope recommended
-# Generate one at: https://github.com/settings/tokens (Tokens classic)
+# Select the "Public repositories" option for repository access
+# Generate one at: https://github.com/settings/personal-access-tokens
 GITHUB_API_TOKEN=ghp_YourGitHubTokenHere
-
 # Email address for OpenAlex polite pool (helps with rate limits)
 # See: https://docs.openalex.org/how-to-use-the-api/rate-limits-and-authentication#the-polite-pool
 [email protected]
-
-# Celery Configuration (using Redis as example)
-CELERY_BROKER_URL=redis://localhost:6379/0
-CELERY_RESULT_BACKEND_URL=redis://localhost:6379/1
+VITE_API_BASE_URL=http://0.0.0.0:8000/api/v1

.gitignore

@@ -1,12 +1,45 @@
-# Byte-compiled / optimized / DLL files
+# --- Environments ---
+.venv
+venv/
+env/
+ENV/
+env.bak/
+venv.bak/
+__pypackages__/
+.env
+.env.*.local
+.env.local
+.env.*.test
+.env.test
+.env.*.production
+.env.production
+# Example Env Vars
+!.env.example
+
+# --- Lock Files ---
+Pipfile.lock
+uv.lock
+pnpm-lock.yaml
+
+# --- Python Cache & Compiled Files ---
 __pycache__/
 *.py[cod]
 *$py.class
-
-# C extensions
 *.so
+.coverage
+.coverage.*
+.cache
+.hypothesis/
+.pytest_cache/
+.ropeproject
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+# Pyre type checker
+.pyre/
 
-# Distribution / packaging
+# Python Distribution & Packaging
 .Python
 build/
 develop-eggs/
@@ -27,124 +60,75 @@ share/python-wheels/
 *.egg
 MANIFEST
 
-# PyInstaller
-*.manifest
-*.spec
-
-# Installer logs
-pip-log.txt
-pip-delete-this-directory.txt
-
-# Unit test / coverage reports
-htmlcov/
-.tox/
-.nox/
-.coverage
-.coverage.*
-.cache
-nosetests.xml
-coverage.xml
-*.cover
-*.py,cover
-.hypothesis/
-.pytest_cache/
-
-# Translations
-*.mo
-*.pot
-
-# Django stuff:
-*.log
+# --- Python Tools & Libraries ---
+# Celery
+celerybeat-schedule
+celerybeat.pid
+# Django
 local_settings.py
 db.sqlite3
 db.sqlite3-journal
-
-# Flask stuff:
+# Flask
 instance/
 .webassets-cache
-
-# Scrapy stuff:
-.scrapy
-
-# Sphinx documentation
-docs/_build/
-
-# PyBuilder
-target/
-
-# Jupyter Notebook
-.ipynb_checkpoints
-
 # IPython
 profile_default/
 ipython_config.py
-
-# pyenv
-.python-version
-
-# pipenv
-# According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
-# Pipfile.lock
-
-# PEP 582; used by PDM, Flit and potentially other management tools
-__pypackages__/
-
-# Celery stuff
-celerybeat-schedule
-celerybeat.pid
-
-# SageMath parsed files
+# Jupyter
+.ipynb_checkpoints
+# pip
+pip-log.txt
+pip-delete-this-directory.txt
+# mkdocs
+/site
+# PyBuilder
+target/
+# PyInstaller
+*.manifest
+*.spec
+# SageMath
 *.sage.py
-
-# Environments
-.env
-.venv
-env/
-venv/
-ENV/
-env.bak/
-venv.bak/
-
-# Spyder project settings
+# Scrapy
+.scrapy
+# Sphinx
+docs/_build/
+# Spyder
 .spyderproject
 .spyproject
 
-# Rope project settings
-.ropeproject
-
-# mkdocs documentation
-/site
-
-# mypy
-.mypy_cache/
-.dmypy.json
-dmypy.json
-
-# Pyre type checker
-.pyre/
-
-# OS specific files
+# --- General ---
+# Logs
+logs/
+*.log
+# Test & Coverage Reports
+htmlcov/
+.tox/
+.nox/
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+coverage/
+# OS generated files
 .DS_Store
 Thumbs.db
-
-# Frontend Dependencies / Build artifacts
-frontend/node_modules/
-frontend/dist/
-frontend/.env*.local
-frontend/coverage/
-frontend/.DS_Store
-
-# Log files
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-
-# IDE files
+# IDE & Editor Config
 .idea/
 .vscode/
 *.suo
 *.ntvs*
 *.njsproj
 *.sln
-*.sw?
+*.sw?
+# Translations
+*.mo
+*.pot
+
+# --- Frontend (Node.js/pnpm) ---
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+

.python-version

@@ -0,0 +1 @@
+3.13.5