piilot-pack-fropendata-ui 0.1.0

package/README.md

@@ -0,0 +1,48 @@
+# piilot-pack-fropendata-ui
+
+Frontend contributions for the `hello` Piilot plugin. Ships alongside
+the backend package `piilot-pack-fropendata` on PyPI — the two share a
+namespace and a per-company activation flag.
+
+## What's in here
+
+- `src/index.ts` — plugin entry point. Exports `register(core)` called
+  by the host at boot.
+- `src/HelloModuleView.tsx` — React component rendered when the user
+  opens `/modules/:slug` matching `fropendata.hello`.
+- `src/locales/{fr,en}.json` — translation keys merged under the
+  `hello` namespace by the host's i18next.
+- `__tests__/` — Vitest isolated tests.
+
+## Pattern
+
+Source-only package : `main`/`exports` point at `./src/index.ts`.
+The consumer (the Piilot host) transforms and bundles via Vite. No
+`dist/` to build or ship.
+
+## Host import contract
+
+The plugin imports back into the host via the `@plugin-host/*`
+alias — see `tsconfig.json` paths. Never reach around with
+`../../../frontend/src/...` : the alias is stable across the planned
+Module Federation migration; deep paths are not.
+
+## Publish
+
+Bump `package.json` version, commit, tag `ui-v<version>` in the
+plugin repo :
+
+```bash
+git tag ui-v0.3.0
+git push origin ui-v0.3.0
+```
+
+The `.github/workflows/release-ui.yml` workflow publishes to npm.
+See the root `CLAUDE.md` for token setup.
+
+## Full contract
+
+For the complete guide (Vite 3-tier resolution, host-side consumption,
+module federation roadmap) see :
+[`docs/sdk/PLUGIN_DEVELOPMENT.md`](https://github.com/Kinetics-Consulting-V2/AICockpit/blob/main/docs/sdk/PLUGIN_DEVELOPMENT.md)
+§20 — "Frontend contributions".

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "piilot-pack-fropendata-ui",
+  "version": "0.1.0",
+  "description": "Frontend du plugin Open Data France — ModuleView Settings (4 onglets : APIs, Auth, Cache, Métriques) + bundles i18n FR/EN.",
+  "license": "Apache-2.0",
+  "author": "Kinetics Consulting V2 <contact@piilot.ai>",
+  "homepage": "https://github.com/Kinetics-Consulting-V2/piilot-pack-fropendata",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Kinetics-Consulting-V2/piilot-pack-fropendata.git"
+  },
+  "keywords": ["piilot", "plugin", "frontend", "open-data", "france", "sirene", "inpi", "bodacc"],
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./src/index.ts",
+      "default": "./src/index.ts"
+    }
+  },
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-i18next": "^16.0.0",
+    "react-router-dom": "^7.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.1.0",
+    "@types/node": "^22.10.2",
+    "@types/react": "^19.0.2",
+    "@types/react-dom": "^19.0.2",
+    "jsdom": "^25.0.1",
+    "typescript": "^5.7.2",
+    "vitest": "^3.2.4"
+  }
+}

package/src/FrOpenDataSettingsView.tsx

