Skip to content
Projets

Fighter90/career-ops-ui has 100 GitHub stars and 26 forks. GitHot measured 0 stars in 24 hours and +4 in 7 days. Last checked 2026-11-17 23:26 UTC. Last push 2026-11-14.

Comment ces chiffres sont mesurés

Progression mesurée des étoiles

in 24h
0
in 7 days
+4
in 15 days
Mise à jour retardée
in 1 month
Mise à jour retardée

Variations nettes sur des périodes qui se chevauchent, pas des totaux quotidiens. Les mesures absentes restent vides. Les étoiles indiquent l’intérêt, pas la qualité.

À propos

Clean, docs-style web UI for the career-ops AI job-search pipeline. Search ATS adapters (Greenhouse/Ashby/Lever) + regional portals (hh.ru/Habr Career), evaluate JDs, track applications — all from the browser.

Auto-hébergement

README.fr.md

Original

career-ops-ui

Une interface web épurée, façon documentation, pour le pipeline de recherche d'emploi IA career-ops. Cherchez, évaluez, approfondissez, postulez et suivez chaque offre depuis un seul onglet de navigateur — au lieu de jongler entre Claude Code, des terminaux et des fichiers markdown.

🇬🇧 English | 🇪🇸 Español | 🇧🇷 Português (Brasil) | 🇰🇷 한국어 | 🇯🇵 日本語 | 🇷🇺 Русский | 🇨🇳 简体中文 | 🇹🇼 繁體中文 | 🇫🇷 Français | 🇵🇱 Polski | 🇺🇦 Українська | 🇩🇰 Dansk | 🇸🇦 العربية | 🇩🇪 Deutsch | 🇮🇹 Italiano | 🇹🇷 Türkçe | 🇮🇳 हिन्दी | 🇱🇰 தமிழ் | 🇻🇳 Tiếng Việt

Interface non officielle — sans affiliation ni approbation de career-ops / santifer.

tests e2e playwright node license release agentic patterns

career-ops-ui - The open-source job search command center | Product Hunt

🆕 Dernière version — v1.271.2 — section pipeline de /api/map/jobs plafonnée aux 1000 lignes les plus récentes : le vrai compte dans pipelineTotal, ?pipeline=all restaure tout ; l'allègement du tracker est sorti en v1.271.1. Tests 7920 → 7922.

Précédente — v1.271.1 — /api/map/jobs allégé par défaut (CAR-249) : le chargement de page le plus lourd de la production (4.6 MB) n'expédie désormais que les 11 champs que la carte consomme ; ?full=1 restaure toutes les colonnes ; /api/pipeline délibérément laissée intacte. Tests 7918 → 7920.

Works with 18 LLM providers — Anthropic, OpenAI, Gemini, Qwen, OpenRouter, GitHub, DeepSeek, Kimi, MiniMax, Mistral, Ollama and more

📜 Historique complet des versions : CHANGELOG.fr.md.

career-ops-ui — Centre de commande

▶ Voir l'aperçu

🗺️ Nouveau : toutes les offres sur une carte

Résultats de scan, pipeline et suivi sur une seule carte du monde (#/map) : voyez où se concentrent les offres et quelles villes valent un déménagement. Un marqueur plein correspond à votre note d'évaluation, un anneau à l'adéquation du titre avant évaluation ; les offres sont placées à l'adresse de l'entreprise lorsqu'elle est connue, sinon au centre de la ville (géocodage OpenStreetMap gratuit, sans clé).

career-ops-ui — Carte des offres

À propos de career-ops

career-ops est un système de recherche d'emploi open-source qui s'exécute sous forme de commandes slash dans n'importe quel CLI de codage IA (Claude Code, Cursor, Codex, OpenCode, Antigravity CLI, Grok Build CLI, Qwen Code, Kimi, GitHub Copilot CLI, Gemini CLI (legacy) — d'autres CLI compatibles Claude fonctionnent aussi via la même surface de commandes slash). Indépendant du modèle. Il évalue chaque offre par rapport à votre CV avec une grille à cinq dimensions plus un score global holistique de 0,0 à 5,0, génère des CV PDF sur mesure, et suit chaque candidature localement — pas de comptes cloud, pas de télémétrie, pas de soumission automatique.

Ce dépôt (career-ops-ui) est une interface web soignée par-dessus. Le CLI continue de gérer le remplissage de formulaires (via Playwright MCP) et les modes en commandes slash ; la SPA vous offre une surface navigateur de style CRM sur les mêmes fichiers cv.md / data/applications.md / reports/. Les deux partagent les mêmes données.

Seuils d'action par score (depuis career-ops.org/docs) :

Score Étape suivante
≥ 4.5 /career-ops apply — forte adéquation, foncez tout de suite
4.0 – 4.4 postulez, ou /career-ops contacto pour une intro chaleureuse
3.5 – 3.9 /career-ops deep — recherchez d'abord
< 3.5 passez sauf raison précise

Guides canoniques sur career-ops.org/docs :

Le Manifeste CareerOps

career-ops est la première implémentation de référence du Manifeste CareerOps — la pratique consistant à mener une recherche d'emploi avec des preuves, de la discipline, et des outils du côté du candidat de la table. Lisez-le. S'il exprime ce en quoi vous croyez, signez-le — votre signature devient un commit. L'application y renvoie depuis le pied de page de la barre latérale.

L'application elle-même est elle aussi construite avec des agents de codage, en suivant Agentic Coding Design Patterns (édition russe) — des garde-fous exécutables, des workflows packagés, un dictionnaire du domaine, des ADR et des évaluations de workflows. La page wiki Agentic Practices audite les pratiques réellement en place.

Lancer et initialiser en une commande

Important — career-ops-ui est un tableau de bord au-dessus de Fighter90/career-ops. Il s'exécute à l'intérieur d'un projet career-ops sous career-ops/web-ui/ et lit vos cv.md, config/, data/ depuis le dossier parent via ../. Il ne fonctionne pas de manière autonome — vous avez également besoin du dépôt parent career-ops. Ne le clonez pas seul et ne lancez pas init ; utilisez l'une des deux options ci-dessous.

Option 1 — un seul curl (recommandé : configure tout)

curl -fsSL https://raw.githubusercontent.com/Fighter90/career-ops-ui/main/bin/setup.sh | bash

Clone les deux dépôts, organise la structure career-ops/web-ui/, installe les dépendances, lance le doctor et démarre le serveur sur http://127.0.0.1:4317 — puis ouvre le tableau de bord.

Option 2 — ajouter l'UI à un projet career-ops existant

Si vous avez déjà career-ops configuré et souhaitez seulement le tableau de bord, clonez l'UI à l'intérieur de celui-ci en tant que web-ui :

cd career-ops                                                   # ← votre projet career-ops existant
git clone https://github.com/Fighter90/career-ops-ui.git web-ui
cd web-ui
npm install
npx career-ops-ui init        # interactive: pick LLM provider + paste its key → parent career-ops/.env

La structure web-ui/ imbriquée est précisément ce qui permet à l'UI de résoudre vos ../cv.md, ../config/, ../data/. Exécutez npm link une fois si vous préférez taper career-ops-ui <verb> au lieu de npx career-ops-ui <verb>.

Les verbes CLI

