architecture docs
Overview

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, staging or production, 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