# Cary Swim Club Check-In

A lightweight Flask + SQLite app for managing pool member check-ins, families, and swim-test status.

Inspired by pooldues.com

## Features

- Family and individual member management
- Check-in/check-out tracking
- Swim-test tracking with an age-based rule (`DEFAULT_MIN_SWIM_TEST_AGE` in `main.py`)
- Family guest pass tracking
- Search-focused dashboards for active check-ins and family records
- Admin utilities for backups, CSV export, DB maintenance, and bulk resets

## Tech Stack

- Python
- Flask
- SQLite
- Static HTML/CSS/JavaScript front-end

## Project Structure

- `main.py`: Flask server, API routes, and SQLite schema initialization
- `index.html`: Main dashboard/check-in experience
- `family.html`: Family-specific detail and check-in page
- `manage.html`: Management/admin interface
- `pool_checkin.sqlite3`: Primary SQLite database
- `backups/`: Generated SQLite backups
- `exports/`: Generated CSV exports

## Getting Started

### 1. Create and activate a virtual environment (optional but recommended)

PowerShell:

```powershell
python -m venv .venv
.\.venv\Scripts\Activate.ps1
```

### 2. Install dependencies

```powershell
pip install flask
```

### 3. Run the app

```powershell
python main.py
```

The app starts on Flask's default URL:

- `http://127.0.0.1:5000/`

On first run, required folders and database tables are created automatically.

## Main Routes

- `/`: Main check-in dashboard (`index.html`)
- `/family/<family_id>`: Family page (`family.html`)
- `/manage`: Management page (`manage.html`)

## API Overview

### Dashboard and listings

- `GET /api/dashboard`
- `GET /api/checked-in`
- `GET /api/individuals`
- `GET /api/families`
- `GET /api/families/<family_id>`

### Family and member updates

- `POST /api/families`
- `DELETE /api/families/<family_id>`
- `PATCH /api/families/<family_id>/guest-passes`
- `POST /api/members`
- `PATCH /api/members/<member_id>/checkin`
- `PATCH /api/members/<member_id>/swim-test`

### Admin utilities

- `POST /api/admin/backup`
- `POST /api/admin/export`
- `POST /api/admin/reindex`
- `POST /api/admin/vacuum`
- `POST /api/admin/reset-checkins`
- `POST /api/admin/reset-swim-tests`
- `POST /api/admin/cleanup-orphan-members`

## Data Notes

- Phone numbers are normalized when families are created.
- Swim-test requirement is based on age and `DEFAULT_MIN_SWIM_TEST_AGE` in `main.py`.
- Exports are written as timestamped CSV files in `exports/`.
- Backups are written as timestamped SQLite files in `backups/`.

## Operational Tips

- Keep regular DB backups using `POST /api/admin/backup`.
- Run `POST /api/admin/vacuum` periodically if the database grows after lots of deletes.
- Use `POST /api/admin/export` for reporting snapshots.