Engineering History
Repository
The local Git repository is the official engineering history for PagePoint.
Purpose
Git is used to support rollback, reproducibility, release management, customer support, future development, and AI context recovery. This is intentionally lightweight local source control, not a heavyweight DevOps process.
Repository Layout
| Path | Responsibility |
|---|---|
ppoe/ | PagePoint Operations Engine runtime source. |
ppsm/ | PagePoint Service Module source, provisioning framework, service UI, docs, service templates, and canonical install APK. |
android/PagePointApp/ | Android application source from the latest known source backup. |
engineering-portal/ | Canonical Engineering Portal source and publishing tools. |
docs/ | Repository-level engineering process documentation. |
Tracked and Ignored
- Track source, configuration examples, docs, portal source, and curated reference evidence.
- Do not track dependency folders, build output, logs, audit streams, generated diagnostics, backup trees, downloaded tools, or published portal output.
- Do not track site-local secrets.
ppsm/config/phone-provisioning.jsonremains local-only;phone-provisioning.example.jsondocuments the shape. - The canonical APK at
ppsm/data/packages/pagepoint.apkis tracked temporarily until Android builds are fully reproducible from source.
History Decision
The first root repository commit is a clean engineering baseline. Older PPOE Git history exists on the live OE and in the Pi backup, but it was not imported because that history includes tracked dependencies, logs, backups, and runtime artifacts.
Branch Strategy
mainis the working engineering baseline.feature/<short-name>is used for larger isolated work.release/<version>is used only when preparing a customer or site release.
Commit Philosophy
Commits should represent meaningful engineering milestones and leave the project in a coherent state.
- Good:
Add phone provisioning framework - Good:
Complete PPSM Device Owner support - Good:
Establish PPSM time authority strategy - Avoid:
Fixed stuff,Update, orMore changes
Release Philosophy
- Use component versions for PPOE, PPSM, Android, and Engineering Portal.
- Use annotated system release tags like
pagepoint-v0.5.0. - Use annotated deployment tags like
deploy/site-alpha/pagepoint-v0.5.0-20260714. - Record the exact APK package, Android version, PPOE version, PPSM version, and Engineering Portal version for every customer deployment.