Opportunity Intelligence
Application web personnelle qui recherche automatiquement des stages et des bourses de master,
évalue leur pertinence de façon explicable, suit les candidatures, gère les documents et envoie
des alertes e-mail — sans jamais envoyer une candidature à votre place.
Principe : automatiser la recherche, l'analyse, le classement et les rappels ; la soumission
reste toujours une action humaine explicitement confirmée.
Fonctionnalités
| Domaine | Ce qui est implémenté |
|---|
| Authentification | Compte admin créé par CLI/amorçage ; inscription publique désactivable (ALLOW_REGISTRATION, adresse e-mail confirmée obligatoire), Argon2id, sessions opaques hachées, limitation de débit, réinitialisation du mot de passe par e-mail, cookie httpOnly + contrôle d'origine (CSRF) |
| Profil | Identité, nationalités, études, compétences, expériences, projets, engagements, langues (CECRL), préférences ; import de CV PDF avec écran de confirmation (rien n'est inventé ni enregistré automatiquement) |
| Documents | Espace privé (PDF, DOCX, PNG, JPEG, texte), contrôle du type réel par signature binaire, versions, notes, association aux candidatures, téléchargement par URL signée (S3) ou flux authentifié |
| Catalogue | Stages et bourses avec provenance, offres personnelles enregistrées par lien (plusieurs liens LinkedIn d'un coup, texte collé analysé par l'IA, visibles de leur seul auteur) et liste « À postuler » pour les traiter une par une, filtres serveur (type, pays, domaine, organisme, niveau, financement, échéance, éligibilité, score, statut), recherche plein texte, tri, pagination, favoris |
| Collecte | Connecteurs Greenhouse, Lever, Arbeitnow, Erasmus Mundus (EACEA), RSS ; validation, normalisation, dédoublonnage multi-niveaux, idempotence, robots.txt, limitation de débit, journal des exécutions |
| Matching | Moteur déterministe : éligibilité (eligible / ineligible / unknown), compatibilité /100 pondérée avec fiabilité, priorité explicable ; recalcul automatique |
| Candidatures | Pipeline 8 statuts (en français), Kanban / tableau / calendrier, historique, tâches, documents, relances ; confirmation humaine obligatoire avant « Envoyée » |
| Alertes | Resend (ou mode simulation), nouvelles opportunités, récapitulatif quotidien/hebdomadaire, rappels J-14/7/3/1, tâches, modifications, erreurs de collecte ; déduplication et journal |
| Tableau de bord | Indicateurs réels, échéances 7/30 j avec urgence expliquée, tâches en retard, pipeline, état des sources, collectes, e-mails, erreurs |
| Assistant IA | Facultatif (désactivé sans clé) : brouillons modifiables à partir du profil uniquement, informations manquantes signalées |
Stack
- Frontend : Next.js 16 (App Router), React 19, TypeScript strict, Tailwind CSS v4, React Hook Form + Zod, SWR, Recharts, lucide-react — design system néo-brutaliste maison (
apps/web/src/components/ui).
- Backend : Python 3.12, FastAPI, Pydantic v2, SQLAlchemy 2.1 (psycopg 3), Alembic, HTTPX, Pytest.
- Base : PostgreSQL (Neon en production).
- Hébergement : Vercel (frontend), Render (API + Cron Jobs), Resend (e-mails).
.
├── apps/web/ # Frontend Next.js (BFF : /api/auth/*, /api/backend/*)
│ ├── src/app/ # Pages (App Router) et route handlers
│ ├── src/components/ # Design system + layout
│ ├── src/features/ # Écrans par domaine
│ ├── src/lib/ # Client API, formatage, types, couche serveur
│ ├── src/i18n/ # Dictionnaire (fr), prêt pour l'anglais
│ ├── tests/unit/ # Vitest + Testing Library
│ └── e2e/ # Playwright
├── backend/
│ ├── app/api/v1/ # Routes REST /api/v1
│ ├── app/core/ # Config, sécurité, erreurs, logs, temps, texte
│ ├── app/db/ # Session SQLAlchemy, verrous de jobs
│ ├── app/models/ # Modèles (19 tables)
│ ├── app/schemas/ # Schémas Pydantic
│ ├── app/services/ # Logique métier
│ ├── app/workers/ # Connecteurs, ingestion, matching, notifications
│ ├── app/jobs/ # Commandes planifiées (python -m app.jobs.*)
│ ├── migrations/ # Alembic
│ └── tests/ # Pytest (PostgreSQL réel) + jeux de test
├── docs/ # Documentation technique
├── scripts/e2e.sh # Tests end-to-end locaux/CI
├── render.yaml # Blueprint Render (API + cron jobs)
└── .env.example # Variables (valeurs fictives)
Prérequis
- Python 3.12, Node.js ≥ 20.9 (22 recommandé), PostgreSQL ≥ 14 (local) ou une base Neon.
Installation locale
# 1. Base de données locale
createdb oi_dev && createdb oi_test
# 2. Backend
cd backend
python3.12 -m venv .venv
.venv/bin/pip install -r requirements-dev.txt
cp ../.env.example .env # puis renseigner DATABASE_URL et SECRET_KEY
.venv/bin/alembic upgrade head
.venv/bin/python -m app.cli seed-sources
.venv/bin/python -m app.cli create-admin --email [email protected] # mot de passe demandé (12 car. min.)
.venv/bin/uvicorn app.main:app --reload --port 8000 # docs : http://localhost:8000/docs
# 3. Frontend (autre terminal)
cd apps/web
npm ci
cp .env.example .env.local
npm run dev # http://localhost:3000
Commandes utiles
| Action | Commande |
|---|
| Tests backend | cd backend && .venv/bin/pytest (base oi_test ou TEST_DATABASE_URL) |
| Lint backend | cd backend && .venv/bin/ruff check app tests && .venv/bin/ruff format --check app tests |
| Tests frontend | cd apps/web && npm test |
| Lint / types frontend | cd apps/web && npm run lint && npm run typecheck |
| Build frontend | cd apps/web && npm run build |
| End-to-end | npm --prefix apps/web run build && bash scripts/e2e.sh (base locale oi_e2e) |
| Nouvelle migration | cd backend && .venv/bin/alembic revision --autogenerate -m "message" |
| Appliquer les migrations | cd backend && .venv/bin/alembic upgrade head |
| Tester une source (à blanc) | cd backend && .venv/bin/python -m app.cli test-source --key greenhouse-internships |
| Lancer une collecte | cd backend && .venv/bin/python -m app.jobs.collect_opportunities |
| Vérifier la configuration | cd backend && .venv/bin/python -m app.cli check-config |
Déploiement
Voir docs/DEPLOYMENT.md : Neon (base), Render (Blueprint render.yaml), Vercel
(racine apps/web), Resend. Variables : docs/ENVIRONMENT.md.
Documentation
Architecture · Base de données · API ·
Déploiement · Environnement · Sécurité ·
Tests · Connecteurs · Exploitation ·
État d'avancement
Limites connues
- Les connecteurs n'ont pas pu être vérifiés contre les sources réelles depuis l'environnement de
développement (réseau sortant restreint) : ils sont testés sur des jeux de données reproduisant les formats
documentés. Chaque source est désactivée par défaut et se vérifie en un clic (« Tester ») une fois déployée.
- Pas d'OCR : un CV scanné (image) ne produit aucune suggestion.
- Téléversement limité à 4 Mo (limite des fonctions Vercel traversées par la passerelle).
- Le plan gratuit Render met l'API en veille après inactivité (premier appel lent).
- Interface en français uniquement (architecture i18n prête pour l'anglais).
