# Baltique OS Core 2.6.0
## Enterprise Hospital Command Center / Strategic Floor View

### Cel
Stworzenie jednego, wspólnego, operacyjnego ekranu dla personelu klinicznego, pokazującego cały oddział/szpital w formie realnego rzutu obiektu, z warstwą pacjentów, łóżek, PACU, sal operacyjnych, recepcji, farmacji, magazynu, zadań i alertów. Ekran ma zastąpić „przeskakiwanie” pomiędzy zakładkami.

---

## Nazwa modułu
**Enterprise Hospital Command Center**

Alternatywne nazwy robocze:
- Strategic Floor Board
- Live Hospital Map
- Ward & OR Command Center
- Digital Twin Live Operations Board

---

## Główna zasada UX
Jedna plansza. Jeden ekran. Jeden wspólny widok oddziału.

Użytkownik nie przechodzi między wieloma zakładkami, tylko pracuje na:
- rzucie szpitala,
- kafelkach kontekstowych,
- warstwach rolowych,
- bocznym panelu szczegółów,
- pasku priorytetów.

---

## Struktura ekranu 1-screen

### 1. Górny pasek operacyjny
Widoczne zawsze:
- lokalizacja / oddział / piętro,
- data i godzina,
- status dnia operacyjnego,
- liczba pacjentów na oddziale,
- liczba pacjentów w PACU,
- liczba operacji dziś,
- liczba zadań krytycznych,
- liczba zadań oczekujących,
- filtr roli,
- przełącznik warstw,
- wyszukiwarka pacjenta / łóżka / sali / zadania.

### 2. Lewy panel priorytetów
Sekcja zadań i alertów, np.:
- pilne zadania,
- pacjenci HOLD,
- brakujące badania,
- brakujące dokumenty,
- czerwone flagi PACU,
- opóźnienia sal,
- farmacja do wydania,
- implanty do potwierdzenia,
- zadania recepcji,
- zadania magazynu.

Każdy wpis klikalny i centrujący mapę na odpowiednim obiekcie.

### 3. Centrum — rzeczywisty rzut szpitala
Interaktywny SVG / floor plan.
Pokazuje:
- recepcję,
- pokoje,
- łóżka,
- PACU,
- sale operacyjne,
- punkt pielęgniarski,
- farmację,
- magazyn,
- diagnostykę,
- komunikację między strefami.

Na rzucie widoczne są:
- pacjenci w łóżkach,
- status łóżka,
- status sali,
- status PACU,
- personel / assignment,
- bieżące alerty,
- liczniki zadań.

### 4. Prawy panel kontekstowy
Po kliknięciu obiektu pokazuje szczegóły:
- dla pacjenta,
- dla łóżka,
- dla sali operacyjnej,
- dla PACU,
- dla farmacji,
- dla magazynu,
- dla recepcji.

### 5. Dolny pasek warstw / legendy
Warstwy do włączania/wyłączania:
- pacjenci,
- zadania,
- dokumenty,
- badania,
- zgody,
- płatności,
- OR,
- PACU,
- farmacja,
- magazyn,
- personel,
- alarmy,
- discharge / aftercare.

---

## Obiekty na mapie i ich kafelki

### A. Łóżko / pacjent na oddziale
Każde łóżko pokazuje mini-kafelek z:
- imię i nazwisko / inicjały,
- identyfikator,
- zabieg,
- lekarz prowadzący,
- status: GO / HOLD / NO-GO,
- etap: pre-op / post-op / PACU / discharge,
- kolor ryzyka,
- liczba zadań,
- brakujące elementy.

Po kliknięciu otwierają się kafelki pacjenta:
- Tożsamość i kontakt,
- Badania,
- Dokumenty i zgody,
- Płatności,
- Clearance anestezjologiczne,
- Plan operacyjny,
- Implant / wyroby,
- Leczenie i zlecenia,
- PACU / wypis,
- Zadania do wykonania,
- Komunikacja z pacjentem.

#### Status kolorystyczny pacjenta
- zielony: gotowy / stabilny,
- bursztynowy: wymaga uwagi,
- czerwony: blocker / alarm,
- niebieski: w toku,
- szary: brak danych / nieaktywny.

