+
+ Family
+ Loading family...
+
+
+
+ Guest Passes
+ 0
+
+
+
+
+
+
+
Swim test required under age 13.
+
+
+
+
+ No adults in this family.
+
+
+
+
+
+ No children in this family.
+
+
+ Ready.
+
+
+
+
+
+
diff --git a/index.html b/index.html
new file mode 100644
index 0000000..fe4dd95
--- /dev/null
+++ b/index.html
@@ -0,0 +1,727 @@
+
+
+
+
+
+ Cary Swim Club
+ Family Check-In Lookup
+ Fast and simple member management system for CSC guards and administrators.
+
+
+
+
+ Families
+ 0
+
+
+ Total Members
+ 0
+
+
+ Checked In
+ 0
+
+
+ Children Swim Passed
+ 0
+
+
+
+
+
+ Search active guests, or type first/family-last names for quick check-in/out lookup.
+
+
+
+
+ No checked-in members found.
+
+
+
+ Search Families
+ Search and tap a family.
+
+
+
+
+
+ No matching families found.
+
+
+
+
+
+
\ No newline at end of file
diff --git a/main.py b/main.py
new file mode 100644
index 0000000..7ff26a2
--- /dev/null
+++ b/main.py
@@ -0,0 +1,833 @@
+import csv
+import datetime as dt
+import difflib
+import re
+import shutil
+import sqlite3
+from pathlib import Path
+
+from flask import Flask, jsonify, request, send_file
+
+
+BASE_DIR = Path(__file__).resolve().parent
+DB_PATH = BASE_DIR / "pool_checkin.sqlite3"
+BACKUP_DIR = BASE_DIR / "backups"
+EXPORT_DIR = BASE_DIR / "exports"
+
+app = Flask(__name__)
+# Code-only configuration: change this constant to update the swim-test age rule.
+DEFAULT_MIN_SWIM_TEST_AGE = 13
+
+
+def dict_row_factory(cursor, row):
+ return {col[0]: row[idx] for idx, col in enumerate(cursor.description)}
+
+
+def get_connection() -> sqlite3.Connection:
+ conn = sqlite3.connect(DB_PATH)
+ conn.row_factory = dict_row_factory
+ conn.execute("PRAGMA foreign_keys = ON;")
+ return conn
+
+
+def normalize_text(value: str) -> str:
+ return re.sub(r"[^a-z0-9 ]+", "", (value or "").lower()).strip()
+
+
+def fuzzy_score(query: str, candidate: str) -> float:
+ q = normalize_text(query)
+ c = normalize_text(candidate)
+ if not q or not c:
+ return 0.0
+
+ if q in c:
+ return 1.0 + (len(q) / max(len(c), 1))
+
+ base = difflib.SequenceMatcher(None, q, c).ratio()
+ token_scores = [difflib.SequenceMatcher(None, q, token).ratio() for token in c.split()]
+ token_max = max(token_scores) if token_scores else 0.0
+ return max(base, token_max)
+
+
+def normalize_phone_for_storage(phone_raw: str) -> str | None:
+ digits = re.sub(r"\D", "", phone_raw or "")
+ if not digits:
+ return None
+
+ if len(digits) == 10:
+ return f"{digits[:3]}-{digits[3:6]}-{digits[6:]}"
+
+ if len(digits) == 11 and digits.startswith("1"):
+ d = digits[1:]
+ return f"+1 {d[:3]}-{d[3:6]}-{d[6:]}"
+
+ raise ValueError("Phone number must include area code (10 digits).")
+
+
+def initialize_database() -> None:
+ BACKUP_DIR.mkdir(exist_ok=True)
+ EXPORT_DIR.mkdir(exist_ok=True)
+
+ with get_connection() as conn:
+ conn.executescript(
+ """
+ CREATE TABLE IF NOT EXISTS families (
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
+ family_name TEXT NOT NULL,
+ primary_phone TEXT,
+ guest_passes INTEGER NOT NULL DEFAULT 0 CHECK(guest_passes >= 0),
+ created_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP
+ );
+
+ CREATE TABLE IF NOT EXISTS app_meta (
+ key TEXT PRIMARY KEY,
+ value TEXT NOT NULL
+ );
+
+ CREATE TABLE IF NOT EXISTS members (
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
+ first_name TEXT NOT NULL,
+ last_name TEXT NOT NULL,
+ age INTEGER NOT NULL CHECK(age >= 0),
+ family_id INTEGER,
+ is_checked_in INTEGER NOT NULL DEFAULT 0 CHECK(is_checked_in IN (0, 1)),
+ swim_test_passed INTEGER NOT NULL DEFAULT 0 CHECK(swim_test_passed IN (0, 1)),
+ can_use_deep_end INTEGER NOT NULL DEFAULT 0 CHECK(can_use_deep_end IN (0, 1)),
+ created_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
+ FOREIGN KEY (family_id) REFERENCES families(id) ON DELETE SET NULL
+ );
+
+ CREATE INDEX IF NOT EXISTS idx_members_name ON members(last_name, first_name);
+ CREATE INDEX IF NOT EXISTS idx_members_family ON members(family_id);
+ CREATE INDEX IF NOT EXISTS idx_members_checked_in ON members(is_checked_in);
+ """
+ )
+
+ # Seed demo data once to make first run usable.
+ total_rows = conn.execute("SELECT COUNT(*) AS count FROM members;").fetchone()["count"]
+ if total_rows == 0:
+ conn.executemany(
+ "INSERT INTO families (family_name, primary_phone) VALUES (?, ?);",
+ [
+ ("Garcia", "555-201-0141"),
+ ("Miller", "555-201-0187"),
+ ("Nguyen", "555-201-0179"),
+ ],
+ )
+
+ family_map = {
+ row["family_name"]: row["id"]
+ for row in conn.execute("SELECT id, family_name FROM families;").fetchall()
+ }
+
+ conn.executemany(
+ """
+ INSERT INTO members
+ (first_name, last_name, age, family_id, is_checked_in, swim_test_passed, can_use_deep_end)
+ VALUES (?, ?, ?, ?, ?, ?, ?);
+ """,
+ [
+ ("Avery", "Wilson", 34, None, 0, 0, 1),
+ ("Noah", "Patel", 42, None, 0, 0, 1),
+ ("Emma", "James", 29, None, 0, 0, 1),
+ ("Luis", "Garcia", 41, family_map["Garcia"], 0, 0, 1),
+ ("Sofia", "Garcia", 38, family_map["Garcia"], 0, 0, 1),
+ ("Mateo", "Garcia", 11, family_map["Garcia"], 0, 0, 0),
+ ("Helen", "Miller", 37, family_map["Miller"], 0, 0, 1),
+ ("Kai", "Miller", 9, family_map["Miller"], 0, 0, 0),
+ ("Trang", "Nguyen", 35, family_map["Nguyen"], 0, 0, 1),
+ ("Liam", "Nguyen", 8, family_map["Nguyen"], 0, 0, 0),
+ ],
+ )
+
+ schema_version = conn.execute(
+ "SELECT value FROM app_meta WHERE key = 'schema_version';"
+ ).fetchone()
+ current_schema_version = 0
+ if schema_version is not None:
+ try:
+ current_schema_version = int(schema_version["value"])
+ except (TypeError, ValueError):
+ current_schema_version = 0
+
+ # One-time migration for older local databases created before defaults were reset.
+ if current_schema_version < 2:
+ conn.execute("UPDATE members SET is_checked_in = 0, swim_test_passed = 0;")
+ conn.execute(
+ "UPDATE members SET can_use_deep_end = CASE WHEN age >= 13 THEN 1 ELSE 0 END;"
+ )
+
+ family_columns = {
+ row["name"]
+ for row in conn.execute("PRAGMA table_info(families);").fetchall()
+ }
+ if "guest_passes" not in family_columns:
+ conn.execute(
+ "ALTER TABLE families "
+ "ADD COLUMN guest_passes INTEGER NOT NULL DEFAULT 0 CHECK(guest_passes >= 0);"
+ )
+
+ if current_schema_version < 3:
+ conn.execute(
+ "INSERT INTO app_meta (key, value) VALUES ('schema_version', '3') "
+ "ON CONFLICT(key) DO UPDATE SET value = excluded.value;"
+ )
+
+ # Normalize older short phone records to full numbers when possible.
+ old_phones = conn.execute(
+ "SELECT id, primary_phone FROM families WHERE primary_phone IS NOT NULL;"
+ ).fetchall()
+ for row in old_phones:
+ phone = row["primary_phone"]
+ digits = re.sub(r"\D", "", phone)
+ if len(digits) == 7:
+ normalized = normalize_phone_for_storage(f"555{digits}")
+ conn.execute(
+ "UPDATE families SET primary_phone = ? WHERE id = ?;",
+ (normalized, row["id"]),
+ )
+
+
+def to_member_payload(row: dict, min_swim_test_age: int) -> dict:
+ requires_swim_test = row["age"] < min_swim_test_age
+ return {
+ "id": row["id"],
+ "firstName": row["first_name"],
+ "lastName": row["last_name"],
+ "fullName": f"{row['first_name']} {row['last_name']}",
+ "age": row["age"],
+ "familyId": row["family_id"],
+ "checkedIn": bool(row["is_checked_in"]),
+ "swimTestPassed": bool(row["swim_test_passed"]),
+ "requiresSwimTest": requires_swim_test,
+ }
+
+
+def recalculate_deep_end(conn: sqlite3.Connection, member_id: int) -> None:
+ member = conn.execute(
+ "SELECT age, swim_test_passed FROM members WHERE id = ?;",
+ (member_id,),
+ ).fetchone()
+ if member is None:
+ return
+
+ can_use = int(member["age"] >= 13 or bool(member["swim_test_passed"]))
+ conn.execute(
+ "UPDATE members SET can_use_deep_end = ? WHERE id = ?;",
+ (can_use, member_id),
+ )
+
+
+@app.route("/")
+def homepage():
+ return send_file(BASE_DIR / "index.html")
+
+
+@app.route("/family/