> ## 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.

# Introduction

> Start here to install, configure, and operate AquaOps as a facility administrator or operator.

This guide is the client-facing documentation home for AquaOps.

If you are installing, configuring, administering, or operating the system, start here. The goal of this guide is that a new team can stand up the project, understand the workflow of each module, and use every currently implemented feature without reading the code.

## What AquaOps does

AquaOps is an aquatics facility operations platform for:

* recording pool chemistry readings
* automatically evaluating chemistry against pool-specific thresholds
* calculating Langelier Saturation Index (LSI)
* tracking alerts, exports, and compliance incidents
* tracking maintenance work
* managing organizations, locations, pools, users, and roles
* building toward compliance-grade incident, inspection, and reporting workflows

## Current implementation status

Implemented now:

* authentication and tenant-scoped app shell
* organization, location, pool, user, and role management
* chemical records with detail pages, comments, edit history, threshold-based status, trends, and CSV import
* Illinois-specific chemistry defaults and closure thresholds
* compliance incidents, evidence, corrective actions, scheduled closures, and facility status
* alerts plus export history, CSV exports, and IDPH report generation
* maintenance logs
* responsive mobile and desktop navigation

Present but not fully implemented yet:

* forms
* preventive maintenance scheduling

## Start here

<Steps>
  <Step title="Installation and setup">
    Provision environment variables, install dependencies, and seed demo data. See [Installation and Setup](/user-guide/installation-and-setup).
  </Step>

  <Step title="First-time admin setup">
    Configure your organization, locations, pools, chemical profiles, roles, and users. See [First-Time Admin Setup](/user-guide/first-time-admin-setup).
  </Step>

  <Step title="Navigation and user experience">
    Learn how the product is organized on desktop and mobile. See [Navigation and User Experience](/user-guide/navigation-and-user-experience).
  </Step>
</Steps>

## Module guides

<CardGroup cols={2}>
  <Card title="Dashboard" href="/user-guide/dashboard">
    Weekly activity snapshot and quick entry points into daily work.
  </Card>

  <Card title="Chemical Records" href="/user-guide/chemical-records">
    Log pool chemistry readings and review automatic status evaluation.
  </Card>

  <Card title="Maintenance Logs" href="/user-guide/maintenance-logs">
    Track repairs, chemical additions, and other operational work.
  </Card>

  <Card title="Compliance Guide" href="/user-guide/compliance-guide">
    Closure incidents, evidence, corrective actions, and facility status.
  </Card>

  <Card title="Organization and Locations" href="/user-guide/organization-and-locations">
    Set up your organization and physical facility sites.
  </Card>

  <Card title="Pools and Chemical Profiles" href="/user-guide/pools-and-chemical-profiles">
    Define bodies of water and their chemistry thresholds.
  </Card>

  <Card title="Users and Roles" href="/user-guide/users-and-roles">
    Onboard staff and control role-based access.
  </Card>

  <Card title="Forms and Exports Status" href="/user-guide/forms-and-exports-status">
    Current maturity of the forms and exports modules.
  </Card>
</CardGroup>

## Compliance and product direction

* [Compliance Guide](/user-guide/compliance-guide)
* [Roadmap](/user-guide/roadmap)

## Screenshot and walkthrough coverage

The module guides in this tab are written as walkthrough-style pages and include recommended screenshot targets so they can also serve as training and handoff material.

## Quick product tour

### Dashboard

Use the dashboard to:

* see active pool count
* see chemical records logged in the last 7 days
* see maintenance logs logged in the last 7 days
* review open closure incidents and active alerts
* spot pools that currently need attention
* jump quickly into adding a chemical record or maintenance log

### Chemical records

Use chemical records to log water test readings for a specific pool. The system evaluates those readings against that pool's chemical profile and shows status badges like balanced, warning, critical, or closure required.

### Maintenance logs

Use maintenance logs for anything operational that is not a chemistry test:

* chemical additions
* equipment repair
* inspection notes
* cleaning work
* filter media changes

### Settings

The settings area is where an administrator manages:

* the organization
* locations
* pools
* users
* roles
* chemical profile thresholds for each pool
* notification preferences for alert emails

## Audience

This guide is written for:

* facility administrators
* operations managers
* pool operators
* implementation teams installing the system for a new organization

## Additional documentation

This site also has a [Developer Docs](/developer-docs/introduction) tab for engineering-oriented documentation. Treat this User Guide tab as the primary client-facing, end-user, and administrator documentation set.