> ## Documentation Index
> Fetch the complete documentation index at: https://docs.veridianhp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Platform overview

> Technical scope, MVP features, and architecture for Veridian Motion.

# Platform overview

For product vision, facility impact, and end-to-end case flow, start with
[Veridian Motion](/veridian-motion/product). This page covers technical scope
and MVP features as built.

Veridian Motion is Veridian Health Partners' **flagship physical therapy
platform** for correctional facilities — a posture and musculoskeletal (MSK)
triage system with an inmate kiosk and provider dashboard. Inmates describe
what hurts and capture standardized posture photos; licensed PTs review
AI-assisted triage support and release exercise recommendations when
appropriate.

## What it is

| Surface                | Users                         | Purpose                                                                |
| ---------------------- | ----------------------------- | ---------------------------------------------------------------------- |
| **Inmate kiosk**       | Inmates (inmate number + PIN) | Body-map intake, complaint, four-view photos, status and approved plan |
| **Provider dashboard** | Staff (email + MFA)           | Roster, enrollment, assignment, review, messaging, export              |

Both surfaces run in one **TanStack Start** web application (React 19),
backed by **Supabase** (Postgres, Auth, Storage) via Lovable Cloud. The app
is an **installable PWA** hardened for facility kiosk use.

## What it is not

* **Not a diagnosis tool.** Output is triage support — observations,
  hypotheses, red-flag alerts, and graded bodyweight exercise plans — always
  labeled non-diagnostic until a PT reviews.
* **Not a replacement for in-person care.** Red flags and clinical judgment
  may require hands-on evaluation through existing facility protocols.
* **Not live video, EHR, or API connectivity.** The current release is
  asynchronous kiosk + dashboard only. Integration features may come later.
* **Not a certified compliance package.** The app implements HIPAA-aligned
  design controls; certification, CJIS hosting, and FedRAMP authorization
  are agency responsibilities. See [Security overview](/security/overview).

## The PT-review authority principle

Nothing from AI reaches an inmate until a **licensed PT marks the assessment
reviewed**. After submit, inmates see only confirmation and plain-language
safety guidance. AI findings and draft exercise plans appear only in the
provider dashboard until released.

## MVP scope (as built)

**Inmate kiosk**

* Staff-provisioned accounts (inmate number + PIN)
* Body-map region selector + complaint (typed; voice-to-text where supported)
* Guided four-view photo capture (front, back, left, right) with silhouettes
* Post-submit confirmation; plan/progress view with status tracking
* Approved exercise plan and shared PT notes **only after review**

**Provider dashboard**

* Role-based access (`pt`, `admin`, `officer`, `warden`, `it_admin`)
* Patient roster, enrollment (returns number + initial PIN), unassigned queue
* Full assessment review with photos, AI output, draft plan, notes, statuses
* AI note summarization; PDF export; allowlisted email send
* Secure internal messaging (append-only, monitored, no external egress)

**AI**

* Multi-provider router (Anthropic Claude → OpenAI GPT → xAI Grok → fallback)
* Model recorded per assessment; shown to PT ("Generated by …")

## Who uses Veridian Motion

**Inmates** — complete intake on facility-controlled kiosk devices using
credentials staff provide. No self sign-up.

**Physical therapists** — review assessments, adjust plans, add notes, set
status, release content to inmates when ready.

**Administrators** — enroll patients, assign cases, grant roles, reset MFA,
manage operational workflow.

**Officers, wardens, IT admins** — scoped access per role for operational
and security functions as configured.

## What's next

<CardGroup cols={2}>
  <Card title="Veridian Motion" icon="person-running" href="/veridian-motion/product">
    Flagship product — vision, case flow, PT-first workflow.
  </Card>

  <Card title="Inmate kiosk flow" icon="tablet-screen" href="/veridian-motion/inmate-kiosk-flow">
    Step-by-step authenticated intake.
  </Card>

  <Card title="Provider dashboard" icon="user-doctor" href="/veridian-motion/provider-dashboard">
    Roster, review, messaging, export.
  </Card>

  <Card title="Getting started" icon="rocket" href="/veridian-motion/getting-started">
    Facility rollout checklist.
  </Card>

  <Card title="Status and workflow" icon="diagram-project" href="/veridian-motion/status-and-workflow">
    Status map and handoffs.
  </Card>

  <Card title="Role permissions" icon="table" href="/veridian-motion/role-permissions">
    Permission matrix by role.
  </Card>

  <Card title="Deployment and kiosk" icon="lock" href="/veridian-motion/deployment-and-kiosk">
    PWA install and kiosk hardening.
  </Card>
</CardGroup>