@@ -0,0 +1,468 @@
+/**
+ * Settings ModuleView for the fr-opendata plugin.
+ *
+ * Rendered by the host's ``ModuleViewShell`` when the user opens
+ * ``/modules/<uuid>`` whose ``module_slug`` matches ``fropendata.settings``
+ * (cf. backend ``seeds.py``).
+ *
+ * The view has 4 tabs:
+ *   - APIs   : status of the 6 backing APIs (auth required vs public).
+ *   - Auth   : credential forms for SIRENE + INPI (BYOK).
+ *   - Cache  : per-API TTL overrides (v0.1 read-only — placeholder for v0.2).
+ *   - Métriques : cache hit/miss rates from the /settings/health endpoint.
+ *
+ * Implementation notes:
+ *   - Pas d'imports `@plugin-host/*` hors le type d'API host (via `index.ts`).
+ *     Tout le rendu utilise React + classes Tailwind brutes pour rester
+ *     portable et testable en isolation.
+ *   - Toutes les chaînes passent par `useTranslation('fropendata')` —
+ *     namespace cohérent avec `registerI18nBundle` dans `index.ts`.
+ *   - Les calls admin (test connection, patch config) hit
+ *     `/plugins/fropendata/*` directement avec `fetch`, en s'appuyant
+ *     sur le cookie de session que le host injecte.
+ */
+
+import { useEffect, useState, useCallback } from 'react'
+import { useTranslation } from 'react-i18next'
+
+type TabKey = 'apis' | 'auth' | 'cache' | 'metrics'
+
+interface APIHealthEntry {
+  name: string
+  requires_auth: boolean
+  cache_hits: number
+  cache_misses: number
+  hit_rate: number | null
+}
+
+interface HealthResponse {
+  plugin: string
+  version: string
+  status: string
+  company_id: string | null
+  apis: APIHealthEntry[]
+}
+
+interface ConnectionTestResult {
+  provider: string
+  ok: boolean
+  detail: string
+}
+
+const TABS: TabKey[] = ['apis', 'auth', 'cache', 'metrics']
+
+export default function FrOpenDataSettingsView(): JSX.Element {
+  const { t } = useTranslation('fropendata')
+  const [activeTab, setActiveTab] = useState<TabKey>('apis')
+  const [health, setHealth] = useState<HealthResponse | null>(null)
+  const [healthError, setHealthError] = useState<string | null>(null)
+  const [healthLoading, setHealthLoading] = useState(false)
+
+  const refreshHealth = useCallback(async () => {
+    setHealthLoading(true)
+    setHealthError(null)
+    try {
+      const res = await fetch('/plugins/fropendata/settings/health', {
+        credentials: 'include',
+      })
+      if (!res.ok) {
+        throw new Error(`HTTP ${res.status}`)
+      }
+      const data = (await res.json()) as HealthResponse
+      setHealth(data)
+    } catch (e) {
+      setHealthError(e instanceof Error ? e.message : String(e))
+    } finally {
+      setHealthLoading(false)
+    }
+  }, [])
+
+  useEffect(() => {
+    void refreshHealth()
+  }, [refreshHealth])
+
+  return (
+    <div className="p-6 max-w-5xl mx-auto">
+      <header className="mb-6">
+        <h1 className="text-2xl font-semibold text-gray-900 mb-1">
+          {t('modules.settings.title')}
+        </h1>
+        <p className="text-sm text-gray-600">
+          {t('modules.settings.description')}
+        </p>
+      </header>
+
+      {/* Tabs nav */}
+      <nav className="flex border-b border-gray-200 mb-6" role="tablist">
+        {TABS.map((tab) => (
+          <button
+            key={tab}
+            type="button"
+            role="tab"
+            aria-selected={activeTab === tab}
+            onClick={() => setActiveTab(tab)}
+            className={`px-4 py-2 text-sm font-medium transition-colors ${
+              activeTab === tab
+                ? 'border-b-2 border-blue-600 text-blue-600'
+                : 'text-gray-500 hover:text-gray-700'
+            }`}
+          >
+            {t(`tabs.${tab}`)}
+          </button>
+        ))}
+      </nav>
+
+      {/* Tab panels */}
+      <section role="tabpanel" aria-label={t(`tabs.${activeTab}`)}>
+        {activeTab === 'apis' && (
+          <APIsPanel
+            health={health}
+            loading={healthLoading}
+            error={healthError}
+          />
+        )}
+        {activeTab === 'auth' && <AuthPanel onCredsSaved={refreshHealth} />}
+        {activeTab === 'cache' && <CachePanel />}
+        {activeTab === 'metrics' && (
+          <MetricsPanel
+            health={health}
+            loading={healthLoading}
+            error={healthError}
+            onRefresh={refreshHealth}
+          />
+        )}
+      </section>
+    </div>
+  )
+}
+
+/* ------------------------------------------------------------------ */
+/* APIs tab — status grid for the 6 backing APIs                      */
+/* ------------------------------------------------------------------ */
+
+function APIsPanel({
+  health,
+  loading,
+  error,
+}: {
+  health: HealthResponse | null
+  loading: boolean
+  error: string | null
+}): JSX.Element {
+  const { t } = useTranslation('fropendata')
+
+  if (loading && !health) {
+    return <p className="text-sm text-gray-500">{t('common.loading')}</p>
+  }
+  if (error) {
+    return (
+      <p className="text-sm text-red-600">
+        {t('errors.health_fetch_failed')}: {error}
+      </p>
+    )
+  }
+  if (!health) {
+    return null
+  }
+
+  return (
+    <ul className="grid grid-cols-1 sm:grid-cols-2 gap-3">
+      {health.apis.map((api) => (
+        <li
+          key={api.name}
+          className="border border-gray-200 rounded-lg p-4 bg-white"
+        >
+          <div className="flex items-center justify-between mb-2">
+            <span className="font-medium text-gray-900">
+              {t(`apis.${api.name}.label`)}
+            </span>
+            <span
+              className={`text-xs px-2 py-0.5 rounded ${
+                api.requires_auth
+                  ? 'bg-amber-100 text-amber-700'
+                  : 'bg-green-100 text-green-700'
+              }`}
+            >
+              {api.requires_auth ? t('apis.requires_auth') : t('apis.no_auth')}
+            </span>
+          </div>
+          <p className="text-xs text-gray-500">
+            {t(`apis.${api.name}.description`)}
+          </p>
+        </li>
+      ))}
+    </ul>
+  )
+}
+
+/* ------------------------------------------------------------------ */
+/* Auth tab — credentials forms + test connection buttons             */
+/* ------------------------------------------------------------------ */
+
+function AuthPanel({
+  onCredsSaved,
+}: {
+  onCredsSaved: () => void
+}): JSX.Element {
+  const { t } = useTranslation('fropendata')
+  return (
+    <div className="space-y-6">
+      <ConnectorAuthCard
+        provider="sirene"
+        title={t('connectors.sirene.title')}
+        description={t('connectors.sirene.description')}
+        helpUrl="https://api.insee.fr/catalogue/"
+        helpLabel={t('connectors.sirene.help_link')}
+        fields={[
+          { name: 'consumer_key', label: t('connectors.sirene.consumer_key'), type: 'text' },
+          { name: 'consumer_secret', label: t('connectors.sirene.consumer_secret'), type: 'password' },
+        ]}
+        onSaved={onCredsSaved}
+      />
+      <ConnectorAuthCard
+        provider="inpi"
+        title={t('connectors.inpi.title')}
+        description={t('connectors.inpi.description')}
+        helpUrl="https://www.inpi.fr/services-en-ligne"
+        helpLabel={t('connectors.inpi.help_link')}
+        fields={[
+          { name: 'username', label: t('connectors.inpi.username'), type: 'text' },
+          { name: 'password', label: t('connectors.inpi.password'), type: 'password' },
+        ]}
+        onSaved={onCredsSaved}
+      />
+    </div>
+  )
+}
+
+interface AuthField {
+  name: string
+  label: string
+  type: 'text' | 'password'
+}
+
+function ConnectorAuthCard({
+  provider,
+  title,
+  description,
+  helpUrl,
+  helpLabel,
+  fields,
+  onSaved,
+}: {
+  provider: 'sirene' | 'inpi'
+  title: string
+  description: string
+  helpUrl: string
+  helpLabel: string
+  fields: AuthField[]
+  onSaved: () => void
+}): JSX.Element {
+  const { t } = useTranslation('fropendata')
+  const [testResult, setTestResult] = useState<ConnectionTestResult | null>(null)
+  const [testing, setTesting] = useState(false)
+
+  const handleTest = async () => {
+    setTesting(true)
+    setTestResult(null)
+    try {
+      const res = await fetch(`/plugins/fropendata/connections/test/${provider}`, {
+        method: 'POST',
+        credentials: 'include',
+      })
+      if (!res.ok) {
+        throw new Error(`HTTP ${res.status}`)
+      }
+      const data = (await res.json()) as ConnectionTestResult
+      setTestResult(data)
+      if (data.ok) {
+        onSaved()
+      }
+    } catch (e) {
+      setTestResult({
+        provider,
+        ok: false,
+        detail: e instanceof Error ? e.message : String(e),
+      })
+    } finally {
+      setTesting(false)
+    }
+  }
+
+  return (
+    <div className="border border-gray-200 rounded-lg p-5 bg-white">
+      <div className="flex items-start justify-between mb-3">
+        <div>
+          <h3 className="font-medium text-gray-900">{title}</h3>
+          <p className="text-sm text-gray-600 mt-1">{description}</p>
+        </div>
+        <a
+          href={helpUrl}
+          target="_blank"
+          rel="noopener noreferrer"
+          className="text-xs text-blue-600 hover:underline whitespace-nowrap ml-4"
+        >
+          {helpLabel} ↗
+        </a>
+      </div>
+
+      <p className="text-xs text-gray-500 mb-3">
+        {t('connectors.save_via_settings_note')}
+      </p>
+
+      <ul className="text-xs text-gray-600 mb-4 space-y-1">
+        {fields.map((f) => (
+          <li key={f.name}>
+            <code className="bg-gray-100 px-1.5 py-0.5 rounded">{f.name}</code>
+            {' — '}
+            {f.label}
+            {f.type === 'password' && ' 🔒'}
+          </li>
+        ))}
+      </ul>
+
+      <div className="flex items-center gap-3">
+        <button
+          type="button"
+          onClick={handleTest}
+          disabled={testing}
+          className="text-sm px-3 py-1.5 border border-gray-300 rounded hover:bg-gray-50 disabled:opacity-50 disabled:cursor-not-allowed"
+        >
+          {testing ? t('common.testing') : t('common.test_connection')}
+        </button>
+        {testResult && (
+          <span
+            className={`text-sm ${testResult.ok ? 'text-green-600' : 'text-red-600'}`}
+          >
+            {testResult.ok ? '✓' : '✗'} {testResult.detail}
+          </span>
+        )}
+      </div>
+    </div>
+  )
+}
+
+/* ------------------------------------------------------------------ */
+/* Cache tab — TTL overrides placeholder (v0.2)                       */
+/* ------------------------------------------------------------------ */
+
+function CachePanel(): JSX.Element {
+  const { t } = useTranslation('fropendata')
+  const ttls: { name: string; ttl: string }[] = [
+    { name: 'recherche', ttl: '24h' },
+    { name: 'sirene', ttl: '7j' },
+    { name: 'ban', ttl: '30j' },
+    { name: 'geo', ttl: '90j' },
+    { name: 'bodacc', ttl: '1j' },
+    { name: 'inpi', ttl: '7j' },
+  ]
+  return (
+    <div className="space-y-4">
+      <p className="text-sm text-gray-600">{t('cache.intro')}</p>
+      <p className="text-xs text-amber-700 bg-amber-50 border border-amber-200 rounded p-3">
+        ⚠ {t('cache.v01_readonly_warning')}
+      </p>
+      <table className="w-full text-sm border border-gray-200 rounded overflow-hidden">
+        <thead className="bg-gray-50">
+          <tr>
+            <th className="text-left px-3 py-2 font-medium text-gray-700">
+              {t('cache.api')}
+            </th>
+            <th className="text-left px-3 py-2 font-medium text-gray-700">
+              {t('cache.default_ttl')}
+            </th>
+            <th className="text-left px-3 py-2 font-medium text-gray-700">
+              {t('cache.justification')}
+            </th>
+          </tr>
+        </thead>
+        <tbody className="divide-y divide-gray-200">
+          {ttls.map((row) => (
+            <tr key={row.name}>
+              <td className="px-3 py-2 font-mono text-xs">{row.name}</td>
+              <td className="px-3 py-2">{row.ttl}</td>
+              <td className="px-3 py-2 text-xs text-gray-600">
+                {t(`cache.justification_${row.name}`)}
+              </td>
+            </tr>
+          ))}
+        </tbody>
+      </table>
+    </div>
+  )
+}
+
+/* ------------------------------------------------------------------ */
+/* Métriques tab — cache hit/miss + refresh button                    */
+/* ------------------------------------------------------------------ */
+
+function MetricsPanel({
+  health,
+  loading,
+  error,
+  onRefresh,
+}: {
+  health: HealthResponse | null
+  loading: boolean
+  error: string | null
+  onRefresh: () => void
+}): JSX.Element {
+  const { t } = useTranslation('fropendata')
+  return (
+    <div className="space-y-4">
+      <div className="flex items-center justify-between">
+        <p className="text-sm text-gray-600">{t('metrics.intro')}</p>
+        <button
+          type="button"
+          onClick={onRefresh}
+          disabled={loading}
+          className="text-sm px-3 py-1.5 border border-gray-300 rounded hover:bg-gray-50 disabled:opacity-50"
+        >
+          {loading ? t('common.loading') : t('common.refresh')}
+        </button>
+      </div>
+      {error && (
+        <p className="text-sm text-red-600">
+          {t('errors.health_fetch_failed')}: {error}
+        </p>
+      )}
+      {health && (
+        <table className="w-full text-sm border border-gray-200 rounded overflow-hidden">
+          <thead className="bg-gray-50">
+            <tr>
+              <th className="text-left px-3 py-2 font-medium text-gray-700">
+                {t('metrics.api')}
+              </th>
+              <th className="text-right px-3 py-2 font-medium text-gray-700">
+                {t('metrics.hits')}
+              </th>
+              <th className="text-right px-3 py-2 font-medium text-gray-700">
+                {t('metrics.misses')}
+              </th>
+              <th className="text-right px-3 py-2 font-medium text-gray-700">
+                {t('metrics.hit_rate')}
+              </th>
+            </tr>
+          </thead>
+          <tbody className="divide-y divide-gray-200">
+            {health.apis.map((api) => (
+              <tr key={api.name}>
+                <td className="px-3 py-2 font-mono text-xs">{api.name}</td>
+                <td className="px-3 py-2 text-right">{api.cache_hits}</td>
+                <td className="px-3 py-2 text-right">{api.cache_misses}</td>
+                <td className="px-3 py-2 text-right">
+                  {api.hit_rate === null
+                    ? '—'
+                    : `${(api.hit_rate * 100).toFixed(1)}%`}
+                </td>
+              </tr>
+            ))}
+          </tbody>
+        </table>
+      )}
+      <p className="text-xs text-gray-500">
+        v {health?.version ?? '—'} · company {health?.company_id ?? '—'}
+      </p>
+    </div>
+  )
+}

