fix: Sprint 6 — CLAUDE.md endpoint sync, UncertaintyConfig validator, annotation docs

- Sync CLAUDE.md section 12 with actual implemented endpoints
- Remove undocumented/renamed endpoints, add missing ones
- Mark 4 unimplemented endpoints as Sprint 6+
- Add model_validator on UncertaintyConfig (flag_below >= min_acceptable)
- Add clarification docstring on AnnotationLayer (planned for Sprint 6)
- 2 new validation tests

https://claude.ai/code/session_012NCh8yLxMXkRmBYQgHCTik

CLAUDE.md

@@ -882,9 +882,9 @@ Layer   : PENDING → RUNNING → DONE → FAILED → NEEDS_REVIEW → VALIDATED
 ## 12. Endpoints API — liste complète
 
 ```
-# Configuration & modèles IA
-POST   /api/v1/settings/api-key
-GET    /api/v1/models
+# Providers & modèles IA
+GET    /api/v1/providers
+GET    /api/v1/providers/{provider_type}/models
 POST   /api/v1/models/refresh
 PUT    /api/v1/corpora/{id}/model
 GET    /api/v1/corpora/{id}/model
@@ -898,6 +898,10 @@ POST   /api/v1/corpora
 GET    /api/v1/corpora
 GET    /api/v1/corpora/{id}
 DELETE /api/v1/corpora/{id}
+GET    /api/v1/corpora/{id}/manuscripts
+
+# Manuscrits
+GET    /api/v1/manuscripts/{id}/pages
 
 # Ingestion
 POST   /api/v1/corpora/{id}/ingest/files
@@ -913,9 +917,9 @@ POST   /api/v1/jobs/{job_id}/retry
 # Pages
 GET    /api/v1/pages/{id}
 GET    /api/v1/pages/{id}/master-json
-PUT    /api/v1/pages/{id}/master-json
+PUT    /api/v1/pages/{id}/master-json                    # Sprint 6+
 GET    /api/v1/pages/{id}/layers
-POST   /api/v1/pages/{id}/layers/{layer_type}/regenerate
+POST   /api/v1/pages/{id}/layers/{layer_type}/regenerate # Sprint 6+
 
 # Export
 GET    /api/v1/manuscripts/{id}/iiif-manifest
@@ -924,13 +928,14 @@ GET    /api/v1/pages/{id}/alto
 GET    /api/v1/manuscripts/{id}/export.zip
 
 # Validation
-POST   /api/v1/pages/{id}/validate
+POST   /api/v1/pages/{id}/validate                      # Sprint 6+
 POST   /api/v1/pages/{id}/corrections
 GET    /api/v1/pages/{id}/history
 
 # Recherche
 GET    /api/v1/search?q=
-GET    /api/v1/manuscripts/{id}/search?q=
+POST   /api/v1/search/reindex
+GET    /api/v1/manuscripts/{id}/search?q=                # Sprint 6+
 ```
 
 ---

backend/app/schemas/annotation.py

@@ -22,6 +22,12 @@ class LayerStatus(str, Enum):
 
 
 class AnnotationLayer(BaseModel):
+    """Couche d'annotation de page.
+
+    NOTE: Schéma prévu pour Sprint 6 (validation humaine + couches individuelles).
+    Pas encore utilisé dans les endpoints API ni les modèles SQLAlchemy.
+    """
+
     id: str
     page_id: str
     layer_type: LayerType

backend/app/schemas/corpus_profile.py

@@ -5,7 +5,7 @@ Schémas Pydantic pour le profil de corpus — entité centrale du pipeline.
 from enum import Enum
 
 # 2. third-party
-from pydantic import BaseModel, ConfigDict, Field
+from pydantic import BaseModel, ConfigDict, Field, model_validator
 
 
 class LayerType(str, Enum):
@@ -40,6 +40,14 @@ class UncertaintyConfig(BaseModel):
     flag_below: float = Field(0.4, ge=0.0, le=1.0)
     min_acceptable: float = Field(0.25, ge=0.0, le=1.0)
 
+    @model_validator(mode='after')
+    def flag_must_exceed_min(self) -> 'UncertaintyConfig':
+        if self.flag_below < self.min_acceptable:
+            raise ValueError(
+                f"flag_below ({self.flag_below}) doit être >= min_acceptable ({self.min_acceptable})"
+            )
+        return self
+
 
 class CorpusProfile(BaseModel):
     model_config = ConfigDict(frozen=True)

backend/tests/test_profiles.py

@@ -119,3 +119,21 @@ def test_early_modern_print_no_iconography():
 def test_modern_handwritten_no_iconography():
     profile = load_profile("modern-handwritten.json")
     assert LayerType.ICONOGRAPHY_DETECTION not in profile.active_layers
+
+
+# ---------------------------------------------------------------------------
+# Tests UncertaintyConfig cross-field validation
+# ---------------------------------------------------------------------------
+
+def test_uncertainty_config_flag_below_must_exceed_min():
+    """flag_below < min_acceptable doit lever une erreur."""
+    from app.schemas.corpus_profile import UncertaintyConfig
+    with pytest.raises(ValidationError):
+        UncertaintyConfig(flag_below=0.2, min_acceptable=0.5)
+
+
+def test_uncertainty_config_valid():
+    """flag_below >= min_acceptable est accepté."""
+    from app.schemas.corpus_profile import UncertaintyConfig
+    uc = UncertaintyConfig(flag_below=0.5, min_acceptable=0.3)
+    assert uc.flag_below == 0.5