E-skierowanie medycyny pracy (MP)
Slug: mp
Typ nośnika: HL7 CDA Release 2 (generowany przez plugin systemowy; po stronie API.ERP: Attachment · po stronie API.MED: DocumentReference)
Powierzchnie API: API.ERP (Attachment) · API.MED (DocumentReference)
Status: draft
Wersja profilu CDA: v0.3 (skierowanie) · v0.1 propozycja (orzeczenie)
Zakres
Pakiet pionowy obejmuje dwa powiązane dokumenty CDA wymienialne między pracodawcą a podmiotem służby medycyny pracy (PSMP):
| Dokument | Status | Kierunek | Specyfikacja |
|---|---|---|---|
| E-skierowanie na badanie MP | draft v0.3 | KS-ZZL (Plugin → API.ERP) → PSMP (API.MED → Plugin) | profile/profil-cda.md |
| Orzeczenie lekarskie MP | propozycja v0.1 | PSMP (Plugin → API.MED) → KS-ZZL (API.ERP → Plugin) | profile/orzeczenie-cda.md |
Rola pluginu systemowego: tworzenie, konwersja i obsługa CDA leży całkowicie po stronie pluginu systemowego (w KS-ZZL lub systemie klinicznym PSMP). API.ERP transportuje dokument jako Attachment, API.MED jako DocumentReference — żadna ze stron nie analizuje wewnętrznej struktury XML.
Profil prywatny KAMSOFT — bez przepływu przez Platformę P1.
Mapowanie na domeny
| Nr | Domena | Uwagi |
|---|---|---|
| 15 | HR / HCM | dane pracownika, stanowisko, BHP |
| 19 | Technology & Integration | kanały wymiany, API.ERP / API.MED |
Szczegóły zasobów domenowych HR — w api-contracts.md (placeholdery bez zmian).
Struktura pakietu
| Katalog | Zawartość |
|---|---|
| profile/ | profil-cda.md — skierowanie; orzeczenie-cda.md — orzeczenie (v0.1); oid-status.md |
| contracts/ | skierowanie_mp_input.schema.json; orzeczenie_mp_input.schema.json; OpenAPI REST — TBD |
| models/ | Mapowanie JSON → CDA |
| samples/ | XML v0.1–v0.3, referencje P1 |
| reference/ | XSL CeZ, drzewo OID, stanowiska/czynniki |
| tools/ | Generator XML v0.3, testy smoke |
| scenarios/ | referral-lifecycle.md |
Value sety (oh-*) |
JSON w IG (7 plików); źródło: value-sets/ w repo; profil-cda § ValueSet.url |
Edycja specyfikacji CDA w IG
Treść strony Profil CDA to plik Markdown — edytuj profile/profil-cda.md. MkDocs buduje stronę HTML w site/ (jak pozostałe dokumenty IG).
| Plik | Rola |
|---|---|
| profile/profil-cda.md | Źródło — specyfikacja skierowania (Markdown) |
| profile/orzeczenie-cda.md | Źródło — specyfikacja orzeczenia (Markdown, propozycja v0.1) |
Po zmianie uruchom ./scripts/build.sh lub ./scripts/serve.sh z katalogu głównego repozytorium.
Szybki start (generator XML — narzędzie pluginu / referencyjne)
Generator w tools/ jest implementacją referencyjną pluginu systemowego dla skierowania. Produkcyjny plugin w KS-ZZL może korzystać z tej samej logiki lub z niezależnej implementacji zgodnej z profilem.
cd tools
pip install -r requirements.txt
python3 generate_skierowanie_mp.py -i examples/minimal_skierowanie.json -o ../samples/wygenerowane.xml
python3 test_smoke_generator.py -v
Indeks IG: API-ERP-MP-dokumentacja.md · verticals-index.md