← Back to the EquatorGuard prototype

EquatorGuard: technical documentation, assumptions and limitations

EquatorGuard is a heat-risk early warning tool for outdoor crews. It answers what a site-wide reading cannot: which workers face the most risk today, and what should the supervisor do?

Working prototype for the Future Health Digital Innovation Challenge (Population Health · Climate-Resilient Worker Health). Real weather data, synthetic demo roster. Not yet piloted. Not a medical device.

1. How it works

Built for Abu Dhabi first. Abu Dhabi's code of practice (ADOSH-SF CoP 11.0) manages heat with Thermal Work Limit zones measured on site. TWL assumes workers are acclimatized, and its zone table says "No unacclimatised person to work" in Medium and High Risk zones: new workers, or anyone off work more than 14 days. A heat meter cannot know who that is. An attendance system does. EquatorGuard joins the two.

  1. The supervisor enters the site's TWL zone from the instrument. EquatorGuard shows the official controls for that zone, word for word from Table 1, and lists who must not be assigned.
  2. From attendance (demo roster, or a CSV the user loads, processed in the browser only): new starters, days away, long runs of shifts. Each worker gets today's allowed share of work from the guideline's acclimatization and re-acclimatization tables. No medical data is needed.
  3. An hourly heat-load forecast (estimated WBGT from weather data) ranks the day and finds the coolest window for heavy tasks.
  4. Crew instructions and individual decisions are acknowledged by a supervisor and kept in an audit trail. Worker messages are ready in English, Arabic, Hindi, Urdu and Indonesian. If signs of heat illness are reported, the guideline's first-aid steps are shown and an escalation is logged.

Where TWL is not used (the second demo site, an open-pit coal mine in East Kalimantan, Indonesia, with a synthetic crew), the same engine applies NIOSH limits to estimated WBGT and gives allowable work minutes per hour.

Rules decide. AI explains. A person acts. Levels and actions come from a deterministic rule engine. A language model only words the shift briefing, from facts that are shown next to it.

2. Architecture

PartWhat it doesTechnology
Rule engineTWL zone rules (Table 1), acclimatization tables, NIOSH limits and allowable minutes, levels, crew summaries, CSV import, first-aid stringsTypeScript, pure functions, unit-tested. Runs in the browser in the prototype; on the server in a pilot, so decisions are logged at the source.
Worker APIFetches the hourly forecast and computes estimated WBGT for sun and shade; stores the audit log and the last good forecast; calls the language model for the briefingCloudflare Workers, Cloudflare D1, Cloudflare Workers AI (Meta Llama 3.3 70B Instruct)
DashboardSupervisor and site-manager views, worker drawer, site display, measures, back-test, data and governance pagesPlain TypeScript, no UI framework, hand-written SVG charts; about 41 kB compressed
Offline layerKeeps the app and the last forecast on the device; says when it is showing saved dataService worker, network-first pages, cached hashed assets

Data flow: site instrument reading (TWL zone or WBGT) + attendance and roster + hourly weather → rule engine → crew instructions, individual decisions, coolest window, worker messages, site display → supervisor acknowledges → audit trail. Fallback: weather service unreachable → last good forecast → manual entry of the site reading.

3. Methods

Estimated WBGT

Liljegren et al. (2008), as implemented in ECMWF thermofeel 2.3.0 (Apache-2.0) and used operationally by KNMI, ported to TypeScript. Inputs from Open-Meteo: air temperature, relative humidity, surface pressure, 10 m wind, instantaneous global and direct radiation, and the solar zenith angle (NOAA solar position). Covered or indoor work uses the same method with solar radiation set to zero. The result is an estimate for an unshaded point from gridded weather, not an on-site reading.

NIOSH limits and allowable work minutes

NIOSH (2016) RAL = 59.9 − 14.1 log₁₀M and REL = 56.7 − 11.5 log₁₀M (°C-WBGT, M in watts; §8.1). The REL applies to acclimatized workers and the RAL to unacclimatized workers. Metabolic heat is taken on a 1-hour time-weighted basis including rest (§1.1.3). Workload classes: light 200 W, moderate 300 W, heavy 415 W, very heavy 520 W, each inside its NIOSH class (Table 5-1); resting 117 W. Clothing adjustments from Table 3-2 are added to the WBGT. Allowable work minutes = the share of the hour at the task rate, with the rest at 117 W in the same conditions, that keeps the 1-hour average within the worker's limit.

Abu Dhabi zones and acclimatization

ADOSH-SF Technical Guideline – Safety in the Heat, v4.0 (15 July 2024): Table 1 (zones, interventions, rehydration and work-rest schedules, shown verbatim), §3 (acclimatization: new employee 20/40/60/80/100%, experienced employee 50/60/80/100/100%; re-acclimatization by days away), §4 (signs and first-aid steps, shown verbatim). Unacclimatised = new workers, or off work more than 14 days (Table 1, note b).

Levels

Abu Dhabi site: the level follows the entered zone and Table 1 (work allowed with a work-rest cycle is "Restricted"; people who may not be assigned are listed separately). NIOSH site: level cut-offs on allowable minutes per hour at 60, 45 and 15 (configurable site rule).

Configurable site rules (not NIOSH or ADOSH values)

4. Data sources

SourceTypeOwnerPersonal data
Weather forecast and historyEnvironmental, hourly, griddedOpen-Meteo (forecast; historical best match of ECMWF IFS, ERA5, ERA5-Land); CC BY 4.0None
Attendance and shiftsOperationalEmployer; in the prototype synthetic, or a CSV the user loads, processed in the browser onlyPilot: worker ID, shift times, days worked. Prototype: none stored
Task and PPE profileOperationalSite supervisorNone
Site instrument reading (TWL zone or WBGT)Environmental measurementSite HSE teamNone
Acknowledgement logOperational recordSiteWorker ID and action taken. Escalations are logged at crew level, without the worker or the symptoms.

Not collected, by design: health status, medical history, wearable or biometric signals, location tracking, productivity figures.

5. Assumptions

6. Limitations

7. Validation

8. Privacy, security and responsible AI

9. Deployment and scale

Serverless on Cloudflare's edge network, with no servers to run. A new site is a configuration entry (location, time zone, site standard, crews). The page is about 41 kB compressed and works on any phone, tablet or TV a site already has; there are no sensors or wearables to charge or to fail in dust. Path to pilot: one Abu Dhabi site with a contractor's HSE team and an occupational health partner; attendance by CSV export first, then API; TWL readings entered by hand first, then read from the instrument's export; the rule engine moves to the server so decisions are logged at the source; in-country hosting.

10. API

EndpointPurpose
GET /api/weather?site=abudhabi|ekalimantan48 hours of forecast with estimated WBGT for sun and shade; falls back to the last good forecast
GET/POST/DELETE /api/acks?session=…Demo audit trail, scoped to an anonymous session; capped per session and per day
POST /api/briefingShift briefing worded by the language model from the facts given; template text if unavailable

11. References