oddb2xml 3.0.25 → 3.0.26

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1c80413abe4bd24c2c3555aa6eb4407c7464e381275a118c7929c686fe73f494
-  data.tar.gz: 7bf43ba8cf901d4d2de42d0e21e95bf2e25e4f1a88360b5cc4451427c52adccb
+  metadata.gz: 3b77fe7dba0df2c76d396dd0509fc77363d6efa5ee2a70580f8068d01f1aa508
+  data.tar.gz: 471b43cc817114af1b09362a224dc1b969e69eb9f1e6c9cb7975cec30bf2b04f
 SHA512:
-  metadata.gz: b20195b2d9b1d6ddd0e51b7e8062f71e2bc8c2c7b2d74c817b058c1c56f18ef203b119a39cf80e55310bd9c6d06204f15bb3c0e7d2d988837967fa1381a10735
-  data.tar.gz: 26b6d78eddd658b8dbed3949b0df277639636a66b8ed86a3a54f9478a19dfbdc81874b88afdafc3221114a41f59f7184c271206f14b6c1f5135f93b895ef3fa3
+  metadata.gz: e5317c541ea869c09bc1bd0ea5b2be5c6aa1be6923777f7daa3c419edf03036ba72cc432ef1b06db1215acb979bac27386311cea3d56fee31e9c39631caf20fd
+  data.tar.gz: 4dac43d20ae5652b2b3651470492a68dbf9ac6d843ebef98bc6f81f242338a6b4ed339526a7ac2c0d49662641054559a14529cec13ccf8e1b5bada50428fbe0e

data/.gitignore

@@ -32,4 +32,6 @@ tmp
 /epha_interactions.csv
 /missing_in_refdata.txt
 /oddb2xml_files_nonpharma.xls
-/oddb_calc.csv
+/oddb_calc.csv
+# Python bytecode cache (scripts/visitor_stats.py)
+__pycache__/

data/CLAUDE.md

@@ -47,13 +47,13 @@ The system follows a **download → extract → build → compress** pipeline:
 
 6. **Compressor** (`lib/oddb2xml/compressor.rb`) — Optional ZIP/TAR.GZ output compression.
 
