feat(environment): air quality, pollen and UV per day, locations sealed at rest

Fetch the Open-Meteo air-quality feed (CAMS, domains=auto) with the weather:
17 hourly variables folded into local days by fixed rules (means and maxima
only with 18 of 24 hours, ozone as the highest 8-hour running mean, UV only
with the midday hours), a value the feed did not cover stored as null, never
as zero. Requests are cut into 90-day chunks, newest first, and chunks before
mid 2022 ask for the eight pollutant and index variables only. An air-quality
failure never costs the weather row; the day stays unfetched and the nightly
gap fill (up to 90 days per account, newest first) asks for it again.

Every Open-Meteo request asks an instance-wide budget kept in Postgres first
(500 a minute, 4000 an hour, 8000 a day, weighted by the hosted pricing
rule). A refused request is not sent and the run ends as done with
budget_blocked. OPENMETEO_AIR_QUALITY_URL and ENVIRONMENT_AIR_QUALITY_DISABLED
are honoured; the account switch lives on PATCH /api/environment/preferences.

The home, each dated location period and each stored day keep their coarse
location sealed as one value under healthlog/environment-location/v1. The
writers write the sealed value only, the readers open it and fall back to the
readable columns for rows the free-text encryption backfill has not reached,
and the backfill now seals all three and clears the readable columns. The
backup carries the location readable in a portable file and sealed in a
disaster-recovery file; a restore seals either under the receiving key.

Three correlation channels join the environment family (PM2.5, the ozone
8-hour high, the day's highest pollen count), read through the averaged
same-day window and left empty while air quality is off. The Coach and MCP
gain get_environment: module-gated, clamped to the lookback limit, no
coordinate or place name anywhere, with provenance and the attribution
lines. The settings section gets the switch, the coverage and the newest
day's values; the dashboard shows a quiet chip on a day with high pollen,
a warm night or very poor air. Copernicus and Open-Meteo are credited next
to the values.
This commit is contained in:
Marc-André Bombeck committed 2026-10-08 10:02:39 +02:00
1 parent aca497d9ac
commit 3c98d95a40
73 files changed
+6061 -385

No files matched your search

+58 -7
View File
@@ -1,17 +1,68 @@
/**
* `PATCH /api/environment/preferences` — the caller's environment switches,
* today `airQualityEnabled` (v1.42, #615). Module-gated like the rest of the
* environment surface.
* environment surface; `userId` is narrowed from auth.
*
* Contract stub: authenticates as the finished route will, then answers 501.
* Off: the nightly run stops asking the air-quality feed for this account,
* and the overview, the Coach, MCP and the correlations leave the air-quality
* values out. Days already stored keep theirs. On again: a lookback run is
* queued, and the nightly gap fill catches up on the days that never had any.
* The operator switch (`ENVIRONMENT_AIR_QUALITY_DISABLED`) wins either way,
* and the answer says when it does.
*/
import { apiHandler, requireAuth } from "@/lib/api-handler";
import { notImplemented } from "@/lib/http/not-implemented";
import { requireModuleEnabled } from "@/lib/modules/gate";
import { NextRequest } from "next/server";
export const PATCH = apiHandler(async () => {
import { apiHandler, requireAuth } from "@/lib/api-handler";
import { apiSuccess, returnAllZodIssues, safeJson } from "@/lib/api-response";
import { annotate } from "@/lib/logging/context";
import { requireModuleEnabled } from "@/lib/modules/gate";
import { prisma } from "@/lib/db";
import { environmentPreferencesSchema } from "@/lib/validations/environment";
import { isAirQualityOperatorDisabled } from "@/lib/environment/open-meteo-air-quality";
import { enqueueEnvironmentFetch } from "@/lib/jobs/environment-fetch";
export const PATCH = apiHandler(async (request: NextRequest) => {
const { user } = await requireAuth();
const gate = await requireModuleEnabled(user.id, "environment");
if (!gate.enabled) return gate.response;
return notImplemented();
const { data: rawBody, error: jsonError } = await safeJson(request, {
maxBytes: 1024,
});
if (jsonError) return jsonError;
const parsed = environmentPreferencesSchema.safeParse(rawBody);
if (!parsed.success) {
return returnAllZodIssues(parsed.error, 422, {
errorCode: "environment.invalid",
});
}
const before = await prisma.user.findUnique({
where: { id: user.id },
select: { environmentAirQualityEnabled: true },
});
const airQualityEnabled = parsed.data.airQualityEnabled;
await prisma.user.update({
where: { id: user.id },
data: { environmentAirQualityEnabled: airQualityEnabled },
});
const operatorDisabled = isAirQualityOperatorDisabled();
// Turned on: fetch the recent days now rather than at night. No-ops when
// no worker is bound; the nightly run covers it.
if (
airQualityEnabled &&
!operatorDisabled &&
before?.environmentAirQualityEnabled === false
) {
await enqueueEnvironmentFetch({ userId: user.id });
}
annotate({
action: { name: "environment.preferences.update" },
meta: { air_quality_enabled: airQualityEnabled },
});
return apiSuccess({ airQualityEnabled, operatorDisabled });
});