### B. Recepcja
Kafle recepcji:
- przyjęcia na dziś,
- oczekujący pacjenci,
- brakujące dokumenty,
- niezamknięte płatności,
- check-in / check-out,
- wiadomości do obsługi,
- transport / pokój / łóżko.

### C. PACU
Kafle PACU:
- liczba pacjentów,
- skale recovery,
- wypisy gotowe,
- red flags,
- leki / zlecenia,
- potwierdzenie odbioru zaleceń,
- oczekujące konsultacje.

### D. Sala operacyjna
Kafle OR:
- status sali,
- aktualny pacjent,
- następny pacjent,
- start / delay,
- checklisty,
- zespół,
- implanty / instrumentarium,
- Time Out / SITE,
- przewidywany koniec,
- blokery.

### E. Farmacja
Kafle farmacji:
- zlecenia do wydania,
- leki oczekujące,
- braki magazynowe,
- cold-chain / expiry,
- przypisanie do pacjenta,
- wysokie ryzyko / narkotyki,
- potwierdzenia wydania.

### F. Magazyn
Kafle magazynu:
- implanty zarezerwowane,
- lot / serial,
- recalled / quarantine,
- niskie stany,
- braki na zabieg dzisiejszy,
- przygotowanie zestawów,
- zadania inwentaryzacyjne.

---

## Warstwy rolowe

### Chirurg
Widok akcentuje:
- status pacjentów,
- badania,
- zgody,
- GO/HOLD,
- plan zabiegów,
- implanty,
- alerty kliniczne.

### Recepcja / koordynacja
Widok akcentuje:
- check-in,
- dokumenty,
- płatności,
- zgody,
- brakujące dane,
- komunikację.

### Pielęgniarka
Widok akcentuje:
- leżących pacjentów,
- zadania bieżące,
- leki,
- parametry,
- wypisy,
- PACU,
- alarmy.

### OR Manager
Widok akcentuje:
- sale,
- kolejkę operacji,
- opóźnienia,
- readiness,
- zespoły,
- PACU downstream.

### Farmacja
Widok akcentuje:
- zlecenia lekowe,
- wydania,
- blokady,
- braki,
- traceability.

### Magazyn
Widok akcentuje:
- implanty,
- zestawy,
- zapasy,
- lot/serial,
- pilne pobrania.

### Administracja / zarząd
Widok akcentuje:
- obłożenie,
- bottlenecks,
- KPI dnia,
- ryzyka,
- blokery procesu.

---

## Zasady informacji na 1 ekranie
1. **Najpierw priorytet, potem szczegół.**
2. **Kolor = status, nie dekoracja.**
3. **Kliknięcie nie przenosi do innej zakładki, tylko rozwija szczegóły kontekstowe.**
4. **Rola widzi to, co użyteczne, a nie cały chaos systemu.**
5. **Każdy obiekt ma liczniki i stan gotowości.**
6. **Najważniejsze zadania zawsze w lewym panelu.**
7. **Rzut szpitala jest źródłem orientacji.**

---

## Minimalne funkcje operacyjne
- filtrowanie po lokalizacji / oddziale / piętrze,
- przełącznik „Wszystkie miejsca”,
- ukrywanie planowanych obiektów,
- wyszukiwanie pacjenta / łóżka / sali,
- otwieranie szczegółów bez przeładowania strony,
- szybkie akcje z poziomu kafelka,
- szybkie zaznaczenie zadania jako wykonane,
- szybkie dodanie blocker / note,
- przejście do pełnego rekordu tylko gdy naprawdę potrzebne.

---

## Model danych (logiczny)

### Główne źródła
- enterprise_sites
- site_map_layers / svg polygons
- hospital_beds
- hospital_rooms
- operative_cases
- patients
- work_queue
- communication drafts
- documents / consent
- labs / evidence
- pharmacy_orders
- inventory / implants
- pacu episodes
- staff assignments
- OR event stream

### Widok agregujący
Należy wytworzyć jedną warstwę agregującą, np.:
- `enterprise_command_center_view`
- `enterprise_command_center_tasks`
- `enterprise_command_center_patient_cards`
- `enterprise_command_center_or_cards`
- `enterprise_command_center_inventory_cards`