-7. **FHIR support** (`lib/oddb2xml/fhir_support.rb`) — Self-contained module providing `FhirDownloader` and FHIR NDJSON parsing. Activated via `--fhir` (or `--fhir-url=<URL>`). Downloads per-language NDJSON files (`foph-sl-export-latest-{de,fr,it}.ndjson`) from `epl.bag.admin.ch` to populate French and Italian product names/descriptions. Maps legal status codes `756005022007` and `756005022008` to Swissmedic category D. Reads the BAG **Indikationscode** (`XXXXX.NN`) from the explicit `indicationCode` extension on each `RegulatedAuthorization.indication[].extension[regulatedAuthorization-limitation]` (BAG SL FHIR export >= v2.0.5; handled from 3.0.10). The BAG changelog states the limitation code (`ClinicalUseDefinition.id`) and the indication code are **independent** fields, so the older derivation — combining each indication CUD's `.NN` id-suffix with the reimbursement RA's `FOPHDossierNumber` — is kept only as a fallback for feeds lacking the extension. Exposed as `item[:indication_codes]` and per-package `:indication_codes` (each entry a `{code:, cud_id:, text:}` hash, where `cud_id` is the `limitationIndication` CUD reference used to resolve the text). From 3.0.7 onwards, `Builder#build_product` emits one `<INDICATION_CODE code="XXXXX.NN" cud_id="DRUG.NN">limitation text</INDICATION_CODE>` child per indication on every `<PRD>` in `oddb_product.xml`; live feed numbers: 539 products / 1,293 codes / 100 % with non-empty indication text. Mandatory on prescriptions/invoices for SL price-model drugs from 2026-07-01 — see issue [#113](https://github.com/zdavatz/oddb2xml/issues/113). **Limitation texts** (3.0.8 onwards): the `regulatedAuthorization-limitation` extension has no inline `limitationText` in the live BAG feed — it carries a `limitationIndication` reference to a `ClinicalUseDefinition` whose `indication.diseaseSymptomProcedure.concept.text` is the actual text. The parser stores the ref as `cud_ref` on each Limitation, `Bundle#cud_text_by_id` resolves DE, and `merge_language` propagates FR/IT from the per-language NDJSON files via the same CUD id. Coverage on the live feed jumped from 0 / 9'108 to 9'108 / 9'108 (issue [#116](https://github.com/zdavatz/oddb2xml/issues/116)). **Limitation code / LIMNAMEBAG** (3.0.12 onwards): FHIR has no native BAG limitation code (LIMCD), so `create_limitations_for_package` sets `LimitationCode = cud_ref` (the `limitationIndication` CUD id) instead of `""`. Without this, every FHIR limitation shared an empty `:code`; `Builder#build_artikelstamm` groups its `<LIMITATIONS>` section by code, so all of them collapsed into a single `<LIMITATION>` with an empty `<LIMNAMEBAG>` and only one text survived. Using the CUD id as the key makes each distinct limitation emit and be referenced from its `<PRODUCT>`. The downstream `bin/check_artikelstamm` (`semantic_check.rb`) also crashed on the lone-element output because Ox `:hash_no_attrs` collapses a one-child section into a Hash (and an empty one into nil) — `SemanticCheckXML#get_items` now normalises every section to an Array.
+7. **FHIR support** (`lib/oddb2xml/fhir_support.rb`) — Self-contained module providing `FhirDownloader` and FHIR NDJSON parsing. Activated via `--fhir` (or `--fhir-url=<URL>`). Downloads per-language NDJSON files (`foph-sl-export-latest-{de,fr,it}.ndjson`) from `epl.bag.admin.ch` to populate French and Italian product names/descriptions. Maps legal status codes `756005022007` and `756005022008` to Swissmedic category D. Reads the BAG **Indikationscode** (`XXXXX.NN`) from the explicit `indicationCode` extension on each `RegulatedAuthorization.indication[].extension[regulatedAuthorization-limitation]` (BAG SL FHIR export >= v2.0.5; handled from 3.0.10). The BAG changelog states the limitation code (`ClinicalUseDefinition.id`) and the indication code are **independent** fields, so the older derivation — combining each indication CUD's `.NN` id-suffix with the reimbursement RA's `FOPHDossierNumber` — is kept only as a fallback for feeds lacking the extension. Exposed as `item[:indication_codes]` and per-package `:indication_codes` (each entry a `{code:, cud_id:, text:}` hash, where `cud_id` is the `limitationIndication` CUD reference used to resolve the text). From 3.0.7 onwards, `Builder#build_product` emits one `<INDICATION_CODE code="XXXXX.NN" cud_id="DRUG.NN">limitation text</INDICATION_CODE>` child per indication on every `<PRD>` in `oddb_product.xml`; live feed numbers: 539 products / 1,293 codes / 100 % with non-empty indication text. Mandatory on prescriptions/invoices for SL price-model drugs from 2026-07-01 — see issue [#113](https://github.com/zdavatz/oddb2xml/issues/113). **Limitation texts** (3.0.8 onwards): the `regulatedAuthorization-limitation` extension has no inline `limitationText` in the live BAG feed — it carries a `limitationIndication` reference to a `ClinicalUseDefinition` whose `indication.diseaseSymptomProcedure.concept.text` is the actual text. The parser stores the ref as `cud_ref` on each Limitation, `Bundle#cud_text_by_id` resolves DE, and `merge_language` propagates FR/IT from the per-language NDJSON files via the same CUD id. Coverage on the live feed jumped from 0 / 9'108 to 9'108 / 9'108 (issue [#116](https://github.com/zdavatz/oddb2xml/issues/116)). **Limitation code / LIMNAMEBAG** (3.0.12 onwards): FHIR has no native BAG limitation code (LIMCD), so `create_limitations_for_package` sets `LimitationCode = cud_ref` (the `limitationIndication` CUD id) instead of `""`. Without this, every FHIR limitation shared an empty `:code`; `Builder#build_artikelstamm` groups its `<LIMITATIONS>` section by code, so all of them collapsed into a single `<LIMITATION>` with an empty `<LIMNAMEBAG>` and only one text survived. Using the CUD id as the key makes each distinct limitation emit and be referenced from its `<PRODUCT>`. The downstream `bin/check_artikelstamm` (`semantic_check.rb`) also crashed on the lone-element output because Ox `:hash_no_attrs` collapses a one-child section into a Hash (and an empty one into nil) — `SemanticCheckXML#get_items` now normalises every section to an Array. **v6 Artikelstamm / per-article INDC (3.0.26 onwards):** `--artikelstamm` now emits the **Elexis Artikelstamm v6** format (namespace `http://elexis.ch/Elexis_Artikelstamm_v6`, file `artikelstamm_DDMMYYYY_v6.xml`/`.csv`, validated against the bundled `Elexis_Artikelstamm_v6.xsd`) — replacing v5. The new piece is a per-`<ITEM>` `<ARTSL>` block carrying the BAG Indikationscodes (issue [#113](https://github.com/zdavatz/oddb2xml/issues/113)): `<PM>true</PM>` plus one `<ARTLIM>` per limitation with `<LIMCD>` (= `cud_ref`, the BAG limitation code), `<INDCD>` (the `XXXXX.NN` indication code from the `indicationCode` extension), and `<VDAT>`/`<VTDAT>` (period start/end). To feed it, `create_limitations_for_package` now also carries `IndicationCode` (→ per-package `:indcd`) and `ValidThruDate` (→ `:vtdate`) on each limitation; `Builder#append_artsl`/`elexis_datetime` emit one `<ARTLIM>` per limitation that has a non-empty `:indcd` (so non-price-model items get no `<ARTSL>`). `PM` is always `true` here because the indication code is required only for SL price-model drugs, which is exactly the set of items that reach this block. The bundled `Elexis_Artikelstamm_v6.xsd` is the canonical MEDEVIT schema extended with oddb2xml's historical Italian elements (`DSCRI` on PRODUCT/LIMITATION/ITEM, `DOSAGE_FORMI` on ITEM) so the output still validates. The legacy `--no-fhir` path emits no `<ARTSL>` (no FHIR limitations).
 
 8. **Refdata cleanup** (`lib/oddb2xml/refdata_cleanup.rb`) — Compensates for known data-quality issues in upstream Refdata.Articles.xml before they reach the output. Each fix is guarded by a Swissmedic-side heuristic (e.g. comma in `substance_swissmedic` to distinguish mono products from real combinations). Currently fixes (a) the doubled-dose template bug (`X mg / X mg / Stk`, `fix_double_dose`, guarded by `single_substance?`); (b) the spelled-out German galenic form `Retardtabletten` → house-style abbreviation `Ret Tabl` (`normalize_galenic_form` / `GALENIC_NORMALISATIONS`, issue #112 case #13, e.g. RINVOQ — a narrow word-boundary substitution that leaves legitimate brand suffixes like `TRAMAL retard` and Mepha's `Lactab` untouched); and (c) dose info Refdata dropped from `<FullName>`, sourced from the Swissmedic composition string `pack[:composition_swissmedic]` — `fix_missing_combo_dose` (#6, appends a combination's 2nd component strength), `fix_missing_dose` (#4, inserts a mono product's missing strength before the pack count), `fix_missing_volume` (#7, appends an injectable's per-pen volume); and (d) 50-char-truncation repairs — `fix_truncated_metoject` (#1, rebuilds METOJECT Autoinjektor names from the intact `<brand> Autoinjektor <dose>/<vol>` prefix + Swissmedic `size`, localised DE/FR/IT) and `fix_truncated_volume_unit` (#3, restores the cut `ml` of the VERACTIV Vitamin D3 drops). The (c) and (d) fixes are scoped to explicit IKSNR allow-lists (`COMBO_DOSE_IKSNR`/`MISSING_DOSE_IKSNR`/`MISSING_VOLUME_IKSNR`/`METOJECT_IKSNR`/`VERACTIV_VITD3_IKSNR`): a dry run proved a blanket heuristic mis-fires on hundreds of legitimate names (sodium counter-ion doses, strength-less phyto/powder products, concentration names like `CIMZIA 200 mg/ml`), so only catalogued registrations are touched — add an IKSNR to grow coverage. Called from `Builder#apply_refdata_description_cleanups!` at the start of `prepare_articles`. See GitHub issue #112 for the catalogue.
 
 9. **Chapter-70 hack** (`lib/oddb2xml/chapter_70_hack.rb`) — Legacy scraper for the SL "Komplementärarzneimittel" products (homeopathic/anthroposophic/phytotherapeutic), called only from `Builder#build_artikelstamm`. **Deprecated / non-FHIR only (3.0.11 onwards):** the source page `varia_De.htm` was rebuilt as a JavaScript SPA with no static data table, so the scraper now returns nothing there. These products + limitations now come through the FHIR feed (SL classification `20. KOMPLEMENTÄRARZNEIMITTEL`, 221 products on the live DE feed with real GTINs and limitation texts), so `build_artikelstamm` **skips the scraper entirely when `@options[:fhir]`** (the default for `--artikelstamm` since 3.0.9). In `--no-fhir` mode the scraper degrades gracefully (skips non-row/`<script>` nodes and empty tables, warns, returns `[]`) instead of raising `NoMethodError`. See GitHub issue #118.
 
-10. **Weleda / Kapitel-70 SL recovery** (`lib/oddb2xml/weleda_sl.rb`, 3.0.21 onwards) — Recovers the SL flag and public price for chapter-70 complementary medicines that are **missing from the FHIR feed** (the partial-replacement gap left by the dead chapter_70_hack, issue #118/#121). Many are magistral Weleda preparations with a `7611916…` trade GTIN that arrive only via ZurRose — with no SL flag and a blanked Publikumspreis (issue #117). `WeledaSL.load` joins two CSVs (downloaded at runtime from `github.com/zdavatz/oddb2xml_files` via `WeledaDownloader` / `BagSlGroupPricesDownloader`, bundled fallback copies under `data/`): `weleda_arzneimittel.csv` (GTIN → `abgabekategorie` SL flag + `csl` = **Pharma-Gruppen-Code**) and `bag_sl_group_prices.csv` (Pharma-Gruppen-Code → public price). The price table is extracted **offline** from the BAG SL definition PDF *"Homoeopathica, Anthroposophica, Allergene"* via `tools/generate_bag_sl_group_prices.rb` (uses system `pdftotext`; **no runtime PDF gem** — `pdf-reader`'s `afm` dep now needs Ruby ≥ 3.2, which would break the gem's Ruby floor). The join is **GTIN → csl → price**, honouring an `N x <code>` package multiplier (price = N × group price). Produces `gtin => {sl:, price:, csl:, abgabe:}` (SL rows only; ~515 priced on the live feed). **WALA products (3.0.22 onwards):** a third runtime CSV `wala_arzneimittel.csv` (GTIN prefix `7640187…`, `WalaDownloader`, bundled fallback) is merged into the same map via `WeledaSL.build_wala_map`. Its layout differs: `;`-separated with a BOM, no `/ SL` column (a row is SL when it carries a `CSL-Code` = Kapitel-70.01 group code), and the public **package** price is given inline in the `CSL 70.01.` column — **already multiplied for the pack size** (the multiplier appears only in the galenic-form text, e.g. `Solutio ad inj. 10 x 1 ml`), so it is taken **verbatim** rather than re-joined against `bag_sl_group_prices.csv` (which holds the per-unit price and would yield 1/10 of the package price for ~120 multi-unit packs). 320 WALA SL products on the live file; Weleda wins on the (unlikely) GTIN collision. `Builder#build_artikelstamm` consumes it (CLI sets `builder.weleda_sl` only for `--artikelstamm`): for any GTIN **absent from the FHIR NDJSON** it emits `<SL_ENTRY>true</SL_ENTRY>` and `<PPUB>` from the BAG group price, mirroring the old chapter-70 behaviour (`PHARMATYPE "P"`). **The FHIR/ZurRose price always wins** — the group price only fills a gap; a zeroed ZurRose `"0.00"` pub price is treated as absent so the gap-fill can apply. Match is **by GTIN only** (no pharmacode); the Swissmedic dispensing category is untouched (still from `Swissmedic_Packungen.xlsx`). The Artikelstamm output gets `<SL_ENTRY>` + `<PPUB>`; for the `-e`/`--extended` and `-b`/`--firstbase` product feeds the BAG public price is also added to `oddb_article.xml` as an `<ARTPRI><PTYP>BAGPUB</PTYP>` entry (the raw, often-blanked `ZURROSEPUB` is preserved alongside it) — `build_article`, gated by the CLI loading `weleda_sl` when `extended || firstbase || artikelstamm`. See GitHub issue #121.
+10. **Weleda / Kapitel-70 SL recovery** (`lib/oddb2xml/weleda_sl.rb`, 3.0.21 onwards) — Recovers the SL flag and public price for chapter-70 complementary medicines that are **missing from the FHIR feed** (the partial-replacement gap left by the dead chapter_70_hack, issue #118/#121). Many are magistral Weleda preparations with a `7611916…` trade GTIN that arrive only via ZurRose — with no SL flag and a blanked Publikumspreis (issue #117). `WeledaSL.load` joins two CSVs (downloaded at runtime from `github.com/zdavatz/oddb2xml_files` via `WeledaDownloader` / `BagSlGroupPricesDownloader`, bundled fallback copies under `data/`): `weleda_arzneimittel.csv` (GTIN → `abgabekategorie` SL flag + `csl` = **Pharma-Gruppen-Code**) and `bag_sl_group_prices.csv` (Pharma-Gruppen-Code → public price). `weleda_arzneimittel.csv` is **regenerated** by the Rust tool `weleda_scraper/` in the `oddb2xml_files` repo (`scraper --update weleda`, prompts for the medical.weleda.ch `PHPSESSID` cookie — never stored): it walks the paginated Arzneimittel-Verzeichnis listing + per-product detail pages and rewrites the CSV with exactly the currently-listed products (delisted rows dropped), preserving the on-disk format (column order, UTF-8, CRLF, quote-when-necessary, sorted by `id`) so oddb2xml reads it unchanged. The price table is extracted **offline** from the BAG SL definition PDF *"Homoeopathica, Anthroposophica, Allergene"* via `tools/generate_bag_sl_group_prices.rb` (uses system `pdftotext`; **no runtime PDF gem** — `pdf-reader`'s `afm` dep now needs Ruby ≥ 3.2, which would break the gem's Ruby floor). The join is **GTIN → csl → price**, honouring an `N x <code>` package multiplier (price = N × group price). Produces `gtin => {sl:, price:, csl:, abgabe:}` (SL rows only; ~515 priced on the live feed). **WALA products (3.0.22 onwards):** a third runtime CSV `wala_arzneimittel.csv` (GTIN prefix `7640187…`, `WalaDownloader`, bundled fallback) is merged into the same map via `WeledaSL.build_wala_map`. Its layout differs: `;`-separated with a BOM, no `/ SL` column (a row is SL when it carries a `CSL-Code` = Kapitel-70.01 group code), and the public **package** price is given inline in the `CSL 70.01.` column — **already multiplied for the pack size** (the multiplier appears only in the galenic-form text, e.g. `Solutio ad inj. 10 x 1 ml`), so it is taken **verbatim** rather than re-joined against `bag_sl_group_prices.csv` (which holds the per-unit price and would yield 1/10 of the package price for ~120 multi-unit packs). 320 WALA SL products on the live file; Weleda wins on the (unlikely) GTIN collision. `Builder#build_artikelstamm` consumes it (CLI sets `builder.weleda_sl` only for `--artikelstamm`): for any GTIN **absent from the FHIR NDJSON** it emits `<SL_ENTRY>true</SL_ENTRY>` and `<PPUB>` from the BAG group price, mirroring the old chapter-70 behaviour (`PHARMATYPE "P"`). **The FHIR/ZurRose price always wins** — the group price only fills a gap; a zeroed ZurRose `"0.00"` pub price is treated as absent so the gap-fill can apply. Match is **by GTIN only** (no pharmacode); the Swissmedic dispensing category is untouched (still from `Swissmedic_Packungen.xlsx`). The Artikelstamm output gets `<SL_ENTRY>` + `<PPUB>`; for the `-e`/`--extended` and `-b`/`--firstbase` product feeds the BAG public price is also added to `oddb_article.xml` as an `<ARTPRI><PTYP>BAGPUB</PTYP>` entry (the raw, often-blanked `ZURROSEPUB` is preserved alongside it) — `build_article`, gated by the CLI loading `weleda_sl` when `extended || firstbase || artikelstamm`. See GitHub issue #121.
 
 ### Key data identifiers
 - **GTIN/EAN13**: Primary article identifier (13-digit barcode)
@@ -64,6 +64,19 @@ The system follows a **download → extract → build → compress** pipeline:
 ### Static data overrides
 YAML files in `data/` provide manual overrides and mappings: `article_overrides.yaml`, `product_overrides.yaml`, `gtin2ignore.yaml`, `gal_forms.yaml`, `gal_groups.yaml`.
 
+## Deployment (`scripts/`) — the mediupdatexml.oddb.org download site
+
+These scripts run the public download server at `https://mediupdatexml.oddb.org` (Apache on this host) and are **not** part of the gem itself.
+
+- **`run_oddb2xml.sh`** — nightly build driver (cron: `0 1 * * * zdavatz`). Downloads the upstream sources **once**, then builds the `-b`/firstbase feed at price increments `45/50/55` plus `default` (no increment) into `$OUT_DIR` (`/home/zdavatz/oddb2xml`, one subdir each). The shared `downloads/` cache and transient zip live in `$BUILD_DIR` (`<OUT_DIR>-build`), **outside** `$OUT_DIR` so the transfer never uploads the multi-hundred-MB cache. Final step ("2b") regenerates the landing page. Each `oddb2xml` invocation is wrapped in `run_with_retry` (default **3 attempts, 120 s apart**, tunable via `ODDB2XML_RETRIES`/`ODDB2XML_RETRY_DELAY`): a transient upstream download failure (e.g. Swissmedic resetting the connection, `Errno::ECONNRESET`) previously aborted the whole `set -e` run 14 s in and left the feeds a day stale, so it now retries before giving up; a genuine repeated failure still stops the run.
+- **`generate_index_html.sh DOCROOT [FIRSTBASE_CSV]`** — single source of truth for the landing page. Writes `index.html` + a self-contained `logo.svg` **atomically** (temp + `mv`, so either owner — root from setup, `zdavatz` from cron — can refresh it). Computes live counts: PHARMA = `<SMNO>` count in `default/oddb_article.xml`, NONPHARMA = firstbase CSV rows − 1, total ART = `<ART ` count. Also runs **`visitor_stats.py`** and embeds its graph. Re-run standalone any time (it only reads already-built files); a separate cron line refreshes it **hourly** (`5 * * * * zdavatz`) so counts + graph stay current between nightly builds.
+- **`visitor_stats.py LOG_GLOB CACHE_DIR [DAYS]`** — emits the visitors/sessions/region graph as an inline-SVG HTML **fragment** (last `DAYS`, default 14): Besucher = distinct IPs/day, Sitzungen = 30-min-inactivity sessions per `(IP, User-Agent)`, plus a top-6 country breakdown by IP. Bots are filtered by User-Agent. Region lookup is **fully self-contained** — pure Python stdlib + the free **DB-IP country-lite CSV** (CC-BY, no licence key) cached in the build `downloads/` dir and refreshed monthly; **no apt package, no gem, no system GeoIP DB**. Prints nothing (page degrades to omitting the section) when the Apache log is unreadable or empty. Reading `/var/log/apache2` requires the cron user to be in the **`adm`** group (`sudo usermod -aG adm zdavatz`).
+- **`swissmedic_watch.sh`** — outage/block auto-recovery (cron: `*/30 * * * * zdavatz`). Since the Swissmedic platform migration (~2026-06-23, now a Swisscom-operated gateway), `www.swissmedic.ch` intermittently resets this host's automated connections **after the TLS handshake** (TCP RST), which aborts `run_oddb2xml.sh` under `set -e` and leaves the feeds stale (the block is host/IP- and client-fingerprint-sensitive: a real browser works, `curl`/`wget`/Ruby get reset, while other admin.ch hosts answer fine — so it is a WAF/bot rule, not an outage). The watcher polls Swissmedic with **oddb2xml's own client** (a Ruby `open-uri` canary on `listen_neu.html`); while blocked it is a silent no-op, and the moment it gets HTTP 200 it launches **one** build and emails. It fires **at most once per day** (stamp in `$STATE_DIR`, default `<OUT_DIR>-watch`, kept **outside** the wiped `$BUILD_DIR`), and skips when a build is already running or today's `default/oddb_article.xml` is already fresh. It exports `RBENV_VERSION=3.4.5` + the rbenv-shims PATH to match the nightly cron (the repo `.ruby-version` pins an uninstalled Ruby).
+- **`transfer.sh`** — optional hand-off (scp) of `$OUT_DIR` to the HIN host; `SCP_DEST` is required-but-unset until the HIN host is known.
+- **`setup_mediupdatexml_web.sh`** — one-time root setup of the Apache vhost + initial page.
+
+Only the scripts are git-tracked; the generated `index.html`/`logo.svg` and the `downloads/` cache are not.
+
 ## Testing
 
 - Framework: RSpec with flexmock (mocking), webmock + VCR (HTTP recording/playback)

data/Elexis_Artikelstamm_v6.xsd

@@ -0,0 +1,559 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Copyright (c) 2026 MEDEVIT. All rights reserved. This program and the
+	accompanying materials are made available under the terms of the Eclipse
+	Public License v1.0 which accompanies this distribution, and is available
+	at http://www.eclipse.org/legal/epl-v10.html v002
+	Contributors: MEDEVIT <office@medevit.at> - initial API and implementation -->
+<!-- oddb2xml note: this is the official Elexis_Artikelstamm_v6 schema extended
+     with the optional Italian-language elements (DSCRI on PRODUCT/LIMITATION/ITEM
+     and DOSAGE_FORMI on ITEM) that oddb2xml has emitted historically. These are
+     oddb2xml extensions and are NOT part of the canonical MEDEVIT v6 schema. -->
+<xs:schema targetNamespace="http://elexis.ch/Elexis_Artikelstamm_v6"
+	elementFormDefault="qualified" attributeFormDefault="unqualified"
+	version="6" id="Elexis_Artikelstamm_v006" xmlns="http://elexis.ch/Elexis_Artikelstamm_v6" xmlns:xs="http://www.w3.org/2001/XMLSchema">
+	<xs:element name="ARTIKELSTAMM">
+		<xs:annotation>
+			<xs:documentation xml:lang="EN">Information on medicaments
+			</xs:documentation>
+		</xs:annotation>
+		<xs:complexType>
+			<xs:sequence>
+				<xs:element name="PRODUCTS" minOccurs="1"
+					maxOccurs="1">
+					<xs:complexType>
+						<xs:sequence>
+							<xs:element name="PRODUCT" minOccurs="0"
+								maxOccurs="unbounded">
+								<xs:complexType>
+									<xs:sequence>
+										<xs:element name="PRODNO"
+											type="PRODNOType" minOccurs="1" maxOccurs="1">
+										</xs:element>
+                                        <xs:element name="SALECD" type="SALECDType" minOccurs="1" maxOccurs="1">
+										</xs:element>
+                                        <xs:element name="DSCR"
+											type="DSCRType" minOccurs="1" maxOccurs="1">
+										</xs:element>
+										<xs:element name="DSCRF"
+											type="DSCRType" minOccurs="1" maxOccurs="1">
+										</xs:element>
+										<xs:element name="DSCRI"
+											type="DSCRType" minOccurs="0" maxOccurs="1">
+											<xs:annotation>
+												<xs:documentation>oddb2xml extension: Italian description</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+                                        <xs:element name="ATC"
+											nillable="false" maxOccurs="1" minOccurs="0">
+											<xs:annotation>
+												<xs:documentation
+													xml:lang="EN">
+													ATC Code beinhaltet
+													Information ob Item
+													ein Impfstoff ist.
+													Dies ist der Fall
+													wenn der ATC Code
+													mit J07 startet.
+												</xs:documentation>
+											</xs:annotation>
+											<xs:simpleType>
+												<xs:restriction
+													base="xs:string">
+													<xs:maxLength
+														value="8" />
+												</xs:restriction>
+											</xs:simpleType>
+										</xs:element>
+										<xs:element name="LIMNAMEBAG"
+											type="xs:string" minOccurs="0" maxOccurs="1">
+										</xs:element>
+
+										<xs:element name="SUBSTANCE"
+											type="xs:string" minOccurs="0" maxOccurs="1">
+										</xs:element>
+										<xs:element name="SUBSTANCEF"
+											type="xs:string" minOccurs="0" maxOccurs="1">
+										</xs:element>
+									</xs:sequence>
+								</xs:complexType>
+								<xs:unique name="uniqueProdno">
+									<xs:selector xpath="PRODNO" />
+									<xs:field xpath="." />
+								</xs:unique>
+							</xs:element>
+						</xs:sequence>
+					</xs:complexType>
+				</xs:element>
+				<xs:element name="LIMITATIONS" minOccurs="1"
+					maxOccurs="1">
+					<xs:complexType>
+						<xs:sequence>
+							<xs:element name="LIMITATION" minOccurs="0"
+								maxOccurs="unbounded">
+								<xs:complexType>
+									<xs:sequence>
+										<xs:element name="LIMNAMEBAG"
+											type="xs:string" minOccurs="1" maxOccurs="1">
+										</xs:element>
+										<xs:element name="DSCR"
+											type="DSCRType" minOccurs="1" maxOccurs="1">
+										</xs:element>
+										<xs:element name="DSCRF"
+											type="DSCRType" minOccurs="1" maxOccurs="1">
+										</xs:element>
+										<xs:element name="DSCRI"
+											type="DSCRType" minOccurs="0" maxOccurs="1">
+											<xs:annotation>
+												<xs:documentation>oddb2xml extension: Italian description</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+										<xs:element
+											name="LIMITATION_PTS" type="xs:int" maxOccurs="1"
+											minOccurs="0">
+											<xs:annotation>
+												<xs:documentation>
+													Limitationspunkte
+												</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+									</xs:sequence>
+								</xs:complexType>
+							</xs:element>
+						</xs:sequence>
+					</xs:complexType>
+				</xs:element>
+
+				<xs:element name="ITEMS" minOccurs="1" maxOccurs="1">
+					<xs:complexType>
+						<xs:sequence>
+							<xs:element name="ITEM" minOccurs="0"
+								maxOccurs="unbounded">
+								<xs:complexType>
+									<xs:annotation>
+										<xs:documentation>
+											Packungsgröße verrechnet,
+											also Anzahl der beinhalteten
+											Elemente (bspw. 100
+											Tabletten)
+										</xs:documentation>
+									</xs:annotation>
+									<xs:sequence>
+
+										<xs:element name="GTIN"
+											nillable="false" minOccurs="0" maxOccurs="1">
+											<xs:annotation>
+												<xs:documentation
+													xml:lang="EN">
+													Reference number
+													(GTIN = Global trade
+													item number)
+												</xs:documentation>
+											</xs:annotation>
+											<xs:simpleType>
+												<xs:restriction
+													base="xs:string">
+
+												</xs:restriction>
+											</xs:simpleType>
+										</xs:element>
+										<xs:element name="PHAR"
+											nillable="false" minOccurs="0" maxOccurs="1">
+											<xs:annotation>
+												<xs:documentation
+													xml:lang="EN">
+													Pharmacode
+												</xs:documentation>
+											</xs:annotation>
+											<xs:simpleType>
+												<xs:restriction
+													base="xs:integer" />
+											</xs:simpleType>
+										</xs:element>
+
+
+                                        <xs:element name="SALECD" type="SALECDType" minOccurs="1" maxOccurs="1">
+											<xs:annotation>
+												<xs:documentation></xs:documentation>
+											</xs:annotation>
+										</xs:element>
+                                        <xs:element name="DSCR"
+											nillable="false" type="DSCRType" minOccurs="1"
+											maxOccurs="1">
+											<xs:annotation>
+												<xs:documentation
+													xml:lang="EN">
+													Product description,
+													e.g. Adalat retard
+													Tabletten 20 mg
+												</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+										<xs:element name="DSCRF"
+											type="xs:string" minOccurs="1" maxOccurs="1">
+										</xs:element>
+										<xs:element name="DSCRI"
+											type="xs:string" minOccurs="0" maxOccurs="1">
+											<xs:annotation>
+												<xs:documentation>oddb2xml extension: Italian description</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+										<xs:element name="COMP"
+											minOccurs="0">
+											<xs:annotation>
+												<xs:documentation
+													xml:lang="EN">
+													Manufacturer
+												</xs:documentation>
+											</xs:annotation>
+											<xs:complexType>
+												<xs:sequence>
+													<xs:element
+														name="NAME" minOccurs="0" maxOccurs="1">
+														<xs:annotation>
+															<xs:documentation>
+																CompanyName
+															</xs:documentation>
+														</xs:annotation>
+														<xs:simpleType>
+															<xs:restriction
+																base="xs:string">
+																<xs:maxLength
+																	value="101" />
+															</xs:restriction>
+														</xs:simpleType>
+													</xs:element>
+													<xs:element
+														name="GLN" nillable="false" minOccurs="0" maxOccurs="1">
+														<xs:annotation>
+															<xs:documentation
+																xml:lang="EN">
+																Company
+																GLN
+															</xs:documentation>
+														</xs:annotation>
+														<xs:simpleType>
+															<xs:restriction
+																base="xs:string">
+																<xs:maxLength
+																	value="13" />
+															</xs:restriction>
+														</xs:simpleType>
+													</xs:element>
+												</xs:sequence>
+											</xs:complexType>
+										</xs:element>
+										<xs:element name="PEXF"
+											type="xs:double" minOccurs="0" maxOccurs="1">
+											<xs:annotation>
+												<xs:documentation>
+													Exfactorypreis in
+													Franken und Rappen
+													(exkl. MWSt)
+												</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+										<xs:element name="PPUB"
+											type="xs:double" minOccurs="0" maxOccurs="1">
+											<xs:annotation>
+												<xs:documentation>
+													Publikumspreis in
+													Franken und Rappen
+													(inkl.MWSt)
+												</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+										<xs:element name="PKG_SIZE"
+											type="xs:int" maxOccurs="1" minOccurs="0">
+										</xs:element>
+                                        <xs:element name="MEASURE" type="xs:string" minOccurs="0" maxOccurs="1">
+											<xs:annotation>
+												<xs:documentation>
+													Measurement Unit,
+													e.g. Pills or
+													milliliters
+												</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+                                        <xs:element
+											name="MEASUREF" type="xs:string" minOccurs="0"
+											maxOccurs="1">
+										</xs:element>
+                                        <xs:element name="DOSAGE_FORM" type="xs:string" minOccurs="0" maxOccurs="1">
+											<xs:annotation>
+												<xs:documentation>
+													Die Darreichungsform
+													dieses Items. zB
+													Tablette(n) oder
+													Spritze(n)
+												</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+                                        <xs:element name="DOSAGE_FORMF" type="xs:string" minOccurs="0" maxOccurs="1">
+                                            <xs:annotation>
+                                            	<xs:documentation>Die Darreichungsform dieses Items. zB Tablette(n) oder Spritze(n) in französicher Sprache
+										</xs:documentation>
+                                            </xs:annotation>
+										</xs:element>
+                                        <xs:element name="DOSAGE_FORMI" type="xs:string" minOccurs="0" maxOccurs="1">
+                                            <xs:annotation>
+                                            	<xs:documentation>oddb2xml extension: Darreichungsform in italienischer Sprache</xs:documentation>
+                                            </xs:annotation>
+										</xs:element>
+                                        <xs:element name="SL_ENTRY"
+											type="xs:boolean" minOccurs="0" maxOccurs="1">
+											<xs:annotation>
+												<xs:documentation>
+													Item ist in der
+													Spezialitätenliste
+													(SL) eingetragen
+												</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+										<xs:element name="IKSCAT"
+											maxOccurs="1" minOccurs="0">
+											<xs:annotation>
+												<xs:documentation>
+													Abgabekategorie
+												</xs:documentation>
+											</xs:annotation>
+
+											<xs:simpleType>
+												<xs:annotation>
+													<xs:documentation>
+														Abgabekategorie,
+														A-E A:
+														verschärft
+														rezeptpflichtig
+														B:
+														Rezeptpflichtig
+														C: erhältlich in
+														Apotheken ohne
+														Rezept D:
+														erhältlich in
+														Apotheken und
+														Drogerien E:
+														keine
+														Kategorisierung
+													</xs:documentation>
+												</xs:annotation>
+												<xs:restriction
+													base="xs:string">
+													<xs:enumeration
+														value="A">
+													</xs:enumeration>
+													<xs:enumeration
+														value="B">
+													</xs:enumeration>
+													<xs:enumeration
+														value="C">
+													</xs:enumeration>
+													<xs:enumeration
+														value="D">
+													</xs:enumeration>
+													<xs:enumeration
+														value="E">
+													</xs:enumeration>
+												</xs:restriction>
+											</xs:simpleType>
+										</xs:element>
+										<xs:element name="GENERIC_TYPE"
+											maxOccurs="1" minOccurs="0">
+
+											<xs:simpleType>
+												<xs:annotation>
+													<xs:documentation>
+														O Original G
+														Generikum K
+														Komplementärprodukt
+													</xs:documentation>
+												</xs:annotation>
+												<xs:restriction
+													base="xs:string">
+													<xs:enumeration
+														value="O">
+													</xs:enumeration>
+													<xs:enumeration
+														value="G">
+													</xs:enumeration>
+													<xs:enumeration
+														value="K">
+													</xs:enumeration>
+												</xs:restriction>
+											</xs:simpleType>
+										</xs:element>
+										<xs:element name="HAS_GENERIC"
+											type="xs:boolean" minOccurs="0" maxOccurs="1">
+											<xs:annotation>
+												<xs:documentation>
+													Generikum zu diesem
+													Produkt vorhanden
+													ja/nein
+												</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+										<xs:element name="LPPV"
+											type="xs:boolean" maxOccurs="1" minOccurs="0">
+											<xs:annotation>
+												<xs:documentation>
+													Ist eingetragen in
+													Liste
+													pharmazeutischer
+													Präparate mit
+													spezieller
+													Verwendung (LPPV)
+												</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+
+										<xs:element name="DEDUCTIBLE"
+											type="xs:int" maxOccurs="1" minOccurs="0">
+											<xs:annotation>
+												<xs:documentation>
+													Selbstbehalt für
+													SL-Produkte in
+													prozent
+												</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+										<xs:element name="NARCOTIC"
+											type="xs:boolean" maxOccurs="1" minOccurs="0">
+											<xs:annotation>
+												<xs:documentation>
+													Produkt ist
+													Betäubungsmittel
+													ja/nein
+												</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+										<xs:element name="NARCOTIC_CAS"
+											type="xs:string" maxOccurs="1" minOccurs="0">
+											<xs:annotation>
+												<xs:documentation>
+													Wenn
+													Betäubungsmittel
+													(NARCOTIC == true)
+													dann CAS Register
+													Nummer des Artikels
+												</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+
+										<xs:element name="PRODNO"
+											minOccurs="0" maxOccurs="1" type="PRODNOType">
+											<xs:annotation>
+												<xs:documentation>
+													Produktnummer des
+													Artikels
+												</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+
+										<xs:element name="ARTSL" minOccurs="0" maxOccurs="1">
+											<xs:annotation>
+												<xs:documentation>
+													Daten aus der BAG Spezialitätenliste (SL)
+												</xs:documentation>
+											</xs:annotation>
+											<xs:complexType>
+												<xs:sequence>
+											        <xs:element name="PM" type="xs:boolean"/>
+											        <xs:element name="ARTLIMS" minOccurs="1" maxOccurs="1">
+											        	<xs:complexType>
+															<xs:sequence>
+																<xs:element name="ARTLIM" minOccurs="0"
+																		maxOccurs="unbounded">
+																		<xs:complexType>
+																			<xs:sequence>
+																				<xs:element name="LIMCD" type="xs:string"/>
+																				<xs:element name="INDCD" type="xs:string"/>
+																				<xs:element name="VDAT" type="xs:dateTime" minOccurs="0"/>
+																				<xs:element name="VTDAT" type="xs:dateTime" minOccurs="0"/>
+																			</xs:sequence>
+																		</xs:complexType>
+																</xs:element>
+															</xs:sequence>
+														</xs:complexType>
+											        </xs:element>
+											    </xs:sequence>
+											</xs:complexType>
+										</xs:element>
+									</xs:sequence>
+
+									<xs:attribute name="PHARMATYPE">
+										<xs:annotation>
+											<xs:documentation>P Pharma, N Non-Pharma
+											</xs:documentation>
+										</xs:annotation>
+										<xs:simpleType>
+											<xs:restriction
+												base="xs:string">
+												<xs:enumeration
+													value="N">
+												</xs:enumeration>
+												<xs:enumeration
+													value="P">
+												</xs:enumeration>
+											</xs:restriction>
+										</xs:simpleType>
+									</xs:attribute>
+								</xs:complexType>
+							</xs:element>
+						</xs:sequence>
+					</xs:complexType>
+				</xs:element>
+			</xs:sequence>
+			<xs:attribute name="CREATION_DATETIME" type="xs:dateTime"
+				use="required">
+				<xs:annotation>
+					<xs:documentation>Erstellungszeitpunkt des QuellDatensatzes (siehe DATA_SOURCE)
+					</xs:documentation>
+				</xs:annotation>
+			</xs:attribute>
+
+			<xs:attribute name="BUILD_DATETIME" type="xs:dateTime">
+				<xs:annotation>
+					<xs:documentation>Der Zeitpunkt zu dem dieser Datensatz erstellt wurde.
+					</xs:documentation>
+				</xs:annotation>
+			</xs:attribute>
+			<xs:attribute name="DATA_SOURCE" type="DATASOURCEType">
+				<xs:annotation>
+					<xs:documentation></xs:documentation>
+				</xs:annotation></xs:attribute>
+		</xs:complexType>
+	</xs:element>
+
+
+
+
+	<xs:simpleType name="PRODNOType">
+		<xs:restriction base="xs:string"></xs:restriction>
+	</xs:simpleType>
+
+	<xs:simpleType name="DSCRType">
+		<xs:restriction base="xs:string"></xs:restriction>
+	</xs:simpleType>
+
+
+
+	<xs:simpleType name="DATASOURCEType">
+		<xs:annotation>
+			<xs:documentation>The data source this Artikelstamm is generated from.
+			</xs:documentation>
+		</xs:annotation>
+		<xs:restriction base="xs:string">
+			<xs:enumeration value="oddb2xml"></xs:enumeration>
+			<xs:enumeration value="medindex"></xs:enumeration>
+		</xs:restriction>
+	</xs:simpleType>
+
+	<xs:simpleType name="SALECDType">
+        <xs:annotation>
+        	<xs:documentation>Bedeutung ist 'A' = Aktiv,'I' = inaktiv == Ausser Handel</xs:documentation>
+        </xs:annotation>
+        <xs:restriction base="xs:string">
+			<xs:enumeration value="I"></xs:enumeration>
+			<xs:enumeration value="A"></xs:enumeration>
+		</xs:restriction>
+	</xs:simpleType>
+</xs:schema>

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    oddb2xml (3.0.25)
+    oddb2xml (3.0.26)
       csv
       htmlentities
       httpi