mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-08 04:32:42 +00:00
Cover the full channel set self-hosters can run without an Apple account: Web Push, Telegram, ntfy, the generic webhook, and email over SMTP, plus the dispatcher cascade and graceful degradation when APNs is absent (ntfy max priority, Web Push high urgency, webhook urgency flag). Document the PWA path as the recommended default: install to the Home Screen, enable Web Push, and get reminders, the taken-clears-the-reminder behaviour, and the outstanding-dose app badge. Note the inherent limit that the lock-screen Live Activity needs a native build. Explain why native iOS push binds to the publisher's Apple team and walk through running your own signed build under your own bundle ID, team, and .p8 key, with the APNS_* env vars including APNS_CRITICAL_ENTITLEMENT.
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.ops/— backup / restore + encryption-key-rotation playbooks. These are the runbooks 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.migration/— release-by-release migration notes. Read the entry for the version you're upgrading from.audit/— per-release audit summaries archived for forensic traceability.apple-store-connect-checklist.md— the iOS submission gate.doctor-report.md— PDF generator design notes.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.