Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
38 commits
Select commit Hold shift + click to select a range
df853f7
feat(ui): Aqua Atelier foundation and new app shell
dlommm Oct 24, 2026
4cbf857
feat(ui): redesigned Today and stepped visit
dlommm Oct 24, 2026
f337b55
feat(ui): redesigned week and printable route sheet
dlommm Oct 24, 2026
2dbb780
feat(ui): owner dashboard with route progress and a decision queue
dlommm Oct 24, 2026
6134df0
feat(ui): customer list and Customer 360
dlommm Oct 24, 2026
91347e0
feat(ui): record forms, search and water history in the new layout
dlommm Oct 24, 2026
7cf35bc
feat(ui): customer CSV import as a four-step flow
dlommm Oct 24, 2026
530cb75
feat(ui): service jobs list and job detail
dlommm Oct 24, 2026
777e8cb
feat(ui): job form, quotes and contracts in the new layout
dlommm Oct 24, 2026
a70e82c
feat(ui): money summary and invoices workspaces
dlommm Oct 24, 2026
45a6e3a
feat(ui): receivables by age and the QuickBooks billing workspace
dlommm Oct 24, 2026
56f7c73
feat(ui): analytics header, range filter and revenue hero
dlommm Oct 24, 2026
705acdd
feat(ui): route planner map, balance, water alerts, operations, inven…
dlommm Oct 24, 2026
4f93844
feat(ui): one Admin page with a grouped side menu
dlommm Oct 24, 2026
b83a113
feat(ui): sign-in, error pages and customer portal
dlommm Oct 24, 2026
e521da0
fix(ui): keep shell state out of page templates; visual check for V2
dlommm Oct 24, 2026
00b820b
feat(ui): display preferences per device and an Equipment page
dlommm Oct 24, 2026
3a9139d
feat(admin): Logs and About pages
dlommm Oct 24, 2026
77a7441
feat(chemistry): editable targets and bands shared by dosing, alerts …
dlommm Oct 24, 2026
2f507f2
feat(appearance): company colour palettes with contrast solving
dlommm Oct 24, 2026
8d469fe
chore(css): per-feature stylesheets for emails, contracts, billing, a…
dlommm Oct 24, 2026
614e544
feat(routes): owners can hold a route, set by hand
dlommm Oct 24, 2026
a9b3d52
feat(billing): review the selected draft beside the list on desktop
dlommm Oct 24, 2026
bd2333a
Merge branch 'worktree-agent-a81a40e2cdab933ea' into feat/v2-ui
dlommm Oct 24, 2026
23950b9
feat(analytics): rebuild the overview with a 3/6/12-month range
dlommm Oct 24, 2026
d8f2f76
feat(emails): branded HTML emails with a plain-text copy and customer…
dlommm Oct 24, 2026
90e5ec3
Merge branch 'worktree-agent-a85f90d38ee49c162' into feat/v2-ui
dlommm Oct 24, 2026
e6c47e5
Merge branch 'worktree-agent-ab3702075c61f36b1' into feat/v2-ui
dlommm Oct 24, 2026
f465855
feat(contracts): make the unsigned-contract follow-up days a setting
dlommm Oct 24, 2026
c2f013d
feat(settings): three-pane contract editor
dlommm Oct 24, 2026
aaa6fcc
Merge branch 'worktree-agent-a7e167716b8a9112c' into feat/v2-ui
dlommm Oct 24, 2026
fb9e36c
feat(setup): first-run setup wizard; no default owner or password in …
dlommm Oct 24, 2026
2f0aea6
fix: route assignees, customer deactivation date, palette on customer…
dlommm Oct 24, 2026
210f97c
fix(setup): pick up an owner created outside this process; CI seeds a…
dlommm Oct 24, 2026
552972b
chore(demo): fictional company name and street addresses in demo and …
dlommm Oct 24, 2026
2350b06
feat(emails): block email builder for the visit, invoice, reminder an…
dlommm Oct 24, 2026
bd35402
docs(site): project website for GitHub Pages
dlommm Oct 24, 2026
409bfac
chore(site): drop screenshots the page doesn't use
dlommm Oct 24, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 1 addition & 2 deletions .env.example
Original file line number Diff line number Diff line change
@@ -1,4 +1,3 @@
# owner account password (username: owner); changing it here resets the owner login
APP_PASSWORD=pick-a-long-password
SECRET_KEY=generate-with-openssl-rand-hex-32
# Default business time zone until you pick one in first-time setup
APP_TZ=America/New_York
4 changes: 2 additions & 2 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -175,7 +175,8 @@ jobs:
env:
DATA_DIR: ${{ github.workspace }}/.ci-visual
APP_URL: http://127.0.0.1:8000
APP_PASSWORD: ci-smoke-only-not-a-real-password
DEMO_OWNER_PASSWORD: ci-smoke-only-not-a-real-password
OWNER_PASSWORD: ci-smoke-only-not-a-real-password
SECRET_KEY: cismoke0000000000000000000000000000000000000000000000000000000000
PYTHONPATH: "."
steps:
Expand Down Expand Up @@ -226,7 +227,6 @@ jobs:
- name: Boot to healthy
run: |
docker run -d --name "$SMOKE" \
-e APP_PASSWORD=ci-smoke-only-not-a-real-password \
-e SECRET_KEY=cismoke0000000000000000000000000000000000000000000000000000000000 \
"$SMOKE"
# HEALTHCHECK: 20s start-period, 30s interval — allow ~2 min total.
Expand Down
33 changes: 33 additions & 0 deletions .github/workflows/pages.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# Publishes the project website (site/) to GitHub Pages. One-time setup in the
# repository: Settings → Pages → Build and deployment → Source: GitHub Actions.
name: Website

