tests/codemap.md

backend/tests/

Responsibility

Python regression and contract tests for backend routes, services, RAG retrieval/ingestion, and startup behavior.

Design

• Pytest test modules use focused test functions/classes and unittest.mock fixtures to isolate external boundaries.
• conftest.py provides Firebase auth/Firebase Admin test doubles so tests do not require production credentials.
• Route tests use FastAPI TestClient and main.app; unit tests import service/RAG symbols directly.
• Representative coverage: test_rag_pipeline.py, test_160_rag_lesson_retrieval.py, test_video_routes.py, test_admin_model_routes.py, test_wri_service.py, and test_memory_health.py.

Flow

• Test setup → conftest.py patches Firebase boundaries → imports route/service modules or constructs TestClient(app).
• Requests exercise route → handler → mocked or real-in-process service contracts; assertions cover status, response shape, authorization, and persistence behavior.
• RAG tests call retrieval/parsing helpers directly and validate filters, exact-file behavior, lesson context, and ingestion transformations.
• Service tests validate deterministic logic such as WRI, email configuration, model profiles, caching, and memory health.

Integration

• Tests mirror /api/... route → handler → service → Firestore/DeepSeek/RAG Chroma boundaries while mocking external dependencies as appropriate.
• Test modules are consumers of backend/main.py, backend/routes/, backend/services/, and backend/rag/; they do not define production APIs.