# Guide d'onboarding — AI Act Audit Trail
## Le Monde Sémantique · KGaaS Platform

**URL de l'application** : https://aiact-audit.lemondesemantique.com/app/

---

## 1. Connexion

Rendez-vous sur l'application et saisissez votre **clé API Pro** (format `pk_live_…`).
Votre clé est disponible dans votre espace client sur [lemondesemantique.fr/api-pro](https://lemondesemantique.fr/api-pro).

Compte démonstration : clé `demo-key-0000` — graphe AI Act préchargé.

---

## 2. Charger votre propre graphe AI Act

### Format attendu
Votre graphe doit être en **Turtle (`.ttl`)** et respecter l'ontologie AI Act fournie.
Téléchargez le modèle : `data/graphe-03-aiact-audit.ttl`

### Namespaces obligatoires
```turtle
@prefix aia:  <http://lemondesemantique.fr/graph/aiact-audit/> .
@prefix aiav: <http://lemondesemantique.fr/graph/aiact-audit/vocab/> .
@prefix prov: <http://www.w3.org/ns/prov#> .
```

### Chargement via curl
```bash
curl -X POST "https://lemondesemantique.fr/api-pro/v1/endpoints/custom.php" \
  -H "X-API-Key: VOTRE_CLE_API" \
  -H "Content-Type: text/turtle" \
  --data-binary @votre-graphe-aiact.ttl \
  "?graph=http://lemondesemantique.fr/graph/aiact-audit/client-VOTRE_ID"
```

### Chargement via script
```bash
./triplestore/loader.sh votre-graphe-aiact.ttl \
    http://lemondesemantique.fr/graph/aiact-audit/client-VOTRE_ID
```

---

## 3. Structure minimale requise

Votre graphe doit contenir au minimum :

```turtle
# Un système IA à haut risque
<votre-systeme> a aiav:SystemeIAHautRisque ;
    rdfs:label "Nom du système"@fr ;
    aia:versionModele "1.0.0" ;
    aia:categorieAnnexeIII "ANNEX_III_4" ;
    aia:supervisionHumaineActive "true"^^xsd:boolean ;
    aia:registreActif "true"^^xsd:boolean .

# Une décision tracée
<votre-decision> a aiav:DecisionHautRisque ;
    aia:supervisionHumaine "true"^^xsd:boolean ;
    aia:sortieModele "Score : 0.85 / Recommandation : …" ;
    aia:scoreConfiance "0.85"^^xsd:decimal ;
    aia:explicabilite "Facteurs principaux : …"@fr ;
    prov:wasGeneratedBy <votre-systeme> ;
    prov:generatedAtTime "2026-05-22T10:00:00Z"^^xsd:dateTime .
```

---

## 4. Onglets du dashboard

| Onglet | Contenu | Article AI Act |
|--------|---------|----------------|
| **Systèmes IA** | Vos systèmes Annexe III avec statut conformité | Art. 9–15 |
| **Décisions tracées** | Historique PROV-O de toutes les décisions | Art. 12 |
| **Violations Art. 14** | Décisions sans supervision humaine | Art. 14 |
| **Datasets** | Gouvernance des données d'entraînement | Art. 10 |
| **Incidents** | Incidents sérieux et notifications autorité | Art. 73 |
| **Évaluations** | Audits de conformité et dates d'expiration | Art. 43 |

---

## 5. Export PDF

Cliquez sur **Exporter rapport PDF** dans la sidebar pour générer un rapport d'audit
complet au format PDF, incluant synthèse exécutive, violations et recommandations.

---

## 6. Validation SHACL avant chargement

```bash
# Valider votre graphe avant de le charger (recommandé)
./triplestore/shacl-validate.sh votre-graphe-aiact.ttl

# Mode strict — bloque le chargement si violations
./triplestore/shacl-validate.sh votre-graphe-aiact.ttl --strict
```

---

## 7. Support

- **Email** : support@lemondesemantique.fr
- **Documentation API** : https://lemondesemantique.fr/api-pro/docs
- **AI Act (texte officiel)** : https://eur-lex.europa.eu/legal-content/FR/TXT/?uri=CELEX:32024R1689