🛡 Safe2Go — Safety Logic

flowchart TD
  A["User sets up Safety Profile:
up to 5 emergency contacts + 4-digit safety code"] --> B["Starts a journey and turns on SAFETY MODE"]
  B --> C["Server opens a safety session
(route, legs, live-location link, local police number)"]
  C --> D{"Off the planned route?
more than 500 m for 60 s
(phone screen OR background GPS)"}
  D -- no --> D
  D -- yes --> P1["ARE YOU SAFE? — check 1 of 3
30 seconds"]
  P1 --> Q1{"Code entered?"}
  Q1 -- "correct code" --> SAFE["You're Safe ✅
back to monitoring"]
  Q1 -- "reverse (duress) code" --> DUR["Screen shows 'You're Safe' ✅
BUT everyone is alerted immediately"]
  Q1 -- "no code in 30 s" --> P2["Check 2 of 3 — 30 seconds"]
  P2 --> Q2{"Code entered?"}
  Q2 -- correct --> SAFE
  Q2 -- duress --> DUR
  Q2 -- "no code in 30 s" --> P3["Check 3 of 3 — FINAL — 30 seconds"]
  P3 --> Q3{"Code entered?"}
  Q3 -- correct --> SAFE
  Q3 -- duress --> DUR
  Q3 -- "no code in 30 s" --> ESC["🆘 ESCALATE (after 90 s)"]
  DUR --> ESCD["🆘 ESCALATE silently"]
  ESC --> OUT["Every contact: email + SMS + automated phone call
with last location, live-tracking link,
and 'call the police (local number)'"]
  ESCD --> OUT
  ESC --> SCR["User's screen: EMERGENCY ALERT SENT
📞 Call police button + 📍 your location"]
  SCR --> AC{"User enters correct code later?"}
  AC -- yes --> ALL["All contacts told:
'they have confirmed they are safe'"]

flowchart LR
  A["Someone forces the user
to say they're safe"] --> B["User enters the code
REVERSED, e.g. 4321"]
  B --> C["Screen: 'You're Safe!' ✅
identical to the real code"]
  B --> D["Session looks normal
(nothing visible changes)"]
  B --> E["Server immediately alerts ALL contacts:
email + SMS + call
'URGENT — may be in danger, forced to appear safe'
+ location + call the police"]

flowchart TD
  G["User's latest GPS position"] --> C{"Country lookup
(mobility_graph DB)"}
  C --> B["Country boundary polygons
(authoritative where available)"]
  C --> P["Nearest place within 15 km
(covers small countries: SG, MT, MC, BH, HK…)"]
  B --> ISO["Country code, e.g. DE"]
  P --> ISO
  ISO --> T["Police table → police 110 / emergency 112"]
  T --> W["Refreshed when moved more than 10 km or every 10 min,
and looked up FRESH at the moment of any alert"]
  C -- "no country (e.g. at sea)" --> F["Fallback 112
(works from any mobile phone in most countries)"]