mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-14 06:40:50 +00:00
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:
1 parent
aca497d9ac
commit
3c98d95a40
73 files changed
+6061
-385
No files matched your search
@@ -0,0 +1,52 @@
|
||||
/**
|
||||
* v1.42 (#615) — the dashboard environment chip stays quiet: no flag, no
|
||||
* chip; an unfetched air-quality part raises no air or pollen flag.
|
||||
*/
|
||||
import { describe, expect, it } from "vitest";
|
||||
|
||||
import { environmentChipFlags } from "../environment-chip";
|
||||
|
||||
const POLLEN = {
|
||||
alder: 0,
|
||||
birch: 0,
|
||||
grass: 0,
|
||||
mugwort: 0,
|
||||
olive: 0,
|
||||
ragweed: 0,
|
||||
};
|
||||
|
||||
describe("environmentChipFlags", () => {
|
||||
it("raises nothing on an ordinary day", () => {
|
||||
expect(
|
||||
environmentChipFlags({
|
||||
date: "2026-10-07",
|
||||
tempMin: 9,
|
||||
airQuality: { eaqiMax: 35, pollen: POLLEN },
|
||||
}),
|
||||
).toEqual([]);
|
||||
});
|
||||
|
||||
it("names the high pollen kinds, the warm night and the very poor air", () => {
|
||||
expect(
|
||||
environmentChipFlags({
|
||||
date: "2026-07-20",
|
||||
tempMin: 21,
|
||||
airQuality: { eaqiMax: 84, pollen: { ...POLLEN, grass: 70 } },
|
||||
}),
|
||||
).toEqual([
|
||||
{ kind: "pollen", kinds: ["grass"] },
|
||||
{ kind: "hotNight" },
|
||||
{ kind: "veryPoorAir" },
|
||||
]);
|
||||
});
|
||||
|
||||
it("raises no air flag for a day whose air quality was not fetched", () => {
|
||||
expect(
|
||||
environmentChipFlags({
|
||||
date: "2026-07-20",
|
||||
tempMin: 10,
|
||||
airQuality: null,
|
||||
}),
|
||||
).toEqual([]);
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,111 @@
|
||||
"use client";
|
||||
|
||||
/**
|
||||
* `<EnvironmentChip>` — the dashboard's quiet note about the newest stored
|
||||
* environment day (v1.42, #615): high pollen, a hot night, very poor air.
|
||||
*
|
||||
* Quiet by construction: it renders nothing unless one of the three flags in
|
||||
* `src/lib/environment/day-flags.ts` is set for that day, nothing while the
|
||||
* environment module is off, and nothing for an air-quality flag the feed did
|
||||
* not cover (an unfetched day is not clean air). It names the day it is about,
|
||||
* because the archive behind it settles a few days late: the newest stored day
|
||||
* is usually yesterday or the day before, never a forecast for today, and the
|
||||
* chip never asks one.
|
||||
*
|
||||
* Not a dashboard widget: it has no widget id and no place in the layout
|
||||
* contract the iOS client shares. It reads the module overview through the
|
||||
* same query the settings section uses.
|
||||
*/
|
||||
import { useQuery } from "@tanstack/react-query";
|
||||
import { CloudSun } from "lucide-react";
|
||||
|
||||
import { TagChip } from "@/components/ui/tag-chip";
|
||||
import { useAuth } from "@/hooks/use-auth";
|
||||
import { apiGet } from "@/lib/api/api-fetch";
|
||||
import {
|
||||
highPollenKinds,
|
||||
isHotNight,
|
||||
isVeryPoorAir,
|
||||
type PollenByKind,
|
||||
} from "@/lib/environment/day-flags";
|
||||
import { useFormatters, useTranslations } from "@/lib/i18n/context";
|
||||
import { queryKeys } from "@/lib/query-keys";
|
||||
|
||||
/** The slice of `GET /api/environment` the chip reads. */
|
||||
export interface EnvironmentChipOverview {
|
||||
latestDay: {
|
||||
date: string;
|
||||
tempMin: number | null;
|
||||
airQuality: {
|
||||
eaqiMax: number | null;
|
||||
pollen: PollenByKind;
|
||||
} | null;
|
||||
} | null;
|
||||
}
|
||||
|
||||
/** The flags a day raises, as i18n keys with their values. Pure. */
|
||||
export function environmentChipFlags(
|
||||
day: NonNullable<EnvironmentChipOverview["latestDay"]>,
|
||||
): Array<
|
||||
| { kind: "pollen"; kinds: string[] }
|
||||
| { kind: "hotNight" }
|
||||
| { kind: "veryPoorAir" }
|
||||
> {
|
||||
const flags: ReturnType<typeof environmentChipFlags> = [];
|
||||
const air = day.airQuality;
|
||||
if (air) {
|
||||
const kinds = highPollenKinds(air.pollen);
|
||||
if (kinds.length > 0) flags.push({ kind: "pollen", kinds });
|
||||
}
|
||||
if (isHotNight(day.tempMin)) {
|
||||
flags.push({ kind: "hotNight" });
|
||||
}
|
||||
if (air && isVeryPoorAir(air.eaqiMax)) flags.push({ kind: "veryPoorAir" });
|
||||
return flags;
|
||||
}
|
||||
|
||||
export function EnvironmentChip() {
|
||||
const { t } = useTranslations();
|
||||
const fmt = useFormatters();
|
||||
const { user } = useAuth();
|
||||
const enabled = user?.modules?.environment === true;
|
||||
|
||||
const overview = useQuery({
|
||||
queryKey: queryKeys.environment(),
|
||||
enabled,
|
||||
queryFn: () => apiGet<EnvironmentChipOverview>("/api/environment"),
|
||||
staleTime: 30 * 60 * 1000,
|
||||
});
|
||||
|
||||
const day = overview.data?.latestDay;
|
||||
if (!enabled || !day) return null;
|
||||
const flags = environmentChipFlags(day);
|
||||
if (flags.length === 0) return null;
|
||||
|
||||
// A stated calendar day, read as that day wherever the person is.
|
||||
const date = fmt.dateShortSmartCalendar(day.date);
|
||||
return (
|
||||
<div
|
||||
data-slot="environment-chip"
|
||||
className="flex flex-wrap items-center gap-2"
|
||||
>
|
||||
<CloudSun className="text-muted-foreground size-4" aria-hidden />
|
||||
<span className="text-muted-foreground text-xs">
|
||||
{t("environment.chip.day", { date })}
|
||||
</span>
|
||||
{flags.map((flag) => (
|
||||
<TagChip key={flag.kind} data-flag={flag.kind}>
|
||||
{flag.kind === "pollen"
|
||||
? t("environment.chip.pollenHigh", {
|
||||
kinds: flag.kinds
|
||||
.map((kind) => t(`environment.pollen.${kind}`))
|
||||
.join(", "),
|
||||
})
|
||||
: flag.kind === "hotNight"
|
||||
? t("environment.chip.hotNight")
|
||||
: t("environment.chip.veryPoorAir")}
|
||||
</TagChip>
|
||||
))}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
Reference in new issue
Block a user