rpa_vision_v3/docs/DETTE_TECHNIQUE.md

Registre de dette technique

Registre central des dettes techniques identifiées sur le projet. Règle : toute désactivation de contrôle ou contournement assumé fait l'objet d'une entrée. Revue par défaut à création + 14 jours.

Statuts

• OPEN : à traiter
• IN_PROGRESS : en cours de résolution
• RESOLVED : résolu (date résolution + commit ref)
• ACCEPTED : assumé définitivement, pas de résolution prévue

Sévérités

P0 / P1 / P2 / P3 (alignées sur convention handoffs)

Entrées

ID	Date création	Date revue	Sévérité	Statut	Description	Origine
DETTE-001	2026-05-08	2026-05-22	P1	OPEN	Pré-check OCR spatialement aveugle	docs/BUG_PRECHECK_SPATIAL_BLINDNESS_2026-05-08.md
DETTE-002	2026-05-08	2026-05-22	P2	OPEN	Exemption drift > 0.20 si template_matching ≥ 0.95 ou hybrid_text_direct ≥ 0.80 (resolve_engine.py:2367-2390)	docs/AUDIT_CONTROLES_DEBRANCHES_2026-05-08.md (F2.2.1)
DETTE-003	2026-05-08	2026-05-22	P2	OPEN	Self-healing Win+D au retry 1 retiré (revert 22c0a2ba6, replay_engine.py)	docs/AUDIT_CONTROLES_DEBRANCHES_2026-05-08.md (F2.2.3)
DETTE-004	2026-05-08	2026-05-22	P2	OPEN	Cascade OmniParser/YOLO neutralisée — _resolve_by_yolo défini, importé, jamais appelé (resolve_engine.py:293)	docs/AUDIT_CONTROLES_DEBRANCHES_2026-05-08.md (F2.4.1)
DETTE-005	2026-05-08	2026-05-22	P2	OPEN	Sous-système mémoire visuelle orphelin — VisualEmbeddingManager + ScreenshotValidationManager (core/visual/*) définis mais jamais instanciés en runtime	docs/INVESTIGATION_MEMOIRE_VISUELLE_ORPHELINE_2026-05-09.md
DETTE-006	2026-05-08	2026-05-23	P0	IN_PROGRESS	Bug échelle pixel grounding Ollama smart_resize non-déterministe	docs/MIGRATION_VLM_PLAN_2026-05-09.md
DETTE-007	2026-05-09	2026-05-23	P3	OPEN	Trois implémentations smart_resize coexistent (server.py, infigui_worker.py, nouveau module officiel). Unification post-démo Kerella.	commit feat(grounding): module smart_resize officiel
DETTE-008	2026-05-09	2026-05-23	P2	OPEN	Pre-check VLM par-clic désactivé via if False: (observe_reason_act.py:1704-1713)	docs/AUDIT_CONTROLES_DEBRANCHES_2026-05-08.md (F6.1.1)
DETTE-009	2026-05-09	2026-05-23	P3	OPEN	ShadowLearningHook (core/grounding/shadow_learning_hook.py) défini mais jamais instancié — Phase 6 du pipeline FAST→SMART→THINK non câblée à l'observation Shadow	docs/INVESTIGATION_MEMOIRE_VISUELLE_ORPHELINE_2026-05-09.md
DETTE-010	2026-05-09	2026-05-10	P1	IN_PROGRESS	preprocessor_config.json du checkpoint Qwen3-VL-8B-Instruct lu (snapshot 0c351dd01ed87...) : image_processor_type=Qwen2VLImageProcessorFast (variant différent de Qwen2VLImageProcessor lue ce matin), patch_size=16 (vs 14 hypothèse matin → factor probable 32 au lieu de 28), size={longest_edge: 16_777_216, shortest_edge: 65_536} (convention différente de min_pixels/max_pixels), min_pixels/max_pixels absents du config. Investigation requise demain matin : lire transformers.models.qwen2_vl.image_processing_qwen2_vl_fast pour comprendre défauts effectifs et sémantique. Conséquence pour module smart_resize.py : peut nécessiter ajustement (factor, bornes, sémantique). Étape 2 (validation grounding isolée) DOIT être précédée de cette investigation.	docs/MIGRATION_VLM_PLAN_2026-05-09.md + commit 0d7bcd18a (smart_resize) + investigation 2026-05-09
DETTE-011	2026-05-09	2026-05-23	P2	OPEN	Bug cv2.gapi.wip.draw.Text manquant en Python 3.12 (déclenché par import agent_v0.server_v1 dans tests/unit/conftest.py:26). Bloque pytest-cov sur tous les tests qui importent la chaîne. Contournement actuel : stub cv2 + coverage API directe. Investigation : version cv2 vs Python 3.12 compat, ou import conditionnel dans conftest.	session 2026-05-09 (découvert pendant TDD smart_resize)
DETTE-012	2026-05-09	2026-05-23	P3	OPEN	Migration backend grounding vers vLLM (option mentionnée dans plan migration mais infra absente : pas d'install vLLM, pas de service systemd dédié). Choix Transformers direct retenu pour fix DETTE-006. Migration vLLM à instruire séparément si bénéfice mesuré post-démo Kerella.	docs/MIGRATION_VLM_PLAN_2026-05-09.md + investigation infra session 2026-05-09
DETTE-013	2026-05-09	2026-05-23	P2	OPEN	Environnement de tests dev local cassé : pytest tests/unit/ déclenche sys.exit(1) via import api_stream sans RPA_API_TOKEN/RPA_AUTH_DISABLED définis (api_stream.py:135, fail-closed sécurité commit 93ef93e56). Combiné avec DETTE-011 (cv2 dans conftest), la batterie de tests unitaires complète n'est pas exécutable en dev local sans configuration environnement spécifique. À documenter (env vars requises) ou refactor (découpler tests purs des tests chargeant api_stream).	session 2026-05-09 (découvert pendant validation refactor bbox_parser)
DETTE-014	2026-05-09	2026-05-10	P1	OPEN	Module core/grounding/smart_resize.py commité ce matin (commit 0d7bcd18a) calé sur la référence transformers.qwen2_vl.image_processing_qwen2_vl (factor=28, max_pixels=1_003_520). Le checkpoint Qwen3-VL-8B-Instruct utilise en réalité Qwen2VLImageProcessorFast avec patch_size=16 (factor probable 32) et convention size.longest_edge/shortest_edge. À réaligner après investigation DETTE-010 demain. Module pur, testé à 100% sur la convention actuelle — la convention reste valide en référence, mais ne s'applique pas à ce checkpoint.	commit 0d7bcd18a + investigation DETTE-010 du 2026-05-09

Convention de référencement

• Dans les messages de commit : refs DETTE-NNN en pied
• Dans le code : # DETTE-NNN en commentaire au-dessus de la ligne concernée (pour les contournements localisables)