docs/hf-api-deploy-script-validation.md

# BacPilot Maroc — Validation réelle du script de déploiement Hugging Face API

## Objectif

Valider que le script suivant fonctionne réellement pour déployer le backend BacPilot sur Hugging Face Space :

scripts/deploy_hf_space_api.py

## Commande validée

python scripts/deploy_hf_space_api.py \
  --commit-message "Deploy BacPilot backend via validated API script" \
  --wait-seconds 90

## Résultat déploiement observé

Le script a construit le dossier temporaire :

/tmp/bacpilot_hf_deploy

Contrôles observés :

HF_DEPLOY_SECRET_SCAN=OK
HF_UPLOAD_FOLDER=OK
HF_COMMIT_MESSAGE=Deploy BacPilot backend via validated API script
HF_REBUILD_WAIT_SECONDS=90

Hugging Face a indiqué :

No files have been modified since last commit. Skipping to prevent empty commit.

Ce résultat est acceptable : cela confirme que le contenu actuellement déployé correspond déjà au contenu préparé par le script.

## Validation production après script

Endpoint santé :

{
  "status": "ok",
  "service": "bacpilot-backend"
}

Endpoint runtime config :

{
  "PROD_RUNTIME_CONFIG": "OK",
  "http_status": 200,
  "app_env": "production",
  "use_llm_pipeline": true,
  "corrector_model": "qwen/qwen3-235b-a22b-2507",
  "llm_timeout_seconds": 90.0
}

Confirmation :

HF_API_SCRIPT_DEPLOY_VALIDATED=OK

## Validation E2E

Test via Supabase Edge Function et frontend script :

- FRONTEND_FETCH_EDGE_TEST=OK
- http_status=202
- final_score=4
- max_score=4
- confidence=CERTAIN
- verdict=CORRECT

## Conclusion

Le déploiement Hugging Face par API est maintenant la méthode recommandée pour BacPilot backend.

Le script est validé en dry-run, en scan anti-secrets, et en production.