mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-09 13:01:00 +00:00
Marc-André Bombeck
54b46f4679
The reminder tick rolled every delivered reminder on to its next slot. For a check-up (a reminder with no measurement type, made by the person or suggested by the Coach) that filed an open task under next month or next year the moment it was reminded, although nobody had done it. The start page and the check-up card then showed a yearly check-up due today as scheduled for next year, and a check-up with no cadence dropped off every surface. A check-up now keeps its due date after the reminder until it is marked done, skipped or snoozed, and is reminded again at most once a week while it stays open. A new `last_notified_at` column records the last delivered reminder; a repeat is held while that send was for the current slot and fewer than seven calendar days have passed, so a snooze, a skip or a completion opens a fresh slot that fires on its own day. The per-day claim stays the guard against two sends in one day. Measurement reminders keep rolling on (the next reading satisfies them and their next slot comes round soon), as do check-ups on a weekly or shorter cadence, whose next slot is the next reminder anyway. Appointment reminders stay one-shot. Migration 0355 adds the column and puts back check-ups the old tick rolled on: a live, enabled check-up whose most recent reminder claim is followed within ten minutes by its last write, carrying a due date more than a week past that send (or none, for a one-shot), not done, skipped or snoozed since. Its due date returns to the instant of that send. Anything else is left as it is. The same migration adds `upcoming_visit` to start-page item choices stored before visits were one of them, which otherwise read as visits switched off.
docs/ — internal reference + operator playbooks
The user-facing documentation lives at https://docs.healthlog.dev — that's the canonical surface for self-hosting guides, integration walkthroughs, AI-provider setup, and the doctor-report workflow.
The files in this directory are the internal operator playbooks, audit notes, and machine-readable specs that ship alongside the source:
api/— the OpenAPI 3.1 spec for the native-client subset (iOS DTO codegen target). Seeapi/README.mdfor the preview commands. Also home to the MCP-server contract:api/mcp-capabilities.md(tools, resources, prompts, write model) andapi/mcp-skills.md(building a connector / skill).ops/— operator runbooks: deploy, backup / restore, encryption-key rotation, password reset and account recovery, env checks, TLS pinning, data repair. These are what an operator reaches for during an incident.self-hosting/— horizontal-scaling notes (HEALTHLOG_PROCESS_TYPE=web|worker|all) and the deploy-pipeline recipe. Routine install steps stay ondocs.healthlog.dev. Includesself-hosting/mcp.md— enabling the off-by-default MCP connector and pointing Claude.ai / ChatGPT / Claude Desktop at it, andself-hosting/sso.md— OIDC SSO login: IdP setup, the identity-pinning security model,OIDC_ONLYconsequences, and the break-glass runbook. Alsoself-hosting/geolite2.md— bringing your own offline GeoLite2 databases viaGEOLITE2_DIRinstead of sending login IPs to a third-party lookup. Andself-hosting/account-sharing.md— letting one account on the instance open another's health record: the three access levels, the eight sections a grant can be narrowed to, managed profiles for somebody with no login and the guardians who look after them, what revocation does and does not undo, and which trust properties of the instance are unchanged by any of it.migration/— migration notes. Currently only v1.3 to v1.4; later releases are covered byCHANGELOG.mdand https://docs.healthlog.dev.integrations/— per-integration reference (Withings, Fitbit, Google Health, WHOOP, Apple Health, AI providers, data import).adr/— architecture decision records.security/— threat-model notes.diagrams/— architecture diagrams rendered through docs.healthlog.dev.releases/— release imagery.apple-store-connect-checklist.md— the iOS submission gate.codex-protocol-spec.md— Codex / ChatGPT OAuth protocol reverse-engineering notes.ui-guidelines.md— UI / a11y house style.
If you're a self-hoster looking to spin up an instance, start at https://docs.healthlog.dev or jump to the Quick Start in the project README.