package/src/index.ts

@@ -0,0 +1,46 @@
+/**
+ * fr-opendata plugin — frontend entry point.
+ *
+ * Exports a single ``register`` function the host calls at boot via the
+ * Vite alias ``@plugin/fr-opendata`` (host-side ``loader.ts``). Wires
+ * the Settings module view + i18n bundles into the core registry.
+ *
+ * This plugin contributes exactly **two** things to the host UI:
+ *   1. A React component (``FrOpenDataSettingsView``) rendered inside
+ *      ``ModuleViewShell`` when the user opens ``/modules/<uuid>`` whose
+ *      ``module_slug`` is ``fropendata.settings``.
+ *   2. FR/EN translation keys merged under the ``fropendata`` namespace.
+ *
+ * Tools, agent templates, connectors, HTTP routes and the Bodacc-watch
+ * KB all live backend-side (``piilot_pack_fropendata`` PyPI package).
+ */
+
+import type { PluginHostApi } from '@plugin-host/lib/pluginUI'
+
+import FrOpenDataSettingsView from './FrOpenDataSettingsView'
+import en from './locales/en.json'
+import fr from './locales/fr.json'
+
+// Single source of truth for this plugin's namespace. Used both for
+// ``registerI18nBundle(NS, ...)`` AND for unwrapping the locale JSON's
+// top-level ``{[NS]: {...}}`` envelope. Keeping it as a const avoids
+// drift between the i18n bundle key and the module slug prefix.
+const NS = 'fropendata'
+
+export function register(core: PluginHostApi): void {
+  // Slug must match the ``module_slug`` seeded by the backend's
+  // ``register_module(...)`` call (see ``piilot_pack_fropendata/seeds.py``).
+  // Mismatch here silently disables the plugin UI — the host falls back
+  // to the generic step runner. Verified slug = ``fropendata.settings``.
+  core.registerModuleView(`${NS}.settings`, FrOpenDataSettingsView)
+
+  // Locale JSONs wrap their content under the namespace key (matches the
+  // host's i18n convention). Pass the inner payload to avoid double
+  // nesting when the host merges into its global catalog.
+  const frKeys = (fr as Record<string, unknown>)[NS] ?? fr
+  const enKeys = (en as Record<string, unknown>)[NS] ?? en
+  core.registerI18nBundle(NS, 'fr', frKeys as Record<string, unknown>)
+  core.registerI18nBundle(NS, 'en', enKeys as Record<string, unknown>)
+}
+
+export default { register }

