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

# Chemical Records

> Record pool chemistry test readings and let AquaOps evaluate them against each pool's configured profile.

Chemical Records is the core operational module in AquaOps.

## Purpose

Use this module to record pool chemistry test readings and let the system evaluate those readings against each pool's configured profile.

## Best for

* daily chemistry testing
* supervisor review of out-of-range readings
* audit-friendly water quality recordkeeping

## List page

Go to:

```text theme={null}
Chemical Records
```

The list page supports filtering by:

* location
* pool
* start date
* end date

### Desktop view

Desktop shows a table with:

* time
* location/pool
* submitted by
* free chlorine
* total chlorine
* combined chlorine
* pH
* alkalinity
* calcium hardness
* pool temperature
* LSI
* overall status

### Mobile view

Mobile shows tap-friendly cards with the most important summary values.

## Creating a chemical record

Go to:

```text theme={null}
Chemical Records > Add chemical record
```

### Fields captured

* pool
* date and time
* free chlorine
* total chlorine
* pH
* pool temperature
* air temperature
* heater set temperature
* heater actual temperature
* thermometer actual temperature
* alkalinity
* calcium hardness
* cyanuric acid
* TDS
* water clarity
* backwash yes/no
* notes

### Combined chlorine

Combined chlorine is calculated automatically from:

```text theme={null}
total chlorine - free chlorine
```

If the result is negative, the form warns you that free chlorine exceeds total chlorine and the readings should be checked.

## Typical walkthrough

<Steps>
  <Step title="Open Chemical Records">
    Filter to the correct location or pool if you are reviewing prior entries.
  </Step>

  <Step title="Add chemical record">
    Select `Add chemical record`.
  </Step>

  <Step title="Enter the readings">
    Enter the real test date and time and complete the measured values.
  </Step>

  <Step title="Save and review">
    Save the record and review the status badges and detail page.
  </Step>

  <Step title="Note follow-up">
    If the record is out of range, use comments to note follow-up or corrective action.
  </Step>
</Steps>

## What happens on save

When you save a record, AquaOps:

* stores the chemistry record
* computes overall chemistry status
* computes field-level status details
* computes LSI
* stores audit-relevant history data

## Detail page

Open any record to see:

* pool and location
* submission time
* submitting user
* overall status badge
* detailed per-field readings
* ideal range reference text
* auxiliary readings like air temperature and clarity
* LSI and LSI recommendation
* notes
* comments
* edit history link

## Comments and history

Each record has:

* a comments section for discussion or corrective notes
* an edit history view for audit visibility

This is especially important for out-of-range readings and closure-threshold events.

## Closure-required records

If a record hits a closure threshold, the detail page shows a prominent warning.

Examples include:

* water clarity issues
* chemistry values beyond configured closure bounds

The current implementation warns the operator and links into the compliance workflow. Teams can open or review a closure incident from the affected record, then track notes, evidence, and corrective actions there.

## Best practices

* make sure the correct pool is selected before saving
* enter the actual test time, not just the current time
* leave non-measured fields blank rather than guessing
* use comments for corrective actions or follow-up notes
* review pool chemical profiles periodically so statuses remain meaningful

## Suggested screenshots

* desktop chemical records list
* mobile chemical record cards
* new chemical record form
* record detail page with field-level statuses
* closure-required warning state