hk-site-display

Hong Kong construction site notice: live Labour Department Heat Stress at Work Warning (HSWW) and HKO extreme weather on one screen at the gate.

Official HKO / Labour Department icons and notice wording only. Rest times follow Guidance Notes on Prevention of Heat Stroke at Work (3rd ed.) Appendix 4. Not a 4S system. Not a sensor product.

Same URL for landscape and portrait. Two-second glance: one action, every in-force sign in the rail.

Live demo

Live	https://hksite-display.loadingtechnology.app/
Preview (switch cases; does not overlay live)	https://hksite-display.loadingtechnology.app/?preview=1
Gallery (every official icon + case)	https://hksite-display.loadingtechnology.app/?gallery=1

Same URL, portrait:

Rules the notice will not break

• HSWW level comes only from hkhi_icon.xml iconIndex (30 amber / 32 red / 34 black). Never inferred from HKHI CSV or the title string.
• Rest minutes live in config/rest_schedule.json only.
• Warning marks are official HKO/LD files. We do not draw substitute typhoon / rain / heat symbols.
• GET /api/v1/snapshot is always live. POST /sim is preview-only.

Data sources

• HSWW: https://www.hko.gov.hk/wxinfo/hkhi/hkhi_icon.xml
• Weather warnings: HKO Open Data warnsum + warningInfo
• Icons: originals in apps/kiosk/public/official/

Ingest polls every 60s. The notice refreshes /api/v1/snapshot every 30s.

Local run

.venv/Scripts/python.exe -m uvicorn app.main:app --app-dir services/ingest --host 127.0.0.1 --port 8000
cd apps/kiosk && npm install && npm run dev

• http://localhost:5173/ — live fullscreen
• http://localhost:5173/?preview=1 — fixture preview
• http://localhost:5173/?gallery=1 — every official icon and signal case

python -m pytest tests -q (use .venv/Scripts/python.exe).

Deploy

docker compose up --build -d

Open http://SERVER_IP/ (live). Do not commit .env, origin certificates, or real site names; copy config/sites/demo-site.json.