on:
push:
branches: [main]
paths: ["site/**", ".github/workflows/pages.yml"]
workflow_dispatch:

permissions:
contents: read
pages: write
id-token: write

concurrency:
group: pages
cancel-in-progress: false

jobs:
deploy:
runs-on: ubuntu-latest
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- uses: actions/checkout@v4
- uses: actions/configure-pages@v5
- uses: actions/upload-pages-artifact@v3
with:
path: site
- id: deployment
uses: actions/deploy-pages@v4
26 changes: 19 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@

<p align="center"><em>Self-hosted pool-service management — routes, water chemistry, invoicing, and crew.</em></p>

<p align="center"><a href="https://dlommm.github.io/OpenPoolPro/">Website</a> · <a href="https://hub.docker.com/r/dendlomm/openpoolpro">Docker Hub</a> · <a href="https://github.com/dlommm/OpenPoolPro/releases">Releases</a></p>

---

Self-hosted pool-route app for small pool-service companies, built to run on
Expand All @@ -24,27 +26,36 @@ one box (Docker + SQLite) and to be used from an iPhone in the field.

## Run

cp .env.example .env # set APP_PASSWORD and SECRET_KEY
cp .env.example .env # set SECRET_KEY (openssl rand -hex 32)
docker compose up -d
# (builds from source; to run the published image instead use
# deploy/docker-compose.yml, which pulls dendlomm/openpoolpro:latest)
# Put a TLS reverse proxy in front — the compose file binds the app to
# 127.0.0.1:8000 ON PURPOSE (the app trusts X-Forwarded-* from the proxy),
# so it is NOT reachable from other machines directly. Point the proxy at
# 127.0.0.1:8000 and set FORWARDED_ALLOW_IPS to the proxy's address.
# First login is owner / your APP_PASSWORD
# manage crew under Settings → Manage crew
# change APP_PASSWORD in .env + restart to reset the owner login (recovery)
# Open the app: first-time setup asks for the setup code from
# docker compose logs app | grep "Setup code"
# then creates your owner account (your name, username and password).
# Forgot the owner password? Print a one-time reset link:
# docker compose exec app python -m app.manage reset-owner [--clear-2fa]
# on iPhone: Share → Add to Home Screen

All data lives in ./data (SQLite DB, photos, nightly backups). Back up that
folder.

**Upgrading from a version that used `APP_PASSWORD`:** your `owner` account keeps
working with its current password. The first time you sign in after the upgrade,
you're asked to add your name, choose your own username and set a new password.
After that `APP_PASSWORD` is never read, so remove it from `.env`.

### Deploy the published image (Unraid)

CI publishes `:latest` on every merge to `main`, plus an immutable `:vX.Y.Z` per
release, to both `ghcr.io/dlommm/openpoolpro` and Docker Hub
(`dendlomm/openpoolpro`). `docker-compose.unraid.yml` is a ready-made stack
for Unraid's Docker Compose Manager — read the SETUP notes at the top of the file
(cache-only appdata share, required `APP_PASSWORD`/`SECRET_KEY`), then:
(cache-only appdata share, required `SECRET_KEY`), then:

docker compose -f docker-compose.unraid.yml pull
docker compose -f docker-compose.unraid.yml up -d
Expand All @@ -54,7 +65,8 @@ for Unraid's Docker Compose Manager — read the SETUP notes at the top of the f
python3.12 -m venv .venv && source .venv/bin/activate
pip install -r requirements-dev.txt
python scripts/build_css.py
APP_PASSWORD=dev COOKIE_SECURE=0 uvicorn app.main:create_app --factory --reload
COOKIE_SECURE=0 uvicorn app.main:create_app --factory --reload
# the setup code is printed in the log on first start
ruff check app/ tests/ scripts/ # same gate CI runs
pytest -n auto

Expand Down Expand Up @@ -505,7 +517,7 @@ is how a customer arrives. Every staff screen and the portal are rendered
twice, once on a light device and once on a dark one, and each render is held
to a 7:1 body-text contrast ratio:

APP_URL=http://localhost:8000 APP_PASSWORD=... python scripts/visual_check.py
APP_URL=http://localhost:8000 OWNER_USER=... OWNER_PASSWORD=... python scripts/visual_check.py

Point it at a disposable instance: to reach those screens it creates a
"Visual Tech" staff member and issues then revokes a portal link for customer 1,
Expand Down
Loading
Loading