@tekkare/romulus 0.1.251 → 0.1.252

package/layer/app/oip-drugs/utils/v-salesSeries.ts

@@ -0,0 +1,156 @@
+/**
+ * Evolutions des ventes d'une marque (Medic'AM, Outpatient, liste en sus,
+ * retrocession), pour les vues de ressource du lot V : les constantes des
+ * stores `retail`, `outpatient` et `hospital` de fr_drugs_app, la marque lue
+ * dans le `resourceId`, et le calcul des courbes des graphes de ventes
+ * (medicam/market/chart, outpatient/productEvolution).
+ *
+ * Le calcul des courbes reprend celui de fr_drugs_app pas a pas, sans lodash
+ * (le layer ne le declare pas) : arrondi, part de marche par periode, trous
+ * bouches a null, jointure des libelles, une courbe par libelle.
+ */
+import useMergeByKey from "../composables/useMergeByKey";
+import { DRUG_PROJECT_KINDS } from "../kinds";
+
+type MeasureList = { variables: string[]; en: string[]; fr: string[] };
+
+/** cf. store/retail de fr_drugs_app (medicamMeasure*). */
+export const MEDICAM_MEASURES: MeasureList = {
+  variables: ["unit_reimbursed", "value_public_price", "factory_value", "amount_reimbursed"],
+  en: ["# Packages", "Value in Public Price (€)", "Value ex-factory (€) - PFHT", "Amount Reimbursed (€)"],
+  fr: ["# Boîtes", "Valeur en prix public (€)", "Prix Fabricant HT (€)", "Montant remboursé (€)"],
+};
+
+/** cf. store/outpatient de fr_drugs_app (outpatientMeasure*), mesure par defaut : prix public. */
+export const OUTPATIENT_MEASURES: MeasureList = {
+  variables: ["unit_reimbursed", "value_public_price", "amount_reimbursed"],
+  en: ["# Packages", "Value in Public Price (€)", "Amount Reimbursed (€)"],
+  fr: ["# Boîtes", "Valeur en prix public (€)", "Montant Remboursé (€)"],
+};
+export const OUTPATIENT_DEFAULT_MEASURE = 1;
+
+/** cf. store/hospital de fr_drugs_app (susMeasure*, retrocessionMeasure*). */
+export const HOSPITAL_MEASURES: Record<"FrSusBrand" | "FrRetrocessionBrand", MeasureList> = {
+  FrSusBrand: {
+    variables: ["unit", "bse"],
+    en: ["UCD Administered", "Amount Invoiced (€)"],
+    fr: ["UCD administrées", "Montant Facturé (€)"],
+  },
+  FrRetrocessionBrand: {
+    variables: ["unit", "bse", "rem"],
+    en: ["UCD Administered", "Value in Public Price (€)", "Amount Reimbursed (€)"],
+    fr: ["UCD administrées", "Valeur en prix public (€)", "Montant remboursé (€)"],
+  },
+};
+
+/** Options d'un RmSegmented de mesures, dans la langue de la vue. */
+export function measureOptions(list: MeasureList, en: boolean) {
+  return list.variables.map((value, index) => ({ value, label: (en ? list.en : list.fr)[index] ?? value }));
+}
+
+/**
+ * La marque d'un element de projet de ventes, par son `resourceId` : l'ancre
+ * (dernier mois, derniere annee) n'est qu'un repere, l'element designe la
+ * marque entiere (cf. medicamBrandOf de fr_drugs_app, titleFromId de kinds.ts).
+ */
+export function salesBrandOf(type: string, id: string): string {
+  const kind = DRUG_PROJECT_KINDS.find((k) => k.type === type) as any;
+  return kind?.titleFromId ? String(kind.titleFromId(String(id ?? ""))) : String(id ?? "");
+}
+
+/** _.round de lodash : arrondi a `precision` decimales sans erreur de flottant. */
+function round(value: unknown, precision = 0): number {
+  const n = Number(value);
+  if (!precision || !Number.isFinite(n)) return Math.round(n);
+  let [m, e] = `${n}e`.split("e");
+  const shifted = Math.round(Number(`${m}e${Number(e) + precision}`));
+  [m, e] = `${shifted}e`.split("e");
+  return Number(`${m}e${Number(e) - precision}`);
+}
+
+function compare(a: any, b: any): number {
+  if (a === b) return 0;
+  if (a === undefined) return 1;
+  if (b === undefined) return -1;
+  return a > b ? 1 : a < b ? -1 : 0;
+}
+
+/** _.orderBy ascendant, stable. */
+function orderBy(rows: any[], keys: string[]): any[] {
+  return [...rows].sort((x, y) => {
+    for (const key of keys) {
+      const c = compare(x[key], y[key]);
+      if (c) return c;
+    }
+    return 0;
+  });
+}
+
+/** _.groupBy : cle en texte, dans l'ordre d'arrivee. */
+function groupBy(rows: any[], key: string): Map<string, any[]> {
+  const groups = new Map<string, any[]>();
+  for (const row of rows) {
+    const k = String(row[key]);
+    if (!groups.has(k)) groups.set(k, []);
+    groups.get(k)!.push(row);
+  }
+  return groups;
+}
+
+/** Les periodes des lignes, une fois chacune, triees. */
+export function salesPeriods(rows: any[]): any[] {
+  return rows
+    .map((i: any) => i.period)
+    .filter((v: any, i: number, a: any[]) => a.indexOf(v) === i)
+    .sort();
+}
+
+/**
+ * Les courbes d'un graphe de ventes : `rows` portent `code`, `period` et
+ * `volume` (la mesure lue) ; `selectedLabel` donne le libelle de chaque code
+ * (`code`, `code_label`). Volume ou part de marche selon `selectedSwitch`.
+ */
+export function salesCurves(rows: any[], selectedLabel: any[], selectedSwitch: boolean) {
+  // Round and arrange selectedMetric
+  let result = orderBy(
+    rows.map((i: any) => ({ ...i, volume: round(i.volume, 0) })),
+    ["period"],
+  );
+
+  // Calculate market share
+  const total = [...groupBy(result, "period")].map(([period, list]) => ({
+    period,
+    total_volume: list.reduce((sum: number, i: any) => sum + i.volume, 0),
+  }));
+  result = useMergeByKey(result, total, "period");
+  result = result.map((i: any) => ({
+    ...i,
+    // Un total nul donnait 0/0 = NaN, trace comme un point
+    percentage: i.total_volume ? round((i.volume / i.total_volume) * 100, 1) : null,
+  }));
+
+  // Fill null values
+  const codes = [...new Set(result.map((i: any) => i.code))];
+  const periods = [...new Set(result.map((i: any) => i.period))];
+  const product = codes.flatMap((code) => periods.map((period) => ({ code, period, volume: null, percentage: 0 })));
+  const seen = new Set<string>();
+  result = [...result, ...product].filter((i: any) => {
+    const key = [i.code, i.period].join();
+    if (seen.has(key)) return false;
+    seen.add(key);
+    return true;
+  });
+  result = orderBy(result, ["code", "period"]);
+
+  // Add labels
+  result = useMergeByKey(result, selectedLabel, "code");
+
+  // Detect variable for chart
+  const variable = selectedSwitch ? "volume" : "percentage";
+
+  // Create chart_content
+  return [...groupBy(result, "code_label")].map(([name, list]) => ({
+    name,
+    data: list.map((i: any) => i[variable]),
+  }));
+}