career-ops-ui setup    # bootstrap: install deps → doctor → run (SKIP_START=1 to stop before run)
career-ops-ui init     # pick LLM provider + paste its key (interactive)
career-ops-ui doctor   # verify Node / project / keys / Playwright (exit 0 ⇔ all required green)
career-ops-ui run      # launch the server at http://127.0.0.1:4317
career-ops-ui open     # open + RAISE the dashboard tab in your browser
career-ops-ui help     # list every verb

Préfixez avec npx (ex. npx career-ops-ui run) si vous n'avez pas exécuté npm link. Après setup/run l'onglet s'ouvre et est ramené au premier plan automatiquement ; définissez NO_OPEN=1 pour désactiver l'ouverture automatique (headless / CI).

Choisir votre fournisseur LLM

init est l'assistant de fournisseur — choisissez Claude / Claude Code (ANTHROPIC_API_KEY), Gemini / Gemini CLI (GEMINI_API_KEY), Codex / OpenCode CLI (OPENAI_API_KEY), ou Auto (repli Anthropic → Gemini). Les clés sont saisies avec l'écho supprimé et écrites dans le career-ops/.env parent via le même chemin validé qu'utilise l'onglet clés-API de #/config. Forme non interactive pour la CI :

career-ops-ui init --provider claude --anthropic-key sk-ant-… --yes
career-ops-ui init --provider gemini --gemini-key …          --yes
career-ops-ui init --provider auto   --openai-key sk-…       --yes

Ou définissez-le manuellement : echo "ANTHROPIC_API_KEY=sk-ant-…" >> career-ops/.env. Le fournisseur définit LLM_PROVIDER (auto | claude | gemini) ; changez-le à tout moment depuis #/config → clés API sans redémarrer.

Dépannage de init

Si career-ops-ui init échoue ou si la commande est introuvable (fréquent juste après un git pull) :

cd career-ops/web-ui
npm install
npx career-ops-ui init        # npx runs the local bin even without `npm link`

Assurez-vous :

  • D'exécuter depuis l'intérieur de career-ops/web-ui/ — pas depuis un clone autonome career-ops-ui/.
  • Que le dossier parent career-ops/ existe et contient cv.md et config/. Si vous avez cloné career-ops-ui seul, déplacez-le (ou re-clonez-le) pour qu'il se trouve à career-ops/web-ui/ — ou exécutez simplement le curl de l'option 1, qui organise la structure pour vous.
  • career-ops-ui doctor (ou npx career-ops-ui doctor) affiche exactement ce qui manque.

Pourquoi ?

