Infra: split dev and production (releases, services, deploy script)

- Production now runs from ~/freezmo-prod/current (release symlink) as a
  standalone server on :3207; releases are exported by scripts/deploy.sh,
  built and e2e-verified on a temp port, switched atomically, health-
  checked via the new /api/healthz (commit + build time) and rolled back
  automatically on failure. Last 5 releases kept; scripts/rollback.sh for
  manual rollback. Shared env + data live in ~/freezmo-prod/shared/ and
  are symlinked into every release (existing sync/push data migrated and
  verified identical).
- Dev runs from ~/freezmo via freezmo-dev.service: next dev on :3217
  (LAN only), its own build folder (.next-dev via NEXT_DIST_DIR), its own
  data (~/freezmo/.freezmo-dev), DEV badge, dev favicon/theme colour,
  "Freezmo Dev" PWA identity and never the production service worker.
- /api/healthz + the Settings Details version row (short commit + build
  time). output: standalone in next.config (next start still works).
- AGENTS.md documents the workflow rules: only dev updates during a task,
  temporary dirs/ports for test builds, and deploy-at-the-end as the only
  production path. README gains an Environments and deploy section.
- Fix found by the rehearsal: lib/dev-mode.ts must not be a client module
  (a server component importing a constant from a "use client" module
  gets a truthy proxy, which baked dev metadata into production builds).
- SW -> freezmo-v34.
This commit is contained in:
Martin Dvořák 2026-10-11 19:25:29 +00:00
commit 3f52ab47c2
22 changed files with 665 additions and 35 deletions

7
lib/dev-mode.ts Normal file
View file

@ -0,0 +1,7 @@
/**
* True when this build is the development instance (`freezmo-dev.service`
* sets NEXT_PUBLIC_FREEZMO_DEV=1). Baked in at build/start time, so the dev
* server shows its badge, favicon, theme colour and PWA identity while a
* production build is completely unaffected.
*/
export const IS_DEV_INSTANCE = process.env.NEXT_PUBLIC_FREEZMO_DEV === "1";

View file

@ -987,6 +987,7 @@ const en: Record<string, string> = {
"chat.savedToNotes": "Saved to {deck}'s notes",
"chat.savedToNotesTrimmed": "Saved to {deck}'s notes (trimmed to fit)",
"chat.savedFromChat": "Saved from chat",
"settings.version": "Version",
"settings.chatNotes": "Keep notes text for chat",
"settings.chatNotesNote": "Chat answers from the notes you added (stored with each deck). Turn off to use only the generated study content.",
"server.chatModelNotAllowed": "That chat model is not on the server's allowlist.",
@ -1919,6 +1920,7 @@ const cs: Record<string, string> = {
"chat.savedToNotes": "Uloženo do poznámek sady {deck}",
"chat.savedToNotesTrimmed": "Uloženo do poznámek sady {deck} (zkráceno, aby se vešlo)",
"chat.savedFromChat": "Uloženo z chatu",
"settings.version": "Verze",
"settings.chatNotes": "Uchovávat text poznámek pro chat",
"settings.chatNotesNote": "Chat odpovídá z poznámek, které jsi přidal (jsou uložené u každé sady). Vypnutím bude používat jen vygenerovaný obsah.",
"server.chatModelNotAllowed": "Tento model chatu není v povoleném seznamu serveru.",

35
lib/use-version.ts Normal file
View file

@ -0,0 +1,35 @@
"use client";
import { useEffect, useState } from "react";
export type RunningVersion = {
commit: string;
short: string;
builtAt: string | null;
release: string | null;
dev: boolean;
};
/** Which release is running (from /api/healthz), for the Settings details. */
export function useVersion(): RunningVersion | null {
const [version, setVersion] = useState<RunningVersion | null>(null);
useEffect(() => {
let cancelled = false;
void (async () => {
try {
const response = await fetch("/api/healthz", { cache: "no-store" });
if (!response.ok) return;
const body = (await response.json()) as RunningVersion;
if (!cancelled) setVersion(body);
} catch {
/* offline or old server — the row stays hidden */
}
})();
return () => {
cancelled = true;
};
}, []);
return version;
}