package/src/locales/en.json

@@ -0,0 +1,95 @@
+{
+  "fropendata": {
+    "modules": {
+      "settings": {
+        "title": "Open Data France",
+        "description": "Configure your SIRENE and INPI connectors, tune cache TTLs and watch usage metrics for the 6 French government APIs aggregated by the plugin."
+      }
+    },
+    "tabs": {
+      "apis": "APIs",
+      "auth": "Authentication",
+      "cache": "Cache",
+      "metrics": "Metrics"
+    },
+    "common": {
+      "loading": "Loading…",
+      "refresh": "Refresh",
+      "test_connection": "Test connection",
+      "testing": "Testing…",
+      "save": "Save",
+      "cancel": "Cancel"
+    },
+    "apis": {
+      "requires_auth": "BYOK required",
+      "no_auth": "No authentication",
+      "recherche": {
+        "label": "Company search",
+        "description": "DINUM-maintained meta-API: fast lookup by name, SIREN, SIRET or director. Quota 7 req/s."
+      },
+      "sirene": {
+        "label": "SIRENE V3",
+        "description": "Official INSEE registry. Source of truth for legal unit and establishment data. 30 req/min when authenticated."
+      },
+      "ban": {
+        "label": "National Address Database",
+        "description": "Geocoding and normalization of French addresses. 50 req/s."
+      },
+      "geo": {
+        "label": "Administrative breakdown",
+        "description": "Communes, départements, régions, EPCIs by INSEE code."
+      },
+      "bodacc": {
+        "label": "Bodacc",
+        "description": "French legal-events publication board (insolvency, sales, statutes changes)."
+      },
+      "inpi": {
+        "label": "INPI DNE",
+        "description": "National companies database: filed annual accounts, corporate officers."
+      }
+    },
+    "connectors": {
+      "save_via_settings_note": "Credential entry and storage is handled by the host's Settings → Connectors page. This panel lists the expected fields and lets you test stored credentials.",
+      "sirene": {
+        "title": "SIRENE connector (INSEE)",
+        "description": "OAuth2 client_credentials. Create your application on the PISTE portal to get consumer_key + consumer_secret.",
+        "consumer_key": "App key (consumer_key)",
+        "consumer_secret": "App secret (consumer_secret)",
+        "help_link": "Create an INSEE developer account"
+      },
+      "inpi": {
+        "title": "INPI DNE connector",
+        "description": "Basic auth (username + password) on the INPI pro portal. The client exchanges these for a 1-hour JWT internally.",
+        "username": "INPI username",
+        "password": "INPI password",
+        "help_link": "Create an INPI developer account"
+      }
+    },
+    "cache": {
+      "intro": "Default cache TTLs, aligned on each API's typical data freshness. The Redis prefix ``plugin:fropendata:`` is added automatically by the SDK.",
+      "v01_readonly_warning": "v0.1: TTLs are fixed (read-only). Per-tenant customization lands in v0.2.",
+      "api": "API",
+      "default_ttl": "Default TTL",
+      "justification": "Rationale",
+      "justification_recherche": "Volatile metadata, daily refresh is enough",
+      "justification_sirene": "INSEE refresh is ~monthly, 7 days = good freshness/quota tradeoff",
+      "justification_ban": "Addresses are very stable, 30 days avoid redundant hits",
+      "justification_geo": "Admin breakdown is quasi-immutable apart from commune mergers",
+      "justification_bodacc": "Legal watch needs same-day freshness",
+      "justification_inpi": "Annual accounts = rare deposits, 7 days is plenty"
+    },
+    "metrics": {
+      "intro": "Redis cache hits / misses for each API. Counters are kept for 30 days then auto-reset.",
+      "api": "API",
+      "hits": "Hits",
+      "misses": "Misses",
+      "hit_rate": "Hit rate"
+    },
+    "errors": {
+      "health_fetch_failed": "Could not fetch the plugin status",
+      "not_configured": "Connector not configured for your organization",
+      "invalid_siren": "Invalid SIREN (must be 9 digits)",
+      "invalid_siret": "Invalid SIRET (must be 14 digits)"
+    }
+  }
+}

