d742cfe11f
* Add account system foundation: email/password auth with cookie sessions Introduce the app's first authoritative, user-owned data in a separate data/accounts.sqlite (SQLAlchemy), kept apart from the disposable derived-cache DB. Wire fastapi-users for email/password signup, cookie-based login/logout, and a session-check endpoint, backed by a database session strategy so logins survive restarts and are revocable. - db.py: async (aiosqlite) + sync SQLAlchemy engines over accounts.sqlite, WAL + foreign keys, create_db_and_tables(). - models.py: User, AccessToken, Subscription, Notification tables. - users.py: pwdlib hashing, HttpOnly cookie transport (path-scoped, SameSite=Lax, Secure via env), DatabaseStrategy sessions, current-user dependencies. - schemas.py: user + subscription + notification Pydantic models. - app.py: mount auth/register/users routers on v2, create tables at startup. - Pin fastapi-users[sqlalchemy]/aiosqlite; ignore data/accounts.sqlite*. * Add account header entry and auth modal (frontend) account.js self-injects a header entry (following the units.js pattern) that shows a Sign in button when logged out and an account menu when logged in, plus an auth modal reusing the existing .mp-overlay/.mp-modal chrome for email/password sign-in and account creation. A shared apiFetch helper sends the same-origin cookie for authed calls; exported getUser/openAuth/onAuthChange back later phases. Imported by every page entry module. On narrow screens the entry collapses to an icon-only button so it doesn't crowd the title. Enforce an 8-character minimum password in the user manager. * Add subscription CRUD API and the alerts management page Backend api_accounts.py adds user-scoped, cookie-authenticated endpoints to create/list/update/delete subscriptions (and the notification reads used next): POST snaps lat/lon to a grid cell, resolves a label, and rejects a duplicate location+kind with 409; PATCH/DELETE are ownership-checked (404 on mismatch). Mounted on the v2 prefix. Frontend subscriptions.js + subscriptions.html serve the /alerts page: a sign-in gate when logged out, an add flow that reuses the shared map picker and an editor modal (kind, watched metrics, 95-99 percentile, two-sided), and a card list with inline threshold/active edits and remove. Reachable from the account menu. * Add background subscription evaluation engine notify.py runs a daemon thread that periodically evaluates every active subscription: it groups them by grid cell, reads history from the parquet cache only (never spends archive quota) plus the hourly recent/forecast bundle, and grades candidate days with the existing grading.grade_day. A watched metric that lands at or beyond the threshold percentile fires a 'high' alert; a two-sided subscription also fires 'low' for the symmetric cold/calm/dry tail (precip stays one-directional). Observed subscriptions look at the last few recorded days, forecast subscriptions at the coming week. Two guards keep it quiet: a UNIQUE(subscription, event_date, metric, direction, kind) constraint dedups repeat events, and a per-subscription weekly cap (last_notified_at) limits each alert to one notification per 7 days. The loop tolerates a bad cell or an upstream rate limit without aborting the pass. Started and stopped from the app lifespan; gated by THERMOGRAPH_ENABLE_NOTIFIER. * Add in-app notification center (header bell) Extend account.js with a notification bell beside the account menu: an unread badge, a dropdown listing recent notifications (title, body, relative time), a per-item mark-read on click, and a Mark all read action, all through the cookie-authed notifications API. Unread state refreshes on open and polls every two minutes while signed in; polling stops on sign-out. Styled to match the app, responsive down to mobile. * Harden accounts: expired-session cleanup, engine tests, ops docs - notify.py sweeps expired login sessions (access tokens past their lifetime) once per evaluation pass. - Add hermetic unit tests for the evaluation engine's trigger detection (high/low tails, precip one-directional, normal = no trigger) and notification wording. - Document accounts.sqlite (authoritative, back it up), the single-worker requirement for the in-process evaluator, and the new env vars in DEPLOY.md.
101 lines
5.2 KiB
HTML
101 lines
5.2 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8" />
|
|
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
|
<title>Thermograph — reading the grades</title>
|
|
<meta name="description" content="Pick any point on Earth and see how its recent weather stacks up against ~45 years of local climate history — graded days, calendars, forecasts, and side-by-side comparisons." />
|
|
<meta name="theme-color" content="#f0803c" />
|
|
<!-- Link previews (Discord, Slack, iMessage…). The server fills the og:url /
|
|
og:image origins in from this request's scheme://host + base path —
|
|
crawlers need absolute URLs and don't run JS. -->
|
|
<meta property="og:type" content="website" />
|
|
<meta property="og:site_name" content="Thermograph" />
|
|
<meta property="og:title" content="Thermograph — reading the grades" />
|
|
<meta property="og:description" content="Pick any point on Earth and see how its recent weather stacks up against ~45 years of local climate history — graded days, calendars, forecasts, and side-by-side comparisons." />
|
|
<meta property="og:url" content="__ORIGIN__/legend" />
|
|
<meta property="og:image" content="__ORIGIN__/logo.png" />
|
|
<meta property="og:image:width" content="512" />
|
|
<meta property="og:image:height" content="512" />
|
|
<meta property="og:image:alt" content="Thermograph logo" />
|
|
<meta name="twitter:card" content="summary" />
|
|
<link rel="icon" href="logo.svg" type="image/svg+xml" />
|
|
<link rel="apple-touch-icon" href="logo.png" />
|
|
<link rel="stylesheet" href="style.css" />
|
|
</head>
|
|
<body>
|
|
<header>
|
|
<div class="brand">
|
|
<span class="logo">▚</span>
|
|
<div>
|
|
<h1>Thermograph · Guide</h1>
|
|
<p class="tag">What the metrics and percentile grades mean</p>
|
|
</div>
|
|
<nav class="view-nav" aria-label="Views">
|
|
<a href="./" data-view="map">Weekly</a>
|
|
<a href="calendar" data-view="calendar">Calendar</a>
|
|
<a href="day" data-view="day">Day</a>
|
|
<a href="compare" data-view="compare">Compare</a>
|
|
</nav>
|
|
</div>
|
|
</header>
|
|
|
|
<main class="guide">
|
|
<section class="guide-block">
|
|
<h2>How the grades work</h2>
|
|
<p>Every grade is <b>relative to this place's own climate history</b>, not an absolute
|
|
temperature. For each day Thermograph builds a ±7-day seasonal distribution from
|
|
decades of local records, then reports the <b>percentile</b> where the day falls in it.</p>
|
|
<p>So a 60° day can be “Above Normal” in one place or season and
|
|
“Below Normal” in another. That's why the categories read
|
|
“Above/Below Normal”, “High/Low”, and “Near Record” —
|
|
never “hot” or “cold”.</p>
|
|
</section>
|
|
|
|
<section class="guide-block">
|
|
<h2>Grade scale — percentile of the local ±7-day history</h2>
|
|
<div class="guide-scale" id="temp-scale"></div>
|
|
</section>
|
|
|
|
<section class="guide-block">
|
|
<h2>Rain intensity — percentile among rain days</h2>
|
|
<p class="muted">Precipitation is graded only across days that actually saw rain, so
|
|
“Heavy” means heavy <i>for a rainy day here</i>. Dry days are colored by
|
|
their dry streak instead (below).</p>
|
|
<div class="guide-scale" id="rain-scale"></div>
|
|
</section>
|
|
|
|
<section class="guide-block">
|
|
<h2>The metrics</h2>
|
|
<dl class="guide-metrics">
|
|
<dt>High / Low</dt><dd>The day's highest and lowest air temperature (°F).</dd>
|
|
<dt>Feels</dt><dd>Apparent temperature — what the air actually felt like once humidity
|
|
and wind are factored in, taking whichever apparent extreme (heat-index high or
|
|
wind-chill low) sits further from a temperate baseline, graded against its own history.</dd>
|
|
<dt>Humid</dt><dd>Absolute humidity: grams of water vapor per cubic meter of air (g/m³).</dd>
|
|
<dt>Wind</dt><dd>Average sustained wind speed (mph).</dd>
|
|
<dt>Gust</dt><dd>Peak wind gust for the day (mph).</dd>
|
|
<dt>Precip</dt><dd>Total precipitation (inches), graded by intensity among rain days.</dd>
|
|
<dt>Dry streak</dt><dd>Consecutive days since the last measurable rain — the color deepens
|
|
the longer it's been dry, and resets to blue on a rain day.</dd>
|
|
</dl>
|
|
</section>
|
|
|
|
<p class="guide-back"><a href="./">← Back to Thermograph</a></p>
|
|
</main>
|
|
|
|
<script type="module">
|
|
import "./nav.js"; // header view-links follow the last location
|
|
import "./units.js"; // the °F/°C toggle
|
|
import "./account.js"; // header sign-in entry + notification bell
|
|
// The scale rows come from the shared tier tables, so this guide can't
|
|
// drift from what the app actually shows.
|
|
import { SCALE_TEMP, SCALE_RAIN } from "./shared.js";
|
|
const row = ({ c, label, range }) =>
|
|
`<div class="guide-seg"><span class="guide-sw" style="background:var(--${c})"></span>` +
|
|
`<span class="guide-lbl">${label}</span><span class="guide-rng">${range}</span></div>`;
|
|
document.getElementById("temp-scale").innerHTML = SCALE_TEMP.map(row).join("");
|
|
document.getElementById("rain-scale").innerHTML = SCALE_RAIN.map(row).join("");
|
|
</script>
|
|
</body>
|
|
</html>
|