[joszz]

Pull Request

Summary

Three features from the project review, and the documentation batch (P4).

• feat(notifications): arriving at and leaving home or work. A commute place gets Notify on arrival and departure (CommutePlace.Notify, off until switched on). place-departure goes out on the first position outside the place's radius after the engine started there, so warming the car up sends nothing; place-arrival on the position of the poll the car parked in, and not for a drive that never left the place it started in. Two new types each device can switch off, in English and Dutch. State lives in the Worker's PlaceAlerts, fed by TelemetryHandler.
• feat(trip-log): hide a trip, and join two trips a short stop split. Trip.IsHidden keeps a trip out of the map, the statistics, the dashboard and the trip log's totals and export; it stays listed under Show hidden trips. POST .../trips/{id}/merge-next joins a trip with the next saved one in one transaction (fixes, end, odometer, end address, speed figures, notes); a purpose someone chose is kept, an automatic one is worked out again from the new ends.
• feat(home-assistant): APK, recalls, next maintenance and last trip. VehicleFactsService works these out once; the Homepage widget serves them beside the telemetry, and HomeAssistantPublisher (Api) announces them over MQTT discovery on the car's existing device, with one retained state message per car on garagestack/<VIN>/state. A sensor with nothing to show gets an empty config, which removes it. The Home Assistant broker login may now read garagestack/#.
• docs:
  • The OpenAPI document is served in every deployment at /api/openapi/v1.json to signed-in callers and read-only tokens.
  • pnpm screenshots retakes the gallery and the manifest's install screenshots from a demo stack. All were retaken (the old ones predate the current sidebar and the RDW card), and Climate schedules was added.
  • README sections for climate schedules and maintenance.
  • The all-in-one image's move to a new PostgreSQL major version.

For the release notes (Upgrade Notes): migrations AddCommutePlaceNotify and AddTripIsHidden (columns with defaults). A Home Assistant broker reached through a Mosquitto bridge needs topic garagestack/# in 0 added for GarageStack's own sensors (HOME_ASSISTANT.md).

Type of Change

• Bug fix
• New feature
• Refactor / cleanup
• Documentation
• Dependency update
• Other

Related Issues

Follows #519 and #520.

Checklist

• Tests added or updated (place alerts over MQTT, hide and merge in the repository and through the demo stack, vehicle facts, widget fields, discovery payloads, the API reference, trip log store and item)
• Linting passes (pnpm lint / dotnet build), plus dotnet format --verify-no-changes, has-pending-model-changes, shellcheck, 1458 backend and 1141 frontend tests
• No secrets or personal data committed
• Responsive on mobile (checked in the retaken phone screenshots)
• i18n keys added for any new UI strings (en and nl, notifications and widget too)
• If unraid/garagestack.xml changed: not changed

Also checked locally: the generated Mosquitto ACL against a real broker (the Home Assistant login reads garagestack/# and homeassistant/#, cannot overwrite the state, and an empty retained config removes a sensor). Not run here: the Docker images, the Playwright smoke tests, the all-in-one PostgreSQL upgrade steps, and the sensors in a real Home Assistant.

---

Generated by Claude Code