Tak, aby frontend nie wykonywał setek drobnych zapytań.

---

## Architektura modułu

### Backend
Nowy moduł aplikacyjny:
- `app/enterprise_hospital_command_center.php`

Nowe strony / endpointy:
- `/system_hospital_command_center.php`
- `/api/command_center_state.php`
- `/api/command_center_object.php`
- `/api/command_center_quick_action.php`
- `/api/command_center_role_view.php`

### Frontend
- SVG floor engine,
- warstwa pan/zoom,
- live badges / counters,
- right-side context drawer,
- left-side priority rail,
- role presets,
- WebSocket/polling layer.

### Real-time
Preferowane:
- krótki polling lub event stream,
- odświeżanie tylko zmienionych kart,
- brak pełnego reloadu planszy.

---

## Widok jednego pacjenta na mapie
Kafelek przy łóżku powinien zawierać skrócone ikony:
- ID
- LAB
- DOC
- CONSENT
- PAY
- OR
- PACU
- RX
- TASKS

Kolor ikony:
- zielony = OK,
- bursztynowy = uwaga,
- czerwony = blocker,
- szary = brak / nie dotyczy.

---

## Zadania do uwypuklenia
Na planszy muszą być szczególnie widoczne:
- zadania overdue,
- brak zgody,
- brak badań,
- brak płatności,
- HOLD / NO-GO,
- brak PACU capacity,
- opóźnienie sali operacyjnej,
- implant recall,
- lek do natychmiastowego wydania,
- brak wypisu / zaleceń,
- red flag pooperacyjna.

---

## Najważniejsze KPI na 1 ekranie
- liczba pacjentów aktywnych,
- liczba pacjentów GO / HOLD / NO-GO,
- liczba łóżek zajętych / wolnych,
- PACU occupancy,
- liczba zabiegów w toku / opóźnionych,
- zadania krytyczne,
- zadania overdue,
- alerty kliniczne,
- alerty operacyjne,
- alerty farmacja / magazyn.

---

## Bezpieczeństwo i role
- pełna kontrola uprawnień per obiekt i per akcja,
- role nie widzą zbędnych danych,
- quick actions logowane w audit trail,
- brak automatycznych decyzji klinicznych,
- brak automatycznych zmian GO/HOLD bez governance,
- brak auto-send do pacjenta bez zatwierdzenia.

---

## Etapy wdrożenia

### Etap 1 — szkielet operacyjny
- strona główna command center,
- panel lokalizacji,
- wczytanie SVG planu,
- łóżka, sale, recepcja, PACU,
- prawa kolumna szczegółów,
- lewy panel zadań.

### Etap 2 — pacjenci i zadania
- karty pacjentów przy łóżkach,
- task highlighting,
- quick actions,
- GO/HOLD badges,
- dokumenty / badania / zgody / płatności.

### Etap 3 — OR / PACU / farmacja / magazyn
- integracja OR event stream,
- PACU occupancy,
- pharmacy work tiles,
- inventory / implant tiles.

### Etap 4 — role presets i real-time
- rolowe widoki,
- priorytetyzacja per rola,
- odświeżanie incremental,
- skróty klawiaturowe.

### Etap 5 — digital twin live overlay
- przewidywane opóźnienia,
- obciążenie łóżek / PACU,
- rekomendacje operacyjne jako warstwa pomocnicza.

---

## Kryteria sukcesu
1. Personel większość dnia może pracować na jednym ekranie.
2. Recepcja widzi swoje zadania bez przechodzenia między modułami.
3. Pielęgniarka widzi pacjentów i najważniejsze zadania przy łóżkach.
4. OR Manager widzi cały przepływ operacyjny i skutki dla PACU.
5. Farmacja i magazyn widzą zadania w sposób kontekstowy.
6. Kliknięcie obiektu daje szczegóły, a nie chaos.
7. System jest użyteczny w realnym środowisku pracy.

---

## Najlepsza nazwa do wdrożenia
**Baltique OS — Hospital Command Center**

Podtytuł:
**Live Strategic Floor View for Clinical Operations**