package/layer/app/oip-drugs/utils/v-scopeTags.ts

@@ -0,0 +1,23 @@
+/**
+ * Perimetre lu par une carte, en etiquettes sous son titre : une couleur par
+ * sorte (element, mesure, specialite, periode, geographie), la meme d'une page
+ * a l'autre, pour que l'oeil retrouve la periode sans lire. Les parties vides
+ * tombent ; l'ordre est celui des sortes, pas celui de l'appel.
+ *
+ * Copie de utils/scopeTags de fr_drugs_app (lot V).
+ */
+const SCOPE_TAG_COLORS = {
+  item: "indigo",
+  measure: "sky",
+  specialty: "pink",
+  period: "emerald",
+  geo: "amber",
+} as const;
+
+export type ScopeTagKind = keyof typeof SCOPE_TAG_COLORS;
+
+export function scopeTags(parts: Partial<Record<ScopeTagKind, string>>) {
+  return (Object.keys(SCOPE_TAG_COLORS) as ScopeTagKind[])
+    .filter((kind) => parts[kind])
+    .map((kind) => ({ label: parts[kind]!, variant: SCOPE_TAG_COLORS[kind] }));
+}

package/layer/app/oip-science/PORTING.md

@@ -0,0 +1,93 @@
+# Porter une fiche de France Augmented Science dans le layer
+
+Les fiches (essais, publications, professionnels, établissements, investigateurs,
+centres) vivent ici pour s'afficher **à l'identique** dans toutes les apps du
+portail : la page de France Augmented Science (FAS) et le tiroir des projets de
+n'importe quelle app montent le même composant. Source : `~/Projects/france_augmented_science_app/app`.
+
+Le rendu est la spec : on porte le code de FAS presque tel quel, en ne
+changeant que ce qui l'attache à l'app. Pas de refonte, pas d'amélioration.
+
+## Où ranger
+
+| Quoi | Où | Nom / import |
+|---|---|---|
+| Composant | `app/components/oip-science/<famille>/<Nom>.vue` | auto-importé sous `OipScience<Famille><Nom>` (ex. `oip-science/hcps/Cards.vue` → `<OipScienceHcpsCards>`) |
+| Composable, util | `app/oip-science/composables/*.ts`, `app/oip-science/utils/*.ts` | **pas** auto-importés : import relatif explicite. Garder les noms de FAS. |
+| Index ES | `app/oip-science/indexConfig.json` (copie de celui de FAS) | `import indexConfig from "<rel>/oip-science/indexConfig.json"` |
+
+Composants déjà là : `OipScienceCommonSource` (`sources: string[]`, ex. `['PubMed']`),
+`OipResourceSource` (`uuid`), `OipResourceField`, `OipResourceTags`, `OipPubmedSummary`.
+
+## Remplacements obligatoires
+
+- **Racine** : chaque onglet et chaque composant monté seul a la classe `oip-science`
+  sur sa racine. Les classes globales de FAS (`oip_*`, `kk_*`, variables `--cool-grey`…)
+  marchent dessous (cf. `science.css`). Ne pas les réécrire.
+- **Elasticsearch** : `useElastic()` → `useOipElastic()` (`app/oip-science/composables/useOipElastic.ts`,
+  mêmes fonctions et signatures). `/api/es` n'existe pas hors FAS. Aucun autre accès réseau à ES.
+- **i18n** : toutes les clés passent sous `oipScience.` : `$t('trial.phase')` →
+  `$t('oipScience.trial.phase')`, idem `t(...)` de `useI18n()`. Seuls les préfixes
+  `trial, common, cards, publication, resultKpis, kpi, ui` existent (`app/oip-science/locales/*.json`).
+  Une clé hors de ces préfixes : **la signaler dans le compte rendu**, ne pas éditer les fichiers de locales.
+- **Identifiant** : jamais `useRoute()` / `route.params`. L'onglet reçoit la prop `id`
+  (identifiant de route de FAS : PMID, NCT, numéro EUCT, RPPS sans `10_`, FINESS, id investigateur/centre).
+- **Liens vers une autre fiche** (`openCard`, `navigateTo`, `NuxtLink`, `localePath`, `router.push`) :
+  `const nav = useOipResourceNav()` (auto-importé) puis `nav.open(type, id)` au clic et
+  `:href="nav.href(type, id)"` pour garder le Ctrl/Cmd-clic (`@click.prevent` sauf touche modificatrice,
+  comme `openCard`). Types : `PubMed`, `ClinicalTrialsNCT`, `ClinicalTrialsEUCT`, `HCP` (id = `10_<RPPS>`),
+  `Establishment` (FINESS), `ClinicalTrialsInvestigatorsNCT/EUCT`, `ClinicalTrialsCentersNCT/EUCT`.
+  Une page qui n'est pas une fiche du layer (appel à projets `/appel-a-projet/<id>`) :
+  `nav.openApp('france_augmented_science_app', path)` / `nav.appHref(...)`. Liens externes (pubmed.ncbi…) inchangés.
+- **Bouton Projet** (`ProjectAddButton`, `project-add-button`) :
+  `const { projectButton } = useOipResourceHooks()` puis
+  `<component :is="projectButton" v-if="projectButton" :resource-id="…" type="…" :label="…" compact />` (mêmes props qu'avant).
+- **Source cliquable** (`CommonSource`) → `<OipScienceCommonSource :sources="[…]" />`.
+- **Surlignage de la recherche** (`useFilterStore().getHiglightValues(...)`) : prop `highlight: string[]` (défaut `[]`).
+- **Sommaire** (`useChapterScroll()`) → `useOipChapterScroll(rootRef)` (auto-importé), `rootRef` = ref de la racine.
+- **Cadre de l'app** : retirer `useExportSource`, `declareRecord`, `useAlertSource`, `useViews`,
+  `useAppLayout().openInfo()`, `definePageMeta`, `usePosthogTracking`, les stores Pinia de FAS
+  (`elasticQueryStore`, `filterStore`, `layoutConfig`, `scopeStore`, `cardPrefs`…). Un état
+  partagé par un store devient un état local du composant. Le menu d'export d'une carte
+  (`payload` construit avec `useGenerateExcel`) est retiré : **le signaler**.
+- **État partagé en-tête / onglet** (`useState('current-hcp')`, `useState('current-establishment')`) :
+  l'onglet relit lui-même son document.
+- `<client-only>`, `Suspense` : seulement si FAS en avait besoin pour la même raison.
+- Utils de FAS (`styleAndFormat`, `valueTable`, `matchMethod`…) : copier ce qui sert dans
+  `app/oip-science/utils/` (un fichier par util de FAS, même nom), imports explicites.
+
+## Contrat d'un onglet
+
+`props: { id: string; highlight?: string[]; lang?: 'fr' | 'en' }`. Il charge ses données
+lui-même (`onMounted` ou `watch(id, …, { immediate: true })`), affiche `RmLoadingState`
+pendant le chargement et l'état vide de FAS (`CommonNoData` → `RmEmptyState` avec les mêmes textes).
+
+## Règles de texte
+
+Aucun tiret cadratin (—) dans un texte visible : parenthèses ou virgules.
+Commentaires en français, sans accents dans le code comme le reste du layer, densité de FAS.
+
+## Répartition du portage (six lots en parallèle)
+
+Chaque fichier de FAS a **un seul** lot propriétaire. Un lot n'écrit que ses fichiers ;
+il peut utiliser ceux des autres lots par leur nom cible (même API que l'original de FAS),
+même s'ils n'existent pas encore. Chemins FAS relatifs à `app/`, cibles relatives au layer `app/`.
+
+| Lot | Fichiers de FAS | Cibles |
+|---|---|---|
+| A, personnes et lieux | components/hcps/{Cards,LinkedList}.vue, components/establishments/{Cards,LinkedList}.vue, components/appel-a-projet/Cards.vue, components/common/{ScoreBadge,MatchAvgTag,ToolTips,TableTags,Form,Timeline,NoData}.vue, components/elastic/MatchExplain.vue, components/crossData/CrossDataLocations.vue ; composables useAuthorMatching, useEstablishmentMatching, useEstablishmentCrossData, useSearchFields (si utilisé) ; utils styleAndFormat, valueTable, matchMethod | components/oip-science/{hcps,establishments,appel-a-projet,common,elastic,crossData}/<même nom>.vue ; oip-science/composables/<même nom>.ts ; oip-science/utils/<même nom>.ts |
+| B, essais et publications (cartes) | components/clinical-trials/{LinkedList,Cards,CardsGlobal,PairBadge,PairBody,SitesDrawer}.vue, components/pubmed/Cards.vue ; composables useLinkedTrials, useGlobalClinicalTrials, useEuct, usePubmed | components/oip-science/{clinical-trials,pubmed}/<même nom>.vue ; oip-science/composables/<même nom>.ts |
+| C, liste de publications filtrée | components/cross/publicationPubmed.vue, components/elastic/{Filter,DateRangeFilter}.vue, components/local/{SliderTabs,SliderTabsFull}.vue ; utils frDiseaseTerms, toPresets, sliderTabs ; assets allCountries.json, smartSelection.json | components/oip-science/{cross,elastic,local}/<même nom>.vue ; oip-science/utils/<même nom>.ts ; oip-science/assets/<même nom>.json |
+| D, onglets PubMed, CT.gov, EUCT | pages/pubmed/[id]/{authors,clinical-trials}.vue, pages/ctgov/[id]/{study-description,investigators,locations,sponsors,publications}.vue, pages/euct/[id]/{study-description,products,investigators,locations,sponsors,publications}.vue | components/oip-science/pubmed/{Authors,ClinicalTrials}.vue, components/oip-science/ctgov/{StudyDescription,Investigators,Locations,Sponsors,Publications}.vue, components/oip-science/euct/{StudyDescription,Products,Investigators,Locations,Sponsors,Publications}.vue |
+| E, onglets professionnel et établissement | pages/hcps/[id]/{informations,clinical-trials,appels-a-projet,pubmed,matched-labels}.vue, pages/establishments/[id]/{informations,clinical-trials,public-finance,hcps,matched-labels}.vue (et ce que leurs en-têtes components/hcps/HeaderComponent.vue, components/establishments/HeaderComponent.vue calculent pour eux) | components/oip-science/hcps/{Informations,ClinicalTrials,AppelsAProjet,Pubmed,MatchedLabels}.vue, components/oip-science/establishments/{Informations,ClinicalTrials,PublicFinance,Hcps,MatchedLabels}.vue |
+| F, onglets investigateurs et centres | pages/{ctgov,euct}/investigators/[id]/{informations,clinical-trials,publications}.vue, pages/{ctgov,euct}/centers/[id]/{clinical-trials,publications}.vue ; composables useCTInvestigators, useEuctInvestigators, useCTCenter, useEuctCenter | components/oip-science/{ctgov-investigators,euct-investigators}/{Informations,ClinicalTrials,Publications}.vue, components/oip-science/{ctgov-centers,euct-centers}/{ClinicalTrials,Publications}.vue ; oip-science/composables/<même nom>.ts |
+
+Un onglet porté depuis une page garde le contenu de la page ; ce que l'en-tête de FAS
+calculait **pour la page** (document courant, état partagé) est relu par l'onglet.
+Un fichier utile mais absent du tableau : le créer dans son propre lot sous un nom
+préfixé par la lettre du lot (`oip-science/utils/d-<nom>.ts`) et le signaler.
+
+## Compte rendu attendu de chaque lot
+
+Fichiers créés, écarts de rendu volontaires (export de carte retiré…), clés i18n
+manquantes, dépendances vers d'autres lots, et tout ce qui n'a pas pu être porté.