docs: update README project structure, CI section, and remove stale LanceDB volume instructions

Author: whynotkimhari

HOSTING.md

@@ -10,7 +10,6 @@ Interpres uses LanceDB to store document embeddings for RAG retrieval. The locat
 - **Storage:** Stored locally on the filesystem within the Docker container (or mounted via Docker volumes).
 - **Configuration:** 
   - `LANCEDB_PATH=/lancedb` (or a local directory path).
-  - In `docker-compose.yml`, you must ensure the `lancedb_data` volume is uncommented and mounted to persist vectors across container restarts.
 
 ### Production
 - **Storage:** Hosted on Google Cloud Storage (GCS) for centralized remote access.

README.md

@@ -241,21 +241,6 @@ This script:
 3. Generates embeddings via the Modal EmbeddingService.
 4. Stores everything in a local LanceDB directory.
 
-When using Option B for local Docker development, uncomment the `lancedb_data` volume in `docker-compose.yml`:
-
-```yaml
-volumes:
-  # ...
-  lancedb_data:   # Uncomment this line
-```
-
-And in the backend service section:
-
-```yaml
-volumes:
-  - lancedb_data:${LANCEDB_PATH}   # Uncomment this line
-```
-
 ### Step 4: Deploy ML Services to Modal
 
 If you have not already done so, deploy the ML models to Modal:
@@ -408,8 +393,9 @@ GitHub Actions runs on every push and pull request to `main`:
 
 - **Backend CI** (`backend.yml`): Ruff linting, then pytest with a PostgreSQL service container.
 - **Frontend CI** (`frontend.yml`): ESLint, TypeScript type checking, then Vitest with coverage.
+- **React Doctor** (`react-doctor.yml`): Agentic code review for React components.
 
-Both pipelines are path-filtered to only run when relevant files change.
+All pipelines are path-filtered to only run when relevant files change.
 
 
 ## Project Structure
@@ -422,7 +408,17 @@ Interpres/
 |-- railway.json                             # Railway deployment config
 |-- deploy_modal.sh                          # Script to deploy ML services to Modal
 |-- .env.example                             # Template for environment variables
-|-- HOSTING.md                               #  Local vs production environment guide
+|-- HOSTING.md                               # Local vs production environment guide
+|
+|-- docs/
+|   +-- diagrams/
+|       |-- drawio/                          # Editable draw.io source files
+|       |-- puml/                            # PlantUML diagram sources
+|       |-- render/                          # Exported PDFs and SVGs
+|       +-- use_cases.md                     # Detailed use case specification
+|
+|-- scripts/
+|   +-- cleanup.sh                           # Remove caches and build artifacts
 |
 |-- src/
 |   |-- backend/
@@ -439,22 +435,29 @@ Interpres/
 |   |   |   |-- jobs.py                      # Background job tracking
 |   |   |   +-- prompts.py                   # Custom prompt templates
 |   |   |-- routes/                          # FastAPI route handlers
+|   |   |   |-- dependencies.py              # Shared auth + pipeline config deps
+|   |   |   |-- schemas.py                   # Pydantic request/response models
 |   |   |   |-- auth.py                      # Google OAuth login/callback
 |   |   |   |-- pipeline.py                  # Main transcription pipeline endpoint
 |   |   |   |-- translations.py              # Translation CRUD endpoints
 |   |   |   |-- collections.py               # RAG collection management
-|   |   |   |-- jobs.py                      # Job status endpoints
+|   |   |   |-- jobs.py                      # Batch job endpoints
 |   |   |   |-- prompts.py                   # Prompt template endpoints
-|   |   |   +-- user.py                      # User profile endpoints
+|   |   |   |-- user.py                      # API key management endpoints
+|   |   |   +-- utils.py                     # Health check + image serving
 |   |   |-- services/                        # Business logic and ML interfaces
 |   |   |   |-- interfaces.py                # Abstract base classes for Modal services
 |   |   |   |-- pipeline.py                  # Pipeline orchestration logic
+|   |   |   |-- event_bus.py                 # SSE event bus for streaming
 |   |   |   |-- ocr_services.py              # OCR model wrappers
 |   |   |   |-- correction_services.py       # Post-OCR correction wrapper
 |   |   |   |-- rag_services.py              # RAG retrieval logic
 |   |   |   |-- llm_services.py              # LLM integration (Gemini, OpenAI)
+|   |   |   |-- skip_service.py              # No-op service for skipped stages
 |   |   |   +-- models.py                    # Pipeline configuration models
-|   |   +-- tests/                           # Pytest test suite
+|   |   |-- utils/
+|   |   |   +-- text_processing.py           # Text chunking and normalization
+|   |   +-- tests/                           # Pytest test suite (131 tests, 95% coverage)
 |   |
 |   |-- frontend/
 |   |   |-- Dockerfile                       # Multi-stage Node.js 20 build
@@ -467,7 +470,7 @@ Interpres/
 |   |   |   |-- history/                     # Translation history browser
 |   |   |   |-- jobs/                        # Background job monitoring
 |   |   |   |-- prompts/                     # Prompt template editor
-|   |   |   |-- settings/                    # User settings
+|   |   |   |-- settings/                    # User settings (API keys)
 |   |   |   +-- share/                       # Public translation sharing
 |   |   |-- components/                      # Reusable React components
 |   |   |-- lib/                             # Utility functions and API client
@@ -481,9 +484,13 @@ Interpres/
 |       |-- push_to_hf.py                    # Push datasets to Hugging Face
 |       +-- standardize_data.py              # Data normalization utilities
 |
+|-- .gemini/
+|   +-- config.yaml                          # Agent PR Reviewer
+|
 +-- .github/workflows/
     |-- backend.yml                          # Backend CI (lint + test)
-    +-- frontend.yml                         # Frontend CI (lint + type-check + test)
+    |-- frontend.yml                         # Frontend CI (lint + type-check + test)
+    +-- react-doctor.yml                     # React Doctor (agentic lint + test)
 ```
 
 

src/backend/tests/integration/test_db_translations.py

@@ -4,7 +4,6 @@
     delete_translation,
     get_shared_translation,
     get_translation,
-    get_user_translation_count,
     get_user_translations,
     save_translation,
     share_translation,