Software Design Document
Włodzimierz Bartczak (2022) wersja 0.1
NZK do którego dochodzi poza szpitalem (OHCA - Out of Hospital Cardiac Arrest) jest trzecią najczęstszą przyczyną zgonów w Europie i stanowi istotny problem zdrowia publicznego na całym świecie. NZK w większości ma podłoże kardiologiczne (najczęściej zawał serca i inne ostre zespoły wieńcowe), ale także może być spowodowany przyczynami poza sercowymi (zatrzymanie oddechu, uraz wielonarządowy, wykrwawienie). W Polsce w 2018 roku 40,5% ogółu zgonów spowodowanych było chorobami układu krążenia, spośród których 59% stanowiły choroby serca, co jest znacznie częstsze niż w bogatszych krajach UE. Mimo wzrostu liczby zgonów w Polsce w 2020 roku z powodu pandemii SARS-CoV-2, których ogólna liczba jest najwyższa od kilkudziesięciu lat, ich główną przyczyną niezmiennie pozostają choroby układu krążenia (źródło danych: GUS, 2021 r.).
Cytując Wytyczne Europejskiej Rady Resuscytacji (ERC 2021), roczna częstotliwość występowania pozaszpitalnego zatrzymania krążenia (OHCA) w Europie wynosi 67-170 przypadków na 100 000 mieszkańców, gdzie dolną wartość występowania OHCA w Europie wyznaczyło badanie przeprowadzone w Polsce w Bielsku-Białej (nie ma w Polsce ogólnopolskiego rejestru NZK) opublikowane w Kardiologii Polskiej w 2016 roku. Przeżywalność w Europie po wystąpieniu OHCA do czasu wypisu ze szpitala wynosi średnio 8% i waha się w zakresie 0-18%.
Przeżywalność po OHCA można znacznie zwiększyć, jeśli natychmiast podejmie się resuscytację oraz zostanie użyty automatyczny defibrylator zewnętrzny (AED - Automated External Defibrillator). Zastosowanie AED przez osoby bez przeszkolenia medycznego umożliwia podjęcie próby defibrylacji na klika minut przed przybyciem profesjonalnej pomocy medycznej. Defibrylacja w ciągu 3-5 minut od OHCA może zapewnić przeżywalność na poziomie 50-70%. Każda minuta opóźnienia w wykonaniu defibrylacji zmniejsza prawdopodobieństwo przeżycia do wypisu ze szpitala średnio o 3-5%, pod warunkiem prowadzenia resuscytacji. W przypadku jej braku prawdopodobieństwo przeżycia zmniejsza się o 10-12% na minutę opóźnienia defibrylacji.
Wśród wytycznych ERC znajdują się takie, które zalecają tworzenie map i jak najszersze udostępnianie informacji o lokalizacjach publicznie dostępnych defibrylatorów. Niestety większość dostępnych danych na temat lokalizacji AED jest tworzona w ramach projektów komercyjnych i dane zbierane przez te podmioty, nie są udostępnione szerokiemu odbiorcy, co znacznie utrudnia ich przetwarzanie i analizę przez niezależnych specjalistów.
OSMP jest twórcą oraz administratorem mapy lokalizacji defibratorów na terenie Polski. Użytkownik ma możliwość pobierania aktualnych danych oraz po zalogowaniu możliwość ich dodawania i edycji na bieżąco w bazie OpenStreetMap. Obecnie pracujemy, by znacząco poszerzyć funkcjonalność naszego portalu oraz rozszerzyć jego zasięg z Polski na cały świat. Tym samym chcemy utworzyć pierwszą całkowicie darmową i kompleksową bazę lokalizacji urządzeń AED na świecie.
Nasze analizy wykazały, że wiele lokalizacji AED na terenie Europy jest dostępnych w bazie danych projektu OpenStreetMap, chcielibyśmy w prosty sposób te dane udostępnić. Jednocześnie, dzięki doświadczeniu zdobytemu we wcześniejszych projektach, umożliwić dodawanie oraz edycję informacji o tych urządzeniach jak największej grupie osób, niekoniecznie posiadających umiejętności cyfrowe niezbędne do takich zadań.
Dokument obejmuje swoim zakresem utworzenie portalu openaedmap.org, z interfejsem dostępnym w kilku językach, rozbudowaniu obecnej funkcjonalności o możliwość dodawania fotografii AED w celu ich weryfikacji oraz szybszego zlokalizowaniu ich w terenie. Umożliwi opracowanie mechanizmu pozwalającego pobierać dane AED dla poszczególnych krajów, nie tylko jak obecnie dla Polski. Wypracowanie modułów analitycznych pozwalających użytkownikom lepsze pozycjonowanie kolejnych urządzeń.
- AED - Automated External Defibrillator, czyli automatyczny defibrylator zewnętrzny,
- ERC - European Resuscitation Council - Europejska Rada Resuscytacji,
- JST - Jednostka Samorządu Terytorialnego,
- NZK - nagłe zatrzymanie krążenia,
- OSMP - Stowarzyszenie OpenStreetMap Polska,
- OSMF - Fundacja OpenStreetMap z siedzibą w Londynie,
- OSM - OpenStreetMap,
- UE - Unia Europejska,
- QA - Quality Assurance - analiza i zapewnienie jakości.
Przegląd poszczególnych funkcjonalności portalu
Wersja beta już działa.
Wyszukiwanie lokalizacji
- Rodzaj dostępności
- Czy wewnętrz budynku?
- Opisz dokładna lokalizację (pl):
- Tłumaczenie eng (do potwierdzenia - domyślne DEEP?)
- Numer kontaktowy do operatora
- Data weryfikacji
- Dodanie atomatycznego opisu zmiany oraz hastagu
- Komunikat dla opisu urządzenia(W przypadku braku dodania opisu upewnia się czy napewno chcesz dodać bez opisu)
- Wymuszenie dodania access
- Dodanie boxów informujących [?] dla każdego pola
- Opisanie obowiązujących pól
- Button "Zgłoś problem"
- Urządzenie nie działa / jest uszkodzone
- Urządzenei nie znajduje się w tym miejscu
- Błedne zdjęce
- Button "Edit" - edytowanie w OpenAedMpa, rozbudowanie funkcjonalności
- Rodzaj dostępności
- Czy wewnętrz budynku?
- Opisz dokładna lokalizację (pl):
- Tłumaczenie eng (do potwierdzenia - domyślne DEEP?)
- Numer kontaktowy do operatora
- Data weryfikacji
- Zmień loklizację
- Komunikat przy zapisie jesli brak dokładnego opisu lokalizacji urządzenia
- Zgoda na
Pobieranie danych za pomocą Dashbordu? (Patrz Figma)
- Dedykowana strona do pobierania danych z podziałem dla poszcególnych krajów
- Informacja o licencji ODbL podczas pobierania danych lokalizacji
- Podział na kraje
Generowanie kodu QR dla każdego urządzenia z jego lokalizacją. Pozwalający na pobranie takiego kodu w formie .svg lub .pdf.
Moduł pozwalający generować podstawowe analizy dotyczące lokalizacji urządzeń AED.
Moduł tworzący warstwę danych pokazującą obiekty, w których powinny znajdować się urządzenia AED zgodnie z listą obiektów rekomendowanych. Rekomendacje obejmują obiekty generujące ruch oraz odosobnione, które wymagają instalacji AED ze względu na czas potrzebny do zapewnienia pomocy medycznej.
Listę trzeba przerobić na tabelę oraz dodać do niej tagi i typy obiektów
- Stacje kolejowe.
- Porty lotnicze.
- Terminale autobusów dalekobieżnych.
- Terminale portowe i promowe.
- Miejsca odpoczynku na drogach ekspresowych (miejsca obsługi podróżnych) oraz przydrożne obiekty wypoczynkowe.
- Galerie, parki i inne obiekty handlowe, w tym sklepy wielkopowierzchniowe i supermarkety.
- Budynki użyteczności publicznej:
- ratusze, starostwa, urzędy wojewódzkie oraz ich filie,
- domy kultury,
- świetlice wiejskie i środowiskowe,
- biblioteki,
- komisariaty i posterunki policji oraz straży miejskiej,
- remizy strażackie,
- budynki i obiekty w zarządzie Lasów Państwowych,
- powiatowe i wojewódzkie stacje sanitarno-epidemiologiczne.
- Domy pomocy społecznej, centra usług społecznych, zakłady aktywizacji zawodowej, placówki opiekuńcze dla osób starszych.
- Placówki edukacyjne:
- przedszkola,
- szkoły podstawowe,
- szkoły średnie,
- uczelnie wyższe,
- pozostałe placówki edukacyjne.
- Przedsiębiorstwa oraz fabryki i zakłady produkcyjne.
- Obiekty rekreacyjne i sportowe:
- stadiony,
- siłownie,
- sale fitness,
- baseny pływackie,
- stacje narciarskie - w pobliżu wyciągów.
- Duże hotele, centra kongresowe oraz ośrodki wypoczynkowe.
- Obiekty w odległych i słabo zaludnionych obszarach, takie jak:
- schroniska turystyczne,
- wyspy i obszary górskie.
Tabela w postaci linków do strony kraju z poszczególnymi statystykami
Zebranie statystyk dla kraju w formie tabeli oraz wykresu w zależności od danych
| Statystyka | Forma | Opis |
|---|---|---|
| TOP30 Edytorów | Tabela | linki do kont OSM |
| AED bez opisu | Wykres | Wykres pokazujący wszystkie AED do tych bez opisu lokalizacji w języku rodzimym |
| AED bez opisu | Tabela | Lista z linkami do poszczególnych urządzeń |
| AED bez access | Wykres | Wykres pokazujący wszystkie AED do tych bez oznaczenia dostępu w języku rodzimym |
| AED bez access | Tabela | Lista z linkami do poszczególnych urządzeń |
| AED bez defibrillator:location:en | Wykres | Wykres pokazujący wszystkie AED do tych bez opisu loklizacji w języku angielskim |
| AED bez defibrillator:location:en | Tabela | Lista z linkami do poszczególnych urządzeń |
Moduł generujący raport oraz prezentujący możliwe błędy lub braki w danych urządzeń AED i umożliwiający ich poprawienie
Sprawdzanie czy istnieje opis w języku angielskim jako opcja - Przetłumacz?
Dedykowany podkład skupiający się na wyświetlaniu danych przydatnych ratownikom medycznym
| Kategoria | Obiekt |
|---|---|
| Medyczne | Szpital |
| Medyczne | SOR |
| Medyczne | Izba przyjęć |
| Medyczne | Oddział Szpitalny |
| Medyczne | Przychodnia |
| Medyczne | Apteka |
| Medyczne | Punkt krwiodawstwa |
| Medyczne | Punkt dializ |
| Medyczne | Dentysta |
| Medyczne | Hospicjum |
| Medyczne | Bank Krwi |
| Medyczne | Laboratorium |
| Medyczne | Punkt szczepień |
| Medyczne | Punkt pobrań laboratoryjnych |
| Medyczne | Punkt opatrunkowy |
| Medyczne | Apteczka |
| Medyczne | AED |
| Medyczne | Gabinet lekarski (ze wskazaniem specjalności) |
| Medyczne | Gabinet pielęgniarski |
| Medyczne | Stacja pogotowia ratunkowego |
| Medyczne | Baza HEMS (LPR w Polsce) |
| Medyczne | Lądowisko HEMS (aeroway=helipad) |
| Strażackie | Hydrant |
| Strażackie | Punkt poboru wody |
| Strażackie | Pikietaż dróg |
| Strażackie | Punkt lądowania śmigłowców (landing_site) |
| Strażackie | Drogi pożarowe |
| Strażackie | Przyłącze zasilania istalacji ppoż w budynku |
| Strażackie | Jednostka ratowniczo-gaśnicza |
| Strażackie | Remiza |
| Strażackie | Centrala alarmowa (np. niemieckie BMZ) |
| Strażackie | Gaśnica |
| Strażackie | Wąż strażacki |
| Policyjne | Komisariat |
| Policyjne | Posterunek policji wodnej |
| Policyjne | Straż miejska |
| Wodne | SAR |
| Wodne | Stacja ratownictwa wodnego |
| Wodne | Wieża ratownicza |
| Wodne | Koło ratunkowe |
| Inne | Stacja ratownictwa górskiego |
| Inne | Schronisko górskie |
- Automatyczne proponowanie tłumaczenia na język angielski.
- Trzeba będzie tworzyć raporty na poszczególne jednostki administracyjne.