package/src/locales/fr.json

@@ -0,0 +1,95 @@
+{
+  "fropendata": {
+    "modules": {
+      "settings": {
+        "title": "Open Data France",
+        "description": "Configurez vos connecteurs SIRENE et INPI, ajustez le cache et consultez les métriques d'usage des 6 APIs gouvernementales agrégées par le plugin."
+      }
+    },
+    "tabs": {
+      "apis": "APIs",
+      "auth": "Authentification",
+      "cache": "Cache",
+      "metrics": "Métriques"
+    },
+    "common": {
+      "loading": "Chargement…",
+      "refresh": "Rafraîchir",
+      "test_connection": "Tester la connexion",
+      "testing": "Test en cours…",
+      "save": "Enregistrer",
+      "cancel": "Annuler"
+    },
+    "apis": {
+      "requires_auth": "BYOK requis",
+      "no_auth": "Sans authentification",
+      "recherche": {
+        "label": "Recherche entreprises",
+        "description": "API DINUM : lookup rapide par nom, SIREN, SIRET ou dirigeant. Quota 7 req/s."
+      },
+      "sirene": {
+        "label": "SIRENE V3",
+        "description": "API officielle INSEE. Source de vérité pour les données légales et établissements. 30 req/min en authentifié."
+      },
+      "ban": {
+        "label": "Base Adresse Nationale",
+        "description": "Géocodage et normalisation d'adresses françaises. 50 req/s."
+      },
+      "geo": {
+        "label": "Découpage administratif",
+        "description": "Communes, départements, régions, EPCIs par code INSEE."
+      },
+      "bodacc": {
+        "label": "Bodacc",
+        "description": "Annonces juridiques et commerciales (procédures collectives, ventes, modifications)."
+      },
+      "inpi": {
+        "label": "INPI DNE",
+        "description": "Données nationales des entreprises : comptes annuels déposés, mandataires sociaux."
+      }
+    },
+    "connectors": {
+      "save_via_settings_note": "La saisie et la sauvegarde des credentials passent par la page Settings → Connecteurs du host. Cette section liste les champs attendus et permet de tester les credentials déjà stockés.",
+      "sirene": {
+        "title": "Connecteur SIRENE (INSEE)",
+        "description": "OAuth2 client_credentials. Créez votre application sur le portail PISTE pour obtenir consumer_key + consumer_secret.",
+        "consumer_key": "Clé applicative (consumer_key)",
+        "consumer_secret": "Secret applicatif (consumer_secret)",
+        "help_link": "Créer un compte INSEE développeur"
+      },
+      "inpi": {
+        "title": "Connecteur INPI DNE",
+        "description": "Authentification basique (login + mot de passe) sur l'espace pro INPI. Le client échange ces credentials contre un JWT 1h en interne.",
+        "username": "Identifiant INPI",
+        "password": "Mot de passe INPI",
+        "help_link": "Créer un compte INPI développeur"
+      }
+    },
+    "cache": {
+      "intro": "TTLs de cache par défaut, alignés sur la fraîcheur typique de chaque API. Le préfixe Redis ``plugin:fropendata:`` est ajouté automatiquement par le SDK.",
+      "v01_readonly_warning": "v0.1 : les TTLs sont fixes (lecture seule). La personnalisation par cabinet arrive en v0.2.",
+      "api": "API",
+      "default_ttl": "TTL par défaut",
+      "justification": "Justification",
+      "justification_recherche": "Métadonnées volatiles, recopie quotidienne suffit",
+      "justification_sirene": "INSEE refresh ~mensuel, 7 jours = bon compromis fraîcheur/quota",
+      "justification_ban": "Adresses très stables, 30 jours évitent les hits redondants",
+      "justification_geo": "Découpage admin quasi-immutable hors fusions de communes",
+      "justification_bodacc": "Veille juridique nécessite la fraîcheur du jour",
+      "justification_inpi": "Comptes annuels = dépôt rare, 7 jours largement suffisant"
+    },
+    "metrics": {
+      "intro": "Hits / misses du cache Redis pour chaque API. Compteurs maintenus pendant 30 jours puis remis à zéro automatiquement.",
+      "api": "API",
+      "hits": "Hits",
+      "misses": "Misses",
+      "hit_rate": "Taux de hit"
+    },
+    "errors": {
+      "health_fetch_failed": "Impossible de récupérer l'état du plugin",
+      "not_configured": "Connecteur non configuré pour votre organisation",
+      "invalid_siren": "SIREN invalide (doit faire 9 chiffres)",
+      "invalid_siret": "SIRET invalide (doit faire 14 chiffres)"
+    }
+  }
+}