# Audits and inspections

> Audit programmes, inspections numbered AUD-2026-001 with a team and a checklist form, findings typed as nonconformities, observations or opportunities, and cases opened from nonconformities before an inspection closes.

- Category: Work management
- Module: `inspections`
- Modes: `managed`, `custom`
- Docs: https://bettersupabase.com/docs/blocks/inspections
- Page: https://bettersupabase.com/blocks/inspections

## Install

```bash
npx better-supabase add inspections
```

The command also installs `updated-at`, `memberships`, `jsonb-schemas`, `permissions`, `subjects`, `forms`.

## Configure

Add the block to `better-supabase.config.ts`:

```ts
import { defineConfig } from "better-supabase/config";

export default defineConfig({
  blocks: {
    // Required by inspections; add installs them too.
    "updated-at": {},
    memberships: {},
    "jsonb-schemas": {},
    permissions: {},
    subjects: {},
    forms: {},
    // Modes: "managed", "custom". The default is "managed".
    inspections: { mode: "managed" },
  },
});
```

## Client

The block has no React entry yet. Its server-side TypeScript is in `better-supabase/blocks/inspections`.

## Events

- `inspection.cancelled`
- `inspection.closed`
- `inspection.completed`
- `inspection.scheduled`
- `inspection.started`
- `inspection.updated`
- `inspection_finding.created`
- `inspection_finding.deleted`
- `inspection_finding.updated`
- `inspection_program.approved`
- `inspection_program.closed`
- `inspection_program.created`
- `inspection_program.updated`

## Related blocks

Requires: [memberships](https://bettersupabase.com/blocks/memberships.md), [permissions](https://bettersupabase.com/blocks/permissions.md), [subjects](https://bettersupabase.com/blocks/subjects.md), [forms](https://bettersupabase.com/blocks/forms.md)

Works with: [cases](https://bettersupabase.com/blocks/cases.md), [compliance](https://bettersupabase.com/blocks/compliance.md), [relations](https://bettersupabase.com/blocks/relations.md), [numbering](https://bettersupabase.com/blocks/numbering.md), [calendar](https://bettersupabase.com/blocks/calendar.md), [notifications](https://bettersupabase.com/blocks/notifications.md), [outbox](https://bettersupabase.com/blocks/outbox.md), [audit](https://bettersupabase.com/blocks/audit.md)

## Recipes

- [Inspection programme calendar](https://bettersupabase.com/recipes/inspection-program-calendar.md): The audit programme in a data grid: each inspection in the month it is planned, with its number, kind, programme and status.
- [Inspection run](https://bettersupabase.com/recipes/inspection-run.md): One inspection with its status, checklist and team, its findings with a Raise case button for each nonconformity, and a Close button once every one has its case.