Glossary
The words this project uses in a specific way. Code, messages and docs all follow them.
Devices
- NS-C1a real device
The hardware: a vaporizer with an nRF9151 cellular chip (LTE-M and GNSS). In this project, “device” on its own always means these.
- Device ID8BFBC681DFDFACE7
The chip’s 16-character ID. It’s also the device’s name in AWS IoT (its “thing”) and its MQTT client ID.
- Virtual deviceVIRTUAL-<12 hex>
An Android app that acts as one device and talks to AWS exactly like one, until the hardware ships.
- Fleet simulatoremul-001 …
Generates many devices and owners offline, as a dataset, to test and score models. Nothing reaches AWS.
- Draw
One inhalation on the device, recorded with its start time.
- Pod
The cartridge. The device reports when one is attached or removed.
AWS IoT
- Thing
A device’s entry in AWS IoT, named by its device ID, with its own certificate attached.
- Device shadow
AWS IoT’s stored copy of a device’s state. We write the lock state we want (desired); the device applies it and writes back what it did (reported).
- Topic rule
A small SQL filter in IoT Core that copies matching MQTT messages somewhere else. Ours copy them to the ingest queue.
- Device policy
What a device’s certificate allows: connect as itself, publish its own telemetry, use its own shadow. Nothing else.
Backend
- Stage
One complete, separate copy of the system:
dev,stagingorproduction, each in its own AWS account.- Ingest
The Lambda that receives every device message, stores it and reacts to it.
- Outbox
The database table of commands waiting to go to devices (lock, unlock) and SMS waiting to be sent.
- Modelowner-change/v1
A versioned piece of detection logic that reads a device’s events and makes decisions. A version’s ID is never reused.
- Trust ladder
The rules that turn decisions into locks, deadlines and SMS.
- Temp lock / hard lock
A temp lock waits for a re-verification. A hard lock follows 3 failures or a missed deadline, and needs a new face check.
People
- Owner
The person a device is registered to. Signs in to the web app with their phone number.
- Admin userAdmin or Staff
A Nosaint team member who signs in to the admin app.
Say this, not that
| Say | Not | Why |
|---|---|---|
| virtual device | simulator, simulated device, device | Keeps it apart from real devices and the fleet simulator |
| fleet simulator | simulator | It makes datasets, not live devices |
| draw | (the old word) | One word everywhere, in code, data and docs |