# Hackathon : AI Jump & recherche d'emploi

## Le défi

Pendant ce hackathon, tu vas concevoir et développer une application autour de l'emploi utilisant de l'intelligence artificielle.

Ton but est de faciliter la recherche d'emploi, mais le sujet précis est libre.

Ton projet peut par exemple concerner :

* la recherche d'emploi
* la découverte de métiers
* les compétences
* l'analyse d'offres
* l'orientation ou la reconversion
* la préparation d'une candidature
* la compréhension du marché de l'emploi
* ou toute autre problématique liée à l'emploi

Tu dois cependant construire une véritable application : un simple chatbot ou une interface permettant uniquement d'envoyer un prompt à une IA ne sera pas suffisant.

## Les sources de données

### Les API à utiliser

Les API France Travail sont à ta disposition si elles apportent quelque chose à ton projet. Tu n'as pas à toutes les utiliser.

| API | Débit maximal annoncé | À quoi elle sert | Documentation technique |
| --- | ---: | --- | --- |
| Offres d'emploi v2 | 10 appels/s | Rechercher des offres actives par commune, métier ou contrat, puis consulter le détail d'une annonce. | [Documentation Offres d'emploi](https://francetravail.io/produits-partages/catalogue/offres-emploi?tabgroup-api=documentation) |
| Informations sur un territoire v1 | 10 appels/s | Situer un territoire en consultant sa population, ses établissements, ses salariés ou un indicateur de dynamisme. | [Documentation Informations sur un territoire](https://francetravail.io/produits-partages/catalogue/informations-territoire?tabgroup-api=documentation) |
| Marché du travail v1 | 10 appels/s | Explorer les chiffres des offres, des embauches ou des métiers en tension sur un territoire. Utile pour un tableau de bord local. | [Documentation Marché du travail](https://francetravail.io/produits-partages/catalogue/marche-travail?tabgroup-api=documentation) |
| Accès à l'emploi des demandeurs d'emploi v1 | 10 appels/s | Consulter des statistiques agrégées sur le retour à l'emploi à six mois, notamment selon le métier recherché. Ce n'est pas une prédiction individuelle. | [Documentation Accès à l'emploi](https://francetravail.io/produits-partages/catalogue/acces-emploi-demandeurs-emploi?tabgroup-api=documentation) |
| ROME 4.0 – Compétences v1 | 1 appel/s | Retrouver les libellés et codes officiels de compétences, de savoir-faire et de savoirs. | [Documentation Compétences](https://francetravail.io/produits-partages/catalogue/rome-4-0-competences?tabgroup-api=documentation) |
| ROME 4.0 – Contextes de travail v1 | 1 appel/s | Décrire un environnement de travail avec des critères comme les conditions, les horaires et les déplacements. | [Documentation Contextes de travail](https://francetravail.io/produits-partages/catalogue/rome-4-0-contextes-travail?tabgroup-api=documentation) |
| ROME 4.0 – Fiches métiers v1 | 1 appel/s | Afficher, pour un métier, les groupes de compétences et les savoirs qui figurent dans sa fiche officielle. | [Documentation Fiches métiers](https://francetravail.io/produits-partages/catalogue/rome-4-0-fiches-metiers?tabgroup-api=documentation) |
| ROME 4.0 – Métiers v1 | 1 appel/s | Identifier un métier et retrouver son libellé et sa définition à partir d'un code ROME. | [Documentation Métiers](https://francetravail.io/produits-partages/catalogue/rome-4-0-metiers?tabgroup-api=documentation) |
| ROMEO v2 | 3 appels/s | Suggérer une appellation métier, un savoir ou un savoir-faire ROME à partir d'un texte libre. La suggestion reste à vérifier. | [Documentation ROMEO](https://francetravail.io/produits-partages/catalogue/romeo?tabgroup-api=documentation) |
| ROME 4.0 – Substitutions d'entités v1 | 1 appel/s | Retrouver le code qui remplace une ancienne entrée du référentiel. Utile si tu importes des données qui contiennent des codes obsolètes. | [Documentation Substitutions d'entités](https://francetravail.io/produits-partages/catalogue/rome-4-0-substitutions-entites?tabgroup-api=documentation) |

Ces chiffres sont des **limites de débit** : tous les projets partagent les mêmes accès. Évite d'appeler ROME pour chaque offre à l'affichage d'une liste. Charge la fiche quand l'utilisateur l'ouvre et réutilise-la si les conditions de l'API le permettent. Si une API répond `429`, attends avant de réessayer et tiens compte de l'en-tête `Retry-After` s'il est fourni.

### Sources supplémentaires

- [API Géo — Communes](https://geo.api.gouv.fr/decoupage-administratif/communes), tu peux rechercher une commune par nom ou par code postal et récupérer son code INSEE. Par exemple, utilise le code INSEE `79191` pour identifier Niort dans une recherche d'offres. Le code postal `79000` n'est pas le code INSEE.
- [RSS Emploi-Territorial des Deux-Sèvres](https://www.emploi-territorial.fr/rss?search-dept=079&page=2) : des offres de la fonction publique territoriale dans les Deux-Sèvres. Utile pour ajouter une source locale ou tester un import de flux. Chaque entrée fournit notamment un titre, un lien et un résumé.
- [CSV Choisir le Service Public](https://www.data.gouv.fr/datasets/les-offres-diffusees-sur-choisir-le-service-public) : un export des offres de la fonction publique, utile pour peupler une base de test, filtrer par territoire ou travailler hors ligne. Le fichier national est volumineux, importe seulement les lignes et les colonnes dont tu as besoin.

## L'intelligence artificielle avec n8n

Une instance n8n sera mise à ta disposition. Ton application doit intégrer au moins un workflow qui appelle réellement **le modèle imposé GPT‑6 Luna**, dont l'identifiant API est **`gpt-6-luna`**.

Exemple d'architecture

![architecture](https://i.imgur.com/ywTn90F.png)

Choisis une tâche pour laquelle le modèle apporte quelque chose. Par exemple, extraire des compétences d'un texte ou structurer des notes en JSON peut être utile. Filtrer des offres, trier un tableau, valider un formulaire ou générer un PDF à partir d'un gabarit relève du code classique.

### Utilisations interdites avec l'accès OpenAI du hackathon

- Générer ou modifier des images, générer des vidéos ou du son, faire de la synthèse vocale ou transcrire de l'audio. La lecture d'un CV est autorisée.
- Lancer des agents en boucle ou appeler le modèle à chaque frappe, à chaque rafraîchissement ou avec des relances sans limite. Déclenche l'analyse sur une action explicite de l'utilisateur.

## Contraintes techniques

Ton projet devra :

* posséder un frontend et un backend
* utiliser les API imposées
* utiliser au moins un workflow n8n
* effectuer au moins un appel à `gpt-6-luna` via n8n
* ne jamais exposer de clé API dans le frontend ou dans ton dépôt Git

Tu es libre de choisir ta stack et ton architecture.

## Quelques questions à te poser

Pendant le développement, ne cherche pas seulement à "faire fonctionner l'IA".

Demande-toi :

* Pourquoi utilisons-nous une IA ici ?
* Est-ce qu'un traitement classique serait plus adapté ?
* Quelles informations envoyons-nous au modèle ?
* Que se passe-t-il si sa réponse est incorrecte ?
* Comment éviter qu'il invente des informations ?
* Que se passe-t-il si une API est indisponible ?
* Quelles données ne devons-nous surtout pas transmettre ?

## Données et confidentialité

Tu travailles dans le contexte d'une entreprise.

N'envoie donc aucune donnée confidentielle MAIF aux services utilisés pendant le hackathon.

## Livrables

À la fin du hackathon, chaque équipe devra fournir :

* le dépôt Git du projet
* un README permettant de lancer l'application
* l'export JSON du ou des workflows n8n
* un schéma simple de l'architecture

## Présentation finale

Lors de la restitution, tu devras présenter :

1. Le problème choisi : quel besoin lié à l'emploi as-tu essayé de résoudre ?
2. La démonstration : montre ton application en fonctionnement.
3. L'architecture : explique rapidement le rôle du frontend, du backend, de n8n, des API et de l'IA.
4. Ton utilisation de l'IA : pourquoi l'as-tu utilisée à cet endroit ?
5. Les limites : présente au moins un cas dans lequel ton système peut se tromper ou mal fonctionner.

