Messaging
Veridian Motion includes secure internal messaging between the care team (staff) and inmates. Messaging supports follow-up after assessment — especially when a PT sets status to needs_followup — without opening external SMS, email, or web links.Design rules
| Rule | Detail |
|---|---|
| Internal only | No SMS, email to inmates, or external URLs |
| Append-only | Messages cannot be edited or deleted after send |
| Monitored | UI displays that messages are monitored / part of the medical record |
| No external egress | Server blocks outbound delivery outside the app |
| RLS-scoped | Inmates see only their own threads; staff see threads per role and assignment |
Who can message
| Role | Typical messaging access |
|---|---|
| pt | Message assigned patients regarding their assessments and follow-up |
| admin | Operational messaging per policy; not a substitute for PT clinical review |
| officer / warden | Generally no clinical messaging unless explicitly granted by deployment policy |
| Inmate | Reply within threads on their own record from the kiosk |
Where messaging lives
Staff — open messaging from the patient record or assessment review screen in the provider dashboard (/dashboard). Threads are tied to the
patient’s care record.
Inmate — access messaging from the kiosk after sign-in, alongside My
plan / progress. Inmates cannot start arbitrary conversations with staff
outside the product’s workflow rules; they respond within active care threads.
Typical workflow
PT sets needs_followup
After review, the PT marks needs_followup when additional information
or clarification is needed before releasing or updating a plan.
Staff sends a message
The PT (or authorized staff) sends a plain-language question or instruction
in the secure thread. The inmate sees the monitored / medical record
notice.
Inmate responds on kiosk
The inmate reads and replies during a supervised kiosk session. Replies are
append-only.
What messaging is not
- Not live chat support — asynchronous only; no guaranteed response time SLA in MVP
- Not video or phone — no live video consults in the current release
- Not external email — PDF export to allowlisted addresses is a separate, staff-only tool for records handoff
- Not private or ephemeral — all messages are retained per agency retention policy
Custody considerations
Custody staff should supervise inmate messaging sessions the same as intake. Inmates should not expect confidential communications outside the monitored record. Facility policy governs whether messaging occurs during medical escort blocks or scheduled kiosk time.Audit
Every message send is recorded in the append-only audit log (action type and resource ID — not message body in audit payload). See Data model & privacy.What’s next
Status and workflow
needs_followup and review transitions.
Provider dashboard
Review tools and PDF export.
Inmate kiosk flow
Kiosk session and supervision.