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

# Assessments

> Dynamic, weighted-scoring questionnaires for repeatable governance reviews.

Assessments are structured questionnaires you fill in periodically — per app, per release, per audit. Each template scores answers and feeds the result into the [Risk Dashboard](./risk-dashboard) and [Compliance heatmap](../compliance/gap-analysis-heatmap).

***

## Concepts

| Model                  | What it represents                                                                  |
| ---------------------- | ----------------------------------------------------------------------------------- |
| **AssessmentTemplate** | The questionnaire definition. Ordered sections, ordered questions, scoring weights. |
| **Assessment**         | One filled-in (or in-progress) instance of a template, scoped to an app or org.     |

A template renders dynamically: questions can be conditional ("if previous answer was 'yes', show…"). The total score is a weighted sum across answered questions.

***

## Building a template

<Steps>
  <Step title="Open Assessments → Templates">
    Click **New template**.
  </Step>

  <Step title="Add sections">
    Sections group related questions. They render as collapsible blocks when the assessment is taken.
  </Step>

  <Step title="Add questions">
    Each question has: type (yes/no, multi-choice, free-text), weight, and an optional conditional reveal rule.
  </Step>

  <Step title="Define the scoring">
    Map each answer to a numeric value. The template score is sum of (answer value × question weight).
  </Step>

  <Step title="Publish">
    Once published, the template appears under **Take assessment** for everyone in the org.
  </Step>
</Steps>

***

## Taking an assessment

The take-assessment drawer renders the template progressively:

* Conditional questions appear only after their trigger answer is selected
* Progress bar at the top
* Save-as-draft button to leave and resume later
* Submit button only enabled when all required questions are answered

On submit, Observatory computes the score, stores the answers, and surfaces the result on Risk Dashboard and Compliance heatmap.

***

## Use cases

<CardGroup cols={2}>
  <Card title="Pre-deployment review" icon="rocket">
    Run an "AI release readiness" template against each app before promoting to production.
  </Card>

  <Card title="Quarterly risk review" icon="calendar">
    A "risk review" template per app, scheduled by the GRC team.
  </Card>

  <Card title="Vendor model intake" icon="truck">
    A "third-party model assessment" template that gates onboarding of new providers.
  </Card>

  <Card title="Compliance attestation" icon="clipboard-check">
    Framework-specific templates that produce evidence-ready answers (EU AI Act, NIST RMF).
  </Card>
</CardGroup>

***

## API

| Endpoint                            | Use                                     |
| ----------------------------------- | --------------------------------------- |
| `GET /api/assessments/templates`    | List templates.                         |
| `POST /api/assessments/templates`   | Create.                                 |
| `GET /api/assessments`              | List assessments (draft + submitted).   |
| `POST /api/assessments`             | Start a new assessment from a template. |
| `POST /api/assessments/{id}/submit` | Submit final answers.                   |

***

## Related resources

<CardGroup cols={2}>
  <Card title="Risk Dashboard" icon="triangle-exclamation" href="./risk-dashboard">
    Assessment scores are one input to the risk score.
  </Card>

  <Card title="Evidence" icon="folder-open" href="./evidence">
    Submitted assessments can be promoted to evidence.
  </Card>
</CardGroup>