career-ops est un puissant système de recherche d'emploi piloté par Claude Code : collez une offre → obtenez un score d'adéquation 0-5, un PDF optimisé ATS, et une entrée de suivi. Il fonctionne très bien dans Claude Code, mais les données vivent à travers cv.md, data/applications.md, reports/*.md, data/pipeline.md, portals.yml, config/profile.yml — faciles à perdre, difficiles à survoler.

career-ops-ui pose une UI soignée par-dessus :

  • Auto-pipeline — collez une URL d'offre sur #/auto, cliquez une fois : valider → récupérer → évaluer → enregistrer le rapport → ajouter au tracker, avec un stepper accessible en direct et des liens profonds vers les artefacts.
  • Parcourez le tracker, les rapports et le pipeline comme un CRM.
  • Déclenchez des scans (Greenhouse / Ashby / Lever / Workable / SmartRecruiters / Workday et hh.ru / Habr Career / Trudvsem / GetMatch / GeekJob) et regardez les journaux SSE en direct.
  • Évaluez une offre en live via Anthropic (préféré) ou Gemini, ou obtenez un prompt à copier-coller pour Claude Code si aucune clé API n'est définie.
  • Recherche approfondie d'entreprises en live via le SDK Anthropic, avec les fichiers cv / profil / mode inlinés automatiquement.
  • Éditez cv.md avec un aperçu markdown côte à côte et une désinfection XSS côté serveur.
  • Maintenez le système : doctor, verify, normalize, dedup, merge — un clic chacun.
  • Multi-CLI : piloté à l'identique depuis Claude Code, Cursor, Codex, Cursor, Aider ou Gemini CLI — les shims CLAUDE.md / AGENTS.md / GEMINI.md pointent vers une source unique de vérité.

Ce sont de pures additions : rien dans career-ops/ ne change. Toutes vos personnalisations restent les vôtres.


Démarrage rapide

1. Installez d'abord career-ops

git clone https://github.com/Fighter90/career-ops.git
cd career-ops

Suivez l'onboarding career-ops pour que cv.md, config/profile.yml et portals.yml existent.

2. Déposez career-ops-ui à l'intérieur

git clone https://github.com/Fighter90/career-ops-ui.git web-ui

Votre arborescence ressemble maintenant à :

career-ops/
├─ cv.md
├─ portals.yml
├─ config/
├─ data/
├─ modes/
├─ reports/
├─ scan.mjs … doctor.mjs … (etc)
└─ web-ui/                 ← this repo
   ├─ bin/start.sh
   ├─ package.json
   ├─ server/
   ├─ public/
   └─ tests/

3. Lancez

bash web-ui/bin/start.sh

Le script :

  1. Vérifie Node ≥ 18.
  2. npm install (uniquement au premier lancement, trois dépendances — Express + js-yaml + multer).
  3. Démarre le serveur Express sur 127.0.0.1:4317.
  4. Ouvre http://127.0.0.1:4317/ dans votre navigateur par défaut.

Port / hôte personnalisés :

PORT=8080 bash web-ui/bin/start.sh
HOST=0.0.0.0 PORT=4317 bash web-ui/bin/start.sh   # expose on LAN

Si vous avez cloné le dépôt ailleurs (pas comme career-ops/web-ui), pointez vers career-ops via une variable d'environnement :

CAREER_OPS_ROOT=/path/to/career-ops bash bin/start.sh

Premier lancement — état propre

career-ops/data/pipeline.md est livré avec deux URL de fixture QA (example.com/qa-fixture-*) pour que la suite de tests s'exécute de façon hermétique. Sur un clone neuf, le Pipeline affichera 2 pending — ce ne sont pas de vraies offres. Purgez-les avant votre premier scan :

make clean-test-fixtures        # removes pipeline.md fixture rows + qa-fixture-* applications.md rows
npm start

Ouvrez http://127.0.0.1:4317. Le compteur du Pipeline doit maintenant indiquer 0 pending. Le Makefile est idempotent — le relancer sur une arborescence propre est un no-op.


Prérequis

Node.js ≥ 18 (utilise les fetch, node:test natifs)
career-ops Cloné et configuré — voir ci-dessus
Optionnel GEMINI_API_KEY dans le .env du projet parent (modèle du palier gratuit gemini-2.0-flash) pour l'évaluation d'offre en un clic. Sinon l'UI renvoie un prompt à copier-coller pour Claude.
Optionnel Lancez depuis une IP / un VPN russe si hh.ru renvoie 403. Habr Career fonctionne depuis n'importe quelle IP.
Optionnel Playwright (déjà une dépendance transitive de career-ops) pour la suite de tests e2e.

Ce que vous obtenez — par page

Page Ce qu'elle fait
Dashboard Compteurs agrégés (candidatures / pipeline / rapports), score moyen, répartition par statut, 5 dernières candidatures + dernier rapport.
Scan 🌐 Bouton Scan unique — exécute chaque source activée d'un coup (Greenhouse / Ashby / Lever / Workable / SmartRecruiters / Workday pour l'EN, hh.ru + Habr Career + Trudvsem + GetMatch + GeekJob pour le RU). Journal SSE en direct + tableau de résultats cliquable avec lieu / badge Remote-Hybrid / drapeau de relocalisation / salaire / filtres de source et puces dynamiques de stack / niveau / mot-clé. La carte Active-Companies liste chaque site suivi avec sa santé d'API.
Pipeline CRUD sur data/pipeline.md. Proxy d'aperçu côté serveur (anti-SSRF, validation de redirection par saut, plafond de corps de 8 Ko). Sautez directement d'une URL à l'évaluation.
Evaluate Collez l'offre → Anthropic d'abord (préféré quand les deux clés sont présentes), puis Gemini, puis repli prompt manuel. La voie Anthropic inline cv / profil / _shared.md / oferta.md automatiquement (REVIEW-A1). Sauvegarde de l'offre dans jds/ optionnelle.
Deep research Même chaîne de repli qu'Evaluate. L'Anthropic live renvoie ~10-30 Ko de markdown ancré enregistré dans interview-prep/<company>-<role>.md.
Modes 7 pages de mode génériques (/#/project, /#/training, /#/followup, /#/batch, /#/contacto, /#/interview-prep, /#/patterns) avec le même repli Anthropic / Gemini / manuel.
Apply helper Génère une checklist de soumission ; le remplissage réel via Playwright reste dans /career-ops apply dans Claude Code.
Tracker Tableau filtrable sur data/applications.md (statut, score, texte libre). normalize-statuses.mjs / dedup-tracker.mjs / merge-tracker.mjs en un clic. Les échappements de barre + retour ligne sont conformes GFM — des noms comme "Acme | Co" font l'aller-retour sans perte.
Reports Parcourez et lisez chaque rapport sous reports/ avec en-tête analysé (Score / Légitimité / URL).
CV Éditeur markdown live pour cv.md avec aperçu côte à côte + cv-sync-check.mjs en un clic + 📁 Import CV. Désinfection XSS côté serveur à la sauvegarde (<script>, javascript:, gestionnaires on*=).
Profile Vue en lecture seule de config/profile.yml + archétypes — résumé adapté à l'UI.
App settings Éditeur dans l'UI pour les clés .env parent : ANTHROPIC_API_KEY, GEMINI_API_KEY, surcharges de modèle, port / hôte. Secrets masqués à la lecture.
Health Toutes les vérifications de config en badges OK / OPTIONAL / FAIL + boutons pour lancer doctor.mjs et verify-pipeline.mjs.
Help Guide utilisateur Markdown dans l'app (/#/help), localisé pour les 19 langues prises en charge (en / es / fr / pt-BR / ko-KR / ja / ru / zh-CN / zh-TW / pl / uk / da / ar / de / it / tr / hi / ta / vi).
Activity log Journal d'audit de chaque requête modifiant l'état (écritures, exécutions, scans). Secrets caviardés.
Notifications 🔔 (v1.58.34 / v1.58.35) Cloche dans la barre du haut avec badge rouge de non-lus. Cliquez pour faire glisser un tiroir listant les 50 derniers toasts (par onglet, par session) — Success / Error / Info-progress, chacun avec un horodatage localisé, le message humain, et tout postfixe (METHOD /path · HTTP NNN) rangé dans un <details>. L'aide §18 documente chaque catégorie. Le tiroir s'ouvre uniquement au clic sur la cloche (ou clavier Entrée / Espace) ; se ferme via ×, Échap, ou re-clic sur la cloche.
Tâches de carrière #/tasks — un kanban personnel pour votre propre travail de carrière (préparation d'entretiens, apprentissage, réseau) sous Croissance, séparé du tracker de candidatures : colonnes Backlog / In Progress / Done où glisser EST le changement de statut (un seul appel d'API canonique, optimiste avec retour arrière), clavier ←/→ + Entrée, sélecteur de statut par carte sur mobile, ajout rapide par colonne et fenêtre de détails (notes / priorité / étiquettes). Stockage local d'abord dans data/career-tasks.json.

Raccourcis clavier globaux :

  • Ctrl+K / Cmd+K — focalise la recherche globale. L'indice du pied de page s'adapte par plateforme (⌘K sur macOS/iOS, Ctrl+K ailleurs) avec le verbe localisé (v1.58.20).
  • Coller une URL dans la recherche globale l'ajoute automatiquement au pipeline.
  • Échap — ferme toute modale ouverte ou le tiroir de notifications (v1.58.34).

Scan

Scan de portails sans coût en tokens qui renvoie réellement des offres. Un bouton 🌐 Scan dans l'UI exécute chaque source configurée en une seule passe :

  • Greenhouse / Ashby / Lever / Workable / SmartRecruiters / Workday — boards-api public pour chaque entreprise de portals.yml::tracked_companies avec un pattern ATS reconnaissable. La liste fournie couvre Stripe, GitLab, Vercel, Cloudflare, Datadog, Discord, Elastic, Grafana Labs, CockroachDB, Fastly, Twilio, Coinbase, Reddit, Robinhood, Affirm, Lyft, Linear, Supabase, PostHog, Ramp, Modal Labs, Railway, Browserbase, JetBrains — étendez ou réduisez librement.
  • Tableaux RSS — tout tableau d'offres d'emploi exposant un flux RSS/Atom (LaraJobs, WeWorkRemotely, RemoteOK, golangprojects, …). Ajoutez provider: rss et l'URL du flux dans portals.yml — aucune modification du code nécessaire.
  • Tableaux agrégateurs (v1.75.0) — sept sources couvrant tout un board / pilotées par config au-delà des ATS par entreprise : RemoteOK / Remotive / Working Nomads (flux remote couvrant tout le board, à sélectionner avec provider: remoteok|remotive|workingnomads) et IBM / Arbeitsagentur / Glints / Jobstreet · SEEK (pilotés par config, chacun lisant un bloc <provider>: par entrée). Voir docs/portals-examples.md pour des entrées tracked_companies à copier-coller. Ils exécutent le même flux title_filter / location_filter / content_filter + déduplication + ajout au pipeline que toute autre source.
  • Canaux Telegram (v1.228.0) — n'importe quel canal public, listé dans un bloc telegram_channels: et lu depuis son aperçu t.me/s/<canal> : sans jeton de bot ni clé d'API. Telegram ne publie pas de RSS et la Bot API ne lit pas un canal que votre bot n'administre pas — l'aperçu est la seule voie. Une publication est de la prose, pas une fiche de poste : le titre vient de la première ligne substantielle, l'entreprise et le lieu uniquement d'étiquettes explicites, et séparer les vraies offres des publicités revient à votre title_filter.
  • hh.ru — scraping du HTML de hh.ru/search/vacancy. Fonctionne depuis n'importe quelle IP, sans clé ni proxy. (L'API JSON api.hh.ru n'est plus utilisée : elle renvoie désormais 403 à tout client programmatique quels que soient l'IP/User-Agent ; le site sert des résultats complets à tout client de type navigateur, comme Habr Career.)
  • Habr Career — scraping HTML de career.habr.com/vacancies. Fonctionne depuis n'importe quelle IP, sans auth.

Adaptateur RSS

Pointez le scanner vers n'importe quel tableau basé sur RSS en ajoutant une entrée avec provider: rss et la clé rss: (ou feed_url:) dans portals.yml :

tracked_companies:
  - name: LaraJobs
    provider: rss
    rss: https://larajobs.com/feed
    enabled: true
  - name: WeWorkRemotely
    provider: rss
    rss: https://weworkremotely.com/remote-jobs.rss
    enabled: true

L'adaptateur analyse les blocs <item> avec un petit parseur basé sur des expressions régulières (aucune bibliothèque XML nécessaire). Il extrait title, link (→ url), pubDate (→ date) et description (→ snippet, balises HTML supprimées). Le travail à distance est détecté par /remote|anywhere/i dans le titre ou la description ; le nom de l'entreprise est extrait de dc:creator, du pattern « Entreprise — Poste » dans le titre, ou du nom d'hôte du flux. Le même flux normalisation → filtrage → déduplification → ajout au pipeline s'applique comme pour les adaptateurs ATS.

Toutes les sources passent par le même pipeline : normaliser → filtrer (title_filter.positive / title_filter.negative) → dédupliquer contre data/scan-history.tsv + data/pipeline.md + data/applications.md → ajouter à data/pipeline.md → enregistrer l'ensemble complet des résultats dans data/last-scan.json pour le tableau filtrable de l'UI.

Configurez via portals.yml :

title_filter:
  positive: [backend, engineer, senior, tech lead, golang, php]
  negative: [junior, intern, frontend, ios, android]
tracked_companies:
  - { name: Stripe, enabled: true, careers_url: https://job-boards.greenhouse.io/stripe }
  - { name: Linear, enabled: true, careers_url: https://jobs.ashbyhq.com/linear }
  # ...
russian_portals:
  sources: ["hh", "habr"]   # one or both
  area: 113                  # 1=Moscow, 2=SPb, 113=Russia, 1001=remote
  per_page: 50
  only_remote: false
  queries: ["Senior PHP", "Senior Go", "Tech Lead"]

Toutes les sources passent par un endpoint SSE unique : /api/stream/scan?source=ats|regional|both. Le bouton 🌐 Scan appelle source=both pour que chaque adaptateur (Greenhouse / Ashby / Lever / Workable / SmartRecruiters / Workday + hh.ru + Habr Career + Trudvsem + GetMatch + GeekJob) tourne dans une seule connexion. Respecte AbortSignal à la déconnexion du client — pas de fetch orphelin.


Architecture

career-ops-ui/
├─ CLAUDE.md                 # project-level agent instructions (canonical)
├─ AGENTS.md                 # Codex / Aider / generic CLI shim → CLAUDE.md
├─ GEMINI.md                 # Gemini CLI shim → CLAUDE.md
├─ .aiignore                 # exclusion list for AI tools
├─ .claude/                  # Claude Code agent config
│  ├─ agents/                # 3 project-specific subagents (route, view, test isolation)
│  └─ commands/               # slash-command stubs
├─ bin/start.sh              # one-shot launcher (Node check → npm install → server → open browser)
├─ package.json              # 2 runtime deps: express, js-yaml
├─ server/
│  ├─ index.mjs              # ~130 LOC orchestrator: middleware + 37 register<Topic>Routes(app) calls + SPA catch-all
│  └─ lib/
│     ├─ paths.mjs           # absolute paths to career-ops files (CAREER_OPS_ROOT aware)
│     ├─ parsers.mjs         # markdown / pipeline / report parsers (GFM-compliant pipe escapes)
│     ├─ runner.mjs          # runNodeScript() + streamNodeScript() with SIGTERM→SIGKILL escalation + 30 min cap
│     ├─ security.mjs        # isValidJobUrl, stripDangerousMarkdown, sanitizeJobDescription, isPubliclyExposed
│     ├─ prompts.mjs         # bundleProjectContext, buildEvaluationPrompt, buildDeepPrompt, buildModePrompt
│     ├─ store.mjs           # safeReadApps/Pipeline/Reports, checkProfileCustomized, ensureRussianPortalsDefaults
│     ├─ anthropic.mjs       # minimal Anthropic SDK adapter (runAnthropic, hasAnthropicKey, hasGeminiKey)
│     ├─ env-config.mjs      # .env round-trip with secret masking + validation
│     ├─ activity-log.mjs    # JSONL audit trail middleware (secrets redacted)
│     ├─ dotenv.mjs          # tiny dotenv loader
│     ├─ en-scanner.mjs      # in-process Greenhouse/Ashby/Lever orchestrator (AbortSignal aware)
│     ├─ ru-scanner.mjs      # in-process hh.ru + Habr orchestrator (AbortSignal aware)
│     ├─ sources/
│     │  ├─ greenhouse.mjs   # boards-api.greenhouse.io client
│     │  ├─ ashby.mjs        # api.ashbyhq.com client
│     │  ├─ lever.mjs        # api.lever.co client
│     │  ├─ hh.mjs           # api.hh.ru client (UA-aware)
│     │  └─ habr.mjs         # career.habr.com HTML parser (no cheerio, regex only)
│     └─ routes/             # 39 route modules — one per topic (P-2)
│        ├─ activity.mjs     # /api/activity
│        ├─ config.mjs       # /api/config (parent .env round-trip)
│        ├─ content.mjs      # /api/cv, /api/profile, /api/portals, /api/modes
│        ├─ health.mjs       # /api/health, /api/dashboard
│        ├─ help.mjs         # /api/help/:lang
│        ├─ jds.mjs          # /api/jds CRUD
│        ├─ llm.mjs          # /api/evaluate, /api/deep, /api/mode/:slug, /api/apply-helper, /api/interview-prep*
│        ├─ pipeline.mjs     # /api/pipeline + SSRF-safe preview proxy
│        ├─ reports.mjs      # /api/reports
│        ├─ runners.mjs      # /api/run/* + /api/stream/{scan,liveness,pdf} + /api/output/pdfs
│        ├─ scan.mjs         # /api/stream/scan-{ru,en} + /api/scan-results
│        └─ tracker.mjs      # /api/tracker
├─ public/                   # static SPA — no build step
│  ├─ index.html
│  ├─ css/app.css            # design tokens (docs-style palette)
│  └─ js/
│     ├─ api.js              # fetch wrapper + connection-banner state + UI helpers + safe markdown renderer
│     ├─ router.js           # hash-based router with 404 fallback + alias support
│     ├─ app.js              # boot + global keyboard handlers + mobile sidebar drawer
│     ├─ lib/{i18n,skills}.js
│     └─ views/              # one file per page (dashboard, scan, pipeline, evaluate, deep, apply, tracker, reports, cv, settings, health, config, help, activity, mode-page)
├─ docs/                     # public reference: architecture, API, data-flows, SDD, conventions, reviews
│  ├─ PROJECT.md             # what / why / for-whom
│  ├─ ROADMAP.md             # current milestone + completed history
│  ├─ PRODUCTION-READINESS.md # honest deployment-gate assessment
│  ├─ sdd/{SDD-GUIDE,CONVENTIONS}.md
│  ├─ architecture/{OVERVIEW,SERVER,FRONTEND,API,DATA-FLOWS}.md
│  └─ reviews/REVIEW-*.md
└─ tests/                    # 7243 unit + 176 Playwright + 23/23 e2e:full + 21 e2e:smoke (baseline @ v1.267.2)
   ├─ parsers.test.mjs       # markdown / pipeline / report parsers (pure functions)
   ├─ api.test.mjs           # every endpoint, ephemeral server, no network
   ├─ {ru,en}-scanner.test.mjs   # mocked fetch
   ├─ pipeline-preview.test.mjs   # per-hop redirect validation (REVIEW-B1)
   ├─ anthropic.test.mjs     # SDK adapter + log-guard test (REVIEW-B4)
   ├─ url-validation.test.mjs    # SSRF reject sweep (FIX-M3 + M6 + M7)
   ├─ cv-xss.test.mjs        # stripDangerousMarkdown round-trip
   ├─ jd-sanitize.test.mjs   # sanitizeJobDescription
   ├─ help.test.mjs / help-ui.test.mjs    # i18n parity across all 19 locales
   ├─ playwright-smoke.mjs   # 22 browser flows (CV save, tracker, pipeline, evaluate, config, etc.)
   └─ e2e{,-comprehensive}.mjs   # full Playwright walkthrough

Pourquoi pas d'étape de build ?

Du HTML/CSS/JS vanilla garde la surface minuscule : un seul npm install de deux dépendances et vous tournez. Pas de Webpack, pas de Vite, pas de node_modules infernal. Toute l'UI fait < 30 Ko minifiée. Si vous voulez du hot-reload en développement, npm run dev utilise le --watch intégré de Node.

Développement piloté par les specs

Les changements non triviaux passent par le pipeline GSD (skills gsd-* de superpowers@claude-plugins-official) :

discuss → spec → plan → execute → verify → review

Référence publique : docs/sdd/SDD-GUIDE.md. Tous les artefacts de planification vivent sous .planning/ (gitignored). L'arborescence docs/ est le contrat public durable.


Référence API

Tous les endpoints sous /api/*. JSON entrant / JSON sortant sauf mention contraire.

Health & dashboard

Method Path Response
GET /api/health { ok, warnings, version, parentVersion, checks: [{name, ok, required, value?}] }
GET /api/dashboard { counts, avgScore, byStatus, recent, pipeline, lastReport }
GET /api/status/providers { activeProvider, activeModel, keysConfigured } — disponibilité LLM pour la bannière d'onboarding + indice de coût ⚡ (v1.55.3) ; inclut openrouter (v1.57.0)
GET /api/openrouter/models { models:[{id,name,context_length}], fallback, cached } — proxy du catalogue OpenRouter pour le menu de modèles de #/config (v1.57.0)
GET /api/activity?limit&type fin du journal d'audit data/activity.jsonl
GET /api/help/:lang guide utilisateur localisé dans l'app (repli : en.md)

App settings (aller-retour .env parent)

Method Path Purpose
GET /api/config clés env connues avec secrets masqués
POST /api/config valide + écrit le .env parent ; s'applique à process.env en place

Fichiers de données

Method Path Purpose
GET /api/tracker { rows: [parsed applications.md] }
POST /api/tracker corps { company, role, score?, status?, url?, notes?, date? } — dédup-conscient (insensible à la casse sur entreprise + poste)
GET /api/pipeline { urls: [...] }
POST /api/pipeline corps { url } → ajoute à data/pipeline.md avec dédup + isValidJobUrl
GET /api/pipeline/preview?url=… proxy de fetch côté serveur (vérif SSRF par saut, ≤3 redirections, plafond 8 Ko)
DELETE /api/pipeline?url=… retire une URL
GET /api/reports liste analysée de reports/*.md
GET /api/reports/:slug markdown complet + en-tête analysé
GET /api/jds liste des fichiers d'offres enregistrés
GET /api/jds/:name text/plain — offre brute
POST /api/jds corps { text, slug? } → enregistre dans jds/
DELETE /api/jds/:name unlink (suffixe .txt requis)
GET /api/cv { markdown }
PUT /api/cv corps { markdown } → écrit cv.md (XSS retiré, ≤1 Mo)
GET /api/profile { profile: yaml-parsed, raw: text }
GET /api/portals { portals: yaml-parsed, raw: text }
GET /api/modes liste des fichiers de mode
GET /api/modes/:name text/plain — prompt de mode brut
GET /api/output/pdfs liste des PDF générés
GET /api/output/pdfs/:name téléchargement (Content-Disposition: attachment)
GET /api/interview-prep liste des fichiers de recherche approfondie enregistrés
GET /api/interview-prep/:name { name, markdown }
DELETE /api/interview-prep/:name unlink (suffixe .md requis)

Lanceurs de scripts (bufferisés, one-shot)

Method Path Wraps
POST /api/run/doctor node doctor.mjs
POST /api/run/verify node verify-pipeline.mjs
POST /api/run/normalize node normalize-statuses.mjs
POST /api/run/dedup node dedup-tracker.mjs
POST /api/run/merge node merge-tracker.mjs
POST /api/run/sync-check node cv-sync-check.mjs

Toutes les exécutions bufferisées plafonnent à 60 s ; escalade SIGTERM → SIGKILL après un délai de grâce de 5 s.

Flux (SSE)

Method Path Streams
GET /api/stream/scan node scan.mjs legacy (sous-processus)
GET /api/stream/scan?source=ats|regional|both scanner consolidé en-process SSE — query : dryRun=1, company=… (ATS uniquement).
GET /api/stream/liveness node check-liveness.mjs
GET /api/stream/pdf node generate-pdf.mjs

Types d'événements SSE :

event: start    data: { script, args?, writeFiles? }
event: log      data: { stream: "stdout"|"stderr", line: string }
event: done     data: { code, counts?, errors? }
event: error    data: { message }

Endpoints LLM (Anthropic d'abord → Gemini → repli manuel)

Method Path Purpose
POST /api/evaluate corps { jd, save? } → évaluation d'offre (sections A–G selon oferta.md)
POST /api/evaluate/test-gemini smoke check GEMINI_API_KEY
POST /api/evaluate/test-anthropic smoke check ANTHROPIC_API_KEY
POST /api/deep corps { company, role?, run? } → prompt de recherche approfondie ou markdown ancré live
POST /api/mode/:slug lanceur de mode générique ; liste blanche : batch, contacto, followup, interview-prep, patterns, project, training
POST /api/apply-helper corps { url, jd? } → checklist de candidature
GET /api/scan-results { en: {when, fresh[], filtered[], errors[]}, ru: { ... } } — dernier scan
GET /api/scan/regional/config config effective du scanner régional (queries, négatifs, sources).

Quand run: true est défini sur /api/deep ou /api/mode/:slug, le serveur préfère Anthropic (quand les deux clés sont présentes), inline cv.md + config/profile.yml + modes/_shared.md + le modèle de mode pertinent dans un bloc <project_context>, et renvoie le markdown ancré du modèle directement. Plafond souple : 200 Ko sur le prompt assemblé — le dépassement renvoie 413.


Tests

npm test                       # 7243 unit/integration tests
npm run test:e2e               # 21 smoke e2e (boots own server)
npm run test:e2e:full          # 23 comprehensive e2e
npm run test:e2e:browser       # 176 Playwright browser (smoke + full-cycle + forms + locale-sweep ×19 + theme)
npm run test:coverage          # same as `npm test` plus V8 coverage
Suite Tests Quoi
node --test tests/*.test.mjs (unit + intégration) 7243 Chaque endpoint, serveur éphémère, sans réseau. 329 fichiers : parsers, scanners (mockés), runners, anthropic/openai, en-têtes de sécurité, XSS, désinfection d'offre, validation d'URL, parité i18n, + les suites de fixes UX v1.55→v1.56.
tests/e2e.mjs (smoke) 21 Playwright headless : chaque route s'affiche, flux de base.
tests/e2e-comprehensive.mjs 23 Parcours Playwright complet : 11 routes + 12 flux fonctionnels.
npm run test:e2e:browser (playwright-smoke + playwright-full-cycle + playwright-forms + playwright-locale-sweep) 176 Piloté par navigateur : rendu du dashboard, navigation, changement de langue, 404, health, aller-retour tracker, ajout pipeline + balayage URL-invalide, rapports, repli manuel d'évaluation, clés de config masquées, retrait XSS au PUT du CV, aperçu pipeline 400, SSE auto-pipeline.
Total (all four suites) 7316 0 échec, 0 flake

Couverture : ~93 % ligne / ~83 % branche via --experimental-test-coverage.

Les parsers sont des fonctions pures (sans I/O) — testées contre de vrais fragments de données de applications.md, pipeline.md et reports/*.md. Les tests d'API démarrent l'app Express sur un port éphémère et exercent chaque endpoint de bout en bout. Les tests de scanner mockent fetch pour passer même si hh.ru bloque votre IP. Le smoke navigateur Playwright tourne contre le serveur en-process et résout Playwright via le node_modules du projet parent — aucune nouvelle dépendance dans web-ui/.

La CI exécute la matrice unit + e2e + Playwright à chaque push sur main contre Node 18 / 20 / 22.


Configuration

Variables d'environnement (lues au démarrage du serveur, toutes optionnelles sauf mention) :

Var Défaut Objet
PORT 4317 Port de bind Express
HOST 127.0.0.1 Hôte de bind Express. La CSP s'attache en non-loopback ; barrière d'auth prévue pour la v2.0.0.
CAREER_OPS_ROOT .. du script Où trouver cv.md, data/, portals.yml, modes/, etc.
ANTHROPIC_API_KEY non défini Active le mode live de /api/evaluate, /api/deep, /api/mode/:slug (préféré quand les deux clés sont définies).
ANTHROPIC_MODEL claude-sonnet-4-6 Surcharge le modèle Anthropic.
GEMINI_API_KEY non défini Transmis à gemini-eval.mjs et utilisé en repli pour /api/evaluate.
GEMINI_MODEL gemini-2.0-flash Surcharge le modèle Gemini.
OPENAI_API_KEY non défini Éval live headless (3e dans l'ordre auto) + flux Codex/OpenAI CLI parent.
OPENAI_MODEL gpt-5-codex Surcharge le modèle OpenAI.
QWEN_API_KEY non défini Éval live headless via DashScope compatible OpenAI (4e dans l'ordre auto).
QWEN_MODEL qwen-max Surcharge le modèle Qwen.
OPENROUTER_API_KEY non défini Éval live headless via OpenRouter — une clé, 300+ modèles (5e / dernier dans auto).
OPENROUTER_MODEL openrouter/auto id vendor/model. Catalogue chargé en live depuis GET /api/openrouter/models.
(server uses default UA) non défini Surcharge l'User-Agent hh.ru (aide à réduire les 403 depuis des IP non-RU)

Extension portals.yml reconnue par cette UI (à ajouter à votre fichier existant dans le projet parent) :

russian_portals:
  sources: ["hh", "habr"]
  area: 113          # hh.ru area id
  per_page: 50
  only_remote: false
  queries: ["Senior PHP", "Тимлид Go", ...]

Vous pouvez aussi étendre toute entrée d'entreprise avec une URL api: explicite. Voir docs/portals-examples.md (dans ce dépôt) pour des blocs prêts à coller pour 24 entreprises vérifiées.


Notes de sécurité

  • Le serveur se lie à 127.0.0.1 par défaut — jamais exposé à Internet sans HOST=0.0.0.0 explicite.
  • Désinfection de chemin (v1.21.0) : chaque paramètre de route :name / :slug passe par sanitizePathName() dans server/lib/security.mjs — retire les non-[\w-.], supprime les séries de points en tête, réduit les séries internes, plafonne à 200 caractères, vide → 400. Remplace 10 copies de regex dupliquées qui laissaient passer ..pdf / ....md.
  • Défense anti-DNS-rebind (v1.21.0) : /api/pipeline/preview et /api/auto-pipeline passent par server/lib/safe-fetch.mjs::safeGet — une résolution DNS, connexion TCP épinglée, SNI/Host ciblés sur le hostname d'origine. Pas de seconde résolution, pas de fenêtre TOCTOU.
  • Mutex d'écriture concurrente (v1.21.0) : tracker.mjs, pipeline.mjs (POST + DELETE), et l'étape tracker de auto-pipeline.mjs enveloppent le read-modify-write dans withFileLock(path, fn) de server/lib/file-lock.mjs. Les POST concurrents ne perdent plus de lignes.
  • Rate-limit LLM (v1.21.0) : /api/evaluate, /api/deep, /api/mode/:slug, /api/auto-pipeline portent llmRateLimit de server/lib/rate-limit.mjs. No-op en loopback ; 10 req/min/IP sur HOST=0.0.0.0. Configurable via LLM_RATE_LIMIT="N/Ws". 429 + Retry-After.
  • Retrait XSS du CV (durcissement v1.22.0) : stripDangerousMarkdown est désormais conscient des entités — décode &lt;, &gt;, &#NN;, &#xHH; avant le retrait par regex pour que &lt;script&gt; et java&#115;cript: ne puissent pas contourner.
  • Les invocations de sous-processus utilisent spawn avec des tableaux d'arguments — jamais d'interpolation shell. Le runner bash utilise --noprofile --norc pour ignorer ~/.bashrc.
  • Les endpoints de streaming tuent le processus enfant à la déconnexion du client (pas de scanners orphelins).
  • Les endpoints d'écriture ne touchent que des chemins career-ops connus : data/, jds/, cv.md, config/, portals.yml, output/, reports/, interview-prep/, modes/_profile.md. Jamais ailleurs.
  • La bannière de connexion ping /api/health avec un backoff exponentiel (3 s → 6 s → 12 s → 24 s → 60 s) pendant la déconnexion et s'efface automatiquement à la reprise (v1.22.0 M-6).

Limites

Les modes entièrement pilotés par LLM (oferta, deep, contacto, apply, batch, patterns, followup) ont besoin d'un LLM pour s'exécuter réellement. L'UI résout un fournisseur selon l'ordre auto Anthropic → Gemini → OpenAI → Qwen → OpenRouter → GitHub Models → Hermes (ou ce que LLM_PROVIDER épingle) :

  1. Anthropic (préféré) — définissez ANTHROPIC_API_KEY dans le .env du projet parent. Passe par runAnthropic avec cv.md / config/profile.yml / modes/_shared.md / modèle de mode inlinés automatiquement (REVIEW-A1). Vérifié en live dès la v1.8.0 avec claude-sonnet-4-6 renvoyant 26 Ko de markdown ancré pour un appel de recherche approfondie.
  2. gemini-eval.mjs en repli — fonctionne d'emblée quand seule GEMINI_API_KEY est définie.
  3. OpenAI / Qwen / OpenRouter — clients compatibles OpenAI sans dépendance (le chemin _tailProvider()). OpenRouter (v1.57.0) est le plus flexible : une OPENROUTER_API_KEY donne accès à 300+ modèles de tous les grands labos, et le menu de modèles de #/config est rempli en live depuis GET /api/openrouter/models (proxy côté serveur, CSP-safe, repli hors-ligne curé).
  4. Prompt à copier-coller — quand aucune clé n'est définie, l'UI génère un prompt prêt formaté pour Claude Code / ChatGPT / Gemini Web.

Le flux de remplissage de formulaire Playwright existant dans /career-ops apply au sein de Claude Code reste le seul moyen de vraiment remplir les formulaires automatiquement — l'Apply helper de l'UI génère une checklist à la place.

Pour l'évaluation de production-readiness (barrières de déploiement, registre des risques, travail différé), voir docs/PRODUCTION-READINESS.md. En bref : prêt pour le single-tenant en loopback ; l'exposition LAN attend la barrière d'auth P-12 de la v2.0.


Exécuter toute la stack dans le cloud

career-ops est au mieux toujours actif — il scanne pendant votre sommeil, accessible depuis n’importe quel navigateur. Pour mettre toute la stack sur un petit serveur — le pipeline parent career-ops, ce visualiseur career-ops-ui, et le moteur qui exécute l’IA (votre abonnement Claude via le CLI Claude Code, une passerelle Hermes locale, ou des clés API) — provisionnez un VPS (Node ≥ 18), installez le parent + ce dépôt, choisissez votre moteur, et exposez le visualiseur derrière un reverse-proxy HTTPS avec authentification en gardant intactes les invariantes de sécurité (CSP, garde SSRF, frontière XSS, aucun secret dans les logs).

📖 L’Aide §31 intégrée (« Exécuter toute la stack dans le cloud ») détaille chaque étape dans les 19 langues ; la checklist opérateur est docs/integrations/HERMES.md, et la page wiki de déploiement cloud contient les tableaux de référence.


Agent Hermes + Telegram

Hermes, de Nous Research, est un agent autonome ouvert (appel d'outils, skills, plus de 20 canaux de messagerie). Vous pouvez exécuter career-ops-ui sur un serveur cloud et relier ses événements — un scan terminé, un nouveau rapport, une relance urgente — à Telegram via un agent Hermes, afin que le pipeline vous atteigne là où vous êtes déjà.

Désormais branché (v1.151.0). Hermes en tant que fournisseur LLM est actif : lancez son API Server compatible OpenAI (hermes gateway) et définissez HERMES_API_KEY dans Réglages de l’app — career-ops-ui exécute alors ses évaluations en direct via votre Hermes local (dernier dans l’ordre auto). Le déploiement sur serveur cloud et le pont Telegram ci-dessous restent du guide pour opérateurs ; une skill hermes-bridge les déroule (les secrets ne touchent jamais le disque ni les logs ; les invariants SSRF / CSP / zéro-secret survivent au déplacement hors de 127.0.0.1).

📖 Guide complet : docs/integrations/HERMES.md — les deux formes d'intégration, le déploiement sur serveur cloud (proxy inverse + HTTPS + systemd), Telegram via Hermes, et la liste du modèle de menaces « ce qu'il ne faut PAS exposer ».


Localisation

L'UI est livrée en 19 locales — en, es, fr, pt-BR, ko, ja, ru, zh-CN, zh-TW, pl, uk, da, ar, de, it, tr, hi, ta, vi. Depuis la v1.60.0 (I18N-SPLIT), les traductions vivent un fichier par locale sous public/js/lib/locales/ — i18n-dict.<lang>.js, chacune une table plate key → string — plus un i18n-dict.aliases.js partagé. i18n-dict.js les assemble dans window.__I18N_DICT ; i18n.js résout t('key', 'fallback'). Pas d'étape de build, pas de fetch runtime — un traducteur édite un seul fichier de langue de façon isolée.

Ajouter ou changer une chaîne :

// public/js/lib/locales/i18n-dict.en.js   →   'scan.newButton': 'Run scan',
// public/js/lib/locales/i18n-dict.fr.js   →   'scan.newButton': 'Lancer le scan',
// …add the same key to all 19 locale files (parity is gated)

Utilisez-la ensuite via data-i18n="scan.newButton" dans le markup ou t('scan.newButton') en JS, puis lancez npm test. Pour ajouter une langue toute neuve, enregistrez-la dans i18n.js (LANGS + detect()), l'assembleur, index.html, et l'outillage qui énumère les locales.

📖 Guide complet : docs/LOCALIZATION.md — la disposition par locale, le mécanisme @alias, l'ajout d'une nouvelle locale pas à pas, et chaque barrière CI i18n.


📘 Comment ce dépôt est construit avec des agents

La majeure partie de ce projet est écrite avec des agents de codage. C'est une pratique qui a ses propres modes de défaillance, elle est donc menée délibérément, en suivant Agentic Coding Design Patterns de Kirill Mokevnin (édition russe). Les fichiers ci-dessous sont cette pratique rendue concrète. Aucun d'eux n'affecte l'application en fonctionnement — ils existent pour qu'une nouvelle session reprenne là où la précédente s'est arrêtée, au lieu de redériver, redécider et recasser les mêmes choses.

Fichier Ce que c'est À lire quand
CONTEXT.md Dictionnaire du domaine : un nom retenu par concept, les variantes rejetées marquées à ne pas utiliser. En premier. Il tranche les confusions que ce dépôt paie réellement — source contre adapter (123 contre 118, et pourquoi les deux ont raison), mirror contre relay, telegram contre telegram-channel.
PROGRESS.md État des travaux : ce qui est fait, la prochaine étape, les problèmes connus, et les approches abandonnées. Au début de chaque session. Git montre ce qui a changé ; ce fichier dit où en est le travail et ce qui a déjà été essayé puis rejeté.
docs/adr/ Des fiches de décision numérotées — contexte, décision, conséquences, et ce qui ferait revenir dessus. Avant de modifier quoi que ce soit qu'une fiche couvre. C'est la fiche qui décide, pas la release en cours.
CLAUDE.md Un index tenant sur un écran, pointant vers les trois fichiers ci-dessus. Automatiquement, par l'agent. Délibérément pas une base de connaissances — une longue se parcourt en diagonale, puis s'ignore.
evals/workflow/ Un ensemble de tâches fixe, avec des évaluateurs qui vérifient le comportement du pipeline, pas celui du produit. Avant et après avoir modifié un skill, un prompt ou un outil.
.claude/skills/ Des workflows packagés. parent-sync mène une release de parité complète en neuf phases contrôlées. Au lieu d'improviser une release.
.githooks/pre-commit Des garde-fous exécutables — un plancher déterministe qui bloque net, plus une couche IA consultative qui ne bloque jamais. Il s'exécute de lui-même.

Comment les utiliser

Les docs ne demandent aucune configuration — c'est du Markdown brut, lu par vous et par l'agent. Deux choses sont câblées et valent la peine d'être connues :

# Garde-fous : des hooks détenus par le dépôt, donc les vérifications s'appliquent à tout le monde, pas seulement à votre machine.
git config core.hooksPath .githooks

# Évaluations de workflow : notent l'état du dépôt par rapport aux règles de docs/adr/ et PROGRESS.md.
node evals/workflow/run.mjs              # tous les évaluateurs
node evals/workflow/run.mjs --task qa-prompt-mandatory

Chaque évaluateur de evals/workflow/tasks.yml correspond à une erreur qui a un jour été livrée — une attribution historique écrasée, un build de site lancé en plein fan-out, un no-port manqué. Le résultat et la trajectoire sont notés séparément, et un évaluateur qui ne peut pas être tranché à partir du dépôt renvoie SKIP plutôt que de passer silencieusement : une vérification qui ne peut pas s'exécuter ne doit jamais paraître verte.

Les garder à jour

Un dictionnaire obsolète est pire que son absence, donc écrire ces fichiers fait partie de la release elle-même — la phase 0 de parent-sync les charge, et la phase 8 y réinjecte ce qui a été appris. Ajoutez un terme à CONTEXT.md dans le même commit qui introduit le concept ; ouvrez une ADR quand un choix paraîtrait arbitraire dans six mois ; consignez une approche rejetée dans PROGRESS.md au moment même où elle est rejetée.

Les patterns du livre réellement implémentés ici — et ceux qui ne le sont pas — sont audités sur la page wiki Agentic Practices.


Contribuer

Issues et PR bienvenues. Règles de la maison :

  • Lancez npm test avant de pousser — le tout vert est la barre (plus les Playwright si vous touchez à l'UI).
  • Les changements non triviaux passent par le pipeline GSD. Voir docs/sdd/SDD-GUIDE.md.
  • Ne modifiez rien dans le projet parent career-ops/ depuis ce dépôt. Tout l'intérêt est que ce soit une surcouche non invasive. Règles strictes dans CLAUDE.md.
  • Commits conventionnels : feat, fix, refactor, docs, test, chore, perf, ci. Scope optionnel : feat(scan):. Changement cassant : feat!:.
  • Les tests doivent être isolés pour la CI — amorcez les fixtures via mkdtempSync ou CAREER_OPS_ROOT=$(mktemp -d).

Vous pilotez le dépôt depuis un CLI non-Claude (Codex, Aider, Cursor, Gemini) ? Lisez AGENTS.md ou GEMINI.md — les deux renvoient au CLAUDE.md canonique.



🌍 Pour commencer — premiers pas après l'installation

Après l'installation en une commande, vous avez deux clones git vides, échafaudés avec des fichiers cv.md, config/profile.yml, portals.yml, data/applications.md et data/pipeline.md de départ contenant des marqueurs EDIT ME. La page Health devrait déjà être toute verte au premier lancement. Remplacez les placeholders par vos vraies données :

1. Créez votre CV (cv.md)

Vous avez trois options :

  • Option A — collez un CV existant : ouvrez career-ops/cv.md, remplacez les placeholders EDIT-ME par votre vrai CV en markdown propre (sections : Résumé, Expérience, Projets, Formation, Compétences). Plus c'est simple, mieux c'est — career-ops le lit comme du texte brut.
  • Option B — importez depuis l'UI : cliquez sur CV dans la barre latérale → 📁 Import CV → choisissez votre fichier .md / .txt → vérifiez l'aperçu → cliquez sur 💾 Save.
  • Option C — donnez votre URL LinkedIn à Claude Code : ouvrez Claude Code dans career-ops/, lancez /career-ops, collez votre URL LinkedIn, et demandez « extract my CV from this and write it to cv.md ».

Rendez chaque métrique précise (p. ex. « réduit la latence p99 de 38 % » et non « amélioré les performances »). Le pipeline d'évaluation lit les métriques directement dans ce fichier.

2. Éditez votre profil (config/profile.yml)

$EDITOR career-ops/config/profile.yml

Remplacez les placeholders pour nom complet, e-mail, lieu, LinkedIn, postes cibles, archétypes, objectif salarial. Les archétypes sont le champ le plus important — c'est ainsi que chaque offre est mise en correspondance avec vous.

3. Réglez le scanner (portals.yml)

$EDITOR career-ops/portals.yml

Définissez title_filter.positive (p. ex. "PHP", "Go", "Backend", "Senior") et title_filter.negative (p. ex. "Junior", "Java", "iOS") selon votre stack et votre séniorité. La liste tracked_companies fournie inclut déjà 3 sites Greenhouse / Ashby vérifiés (GitLab, Vercel, Linear). Pour 24+ blocs prêts à coller, voir docs/portals-examples.md.

Si vous voulez scanner hh.ru / Habr Career, éditez le bloc russian_portals: créé par le script de setup — ajoutez vos requêtes (p. ex. "Senior PHP", "Тимлид Go").

4. (Optionnel) Clés API LLM

L'UI préfère Anthropic à Gemini quand les deux sont présents. L'un, l'autre ou aucun fonctionne — sans clé, Evaluate renvoie un prompt à copier-coller pour Claude Code à la place.

# Anthropic (preferred)
echo "ANTHROPIC_API_KEY=sk-ant-..." >> career-ops/.env
# Gemini (fallback)
echo "GEMINI_API_KEY=AIza..." >> career-ops/.env

Ou définissez-les via la page App settings de l'UI (/#/config) — même fichier, masqué à la lecture, appliqué à process.env immédiatement.

5. Vérifiez et commencez à travailler

Rafraîchissez la page Health — chaque vérification requise doit être verte. Ensuite :

  1. Cliquez sur 🌐 Scan → attendez ~5 secondes → Greenhouse / Ashby / Lever / Workable / SmartRecruiters / Workday + hh.ru / Habr Career sont scannés, les offres apparaissent dans le tableau ci-dessous.
  2. Cliquez sur un titre → l'offre d'origine s'ouvre dans un nouvel onglet.
  3. Filtrez par puces de stack (PHP / Go / Backend / Senior) jusqu'à voir quelque chose de prometteur.
  4. Copiez l'URL → collez-la dans Pipeline → cliquez sur Evaluate pour la noter 0-5 en live (Anthropic / Gemini) ou obtenir un prompt manuel.
  5. Les rapports atterrissent dans reports/, le tracker dans data/applications.md, la recherche approfondie live dans interview-prep/. Tout visible dans l'UI.

Les traductions de ce guide vivent dans chaque README spécifique à la langue : 🇬🇧 English · 🇪🇸 Español · 🇧🇷 Português (Brasil) · 🇰🇷 한국어 · 🇯🇵 日本語 · 🇷🇺 Русский · 🇨🇳 简体中文 · 🇹🇼 繁體中文 · 🇵🇱 Polski · 🇺🇦 Українська · 🇩🇰 Dansk · 🇸🇦 العربية · 🇩🇪 Deutsch · 🇮🇹 Italiano · 🇹🇷 Türkçe · 🇮🇳 हिन्दी · 🇱🇰 தமிழ் · 🇻🇳 Tiếng Việt


Licence

MIT. Voir LICENSE.

Construit par-dessus career-ops de santifer. Merci pour ce pipeline brillant.

Contributeurs

Merci à toutes les personnes qui aident à construire career-ops-ui. Le projet est maintenu par Fighter90 et amélioré par les contributions de la communauté — voir la liste complète sur le graphe des contributeurs.

Fighter90 Alien10140 vignyl bracketouverte bullitt186 goldbillka

Tous les contributeurs →

career-ops-ui

career-ops-ui

The open-source job search command center

Check it out on Product Hunt →