d3cae27fa4
Foton, video och instrumentbilder låg som data-URL:er inne i händelserna. Det drabbade allt som läser loggen: synken drog med hela bildmassan var femtonde sekund, kundvyn likaså, och en säkerhetskopia av loggen var i praktiken en kopia av alla foton. Nu ligger innehållet utanför händelsen och loggen bär en referens med innehållets SHA-256. Det försvagar inte bevisvärdet utan stärker det: hashen står i den append-only-skyddade loggen, så en bild som bytts ut går att upptäcka. Tidigare låg bilden i loggen och måste helt enkelt tros på. Innehållet kontrolleras mot hashen varje gång det lämnas ut — stämmer det inte svarar tjänsten 409 i stället för att visa bilden. Innehållsadresserat, så samma foto som dokumenteras två gånger lagras en gång. Två lägen: databas (bytea, fungerar överallt utan konfiguration) och s3 (AWS, MinIO, Ceph). Signeringen är egen — SigV4 för PUT och GET — i stället för molnleverantörens SDK, eftersom två operationer inte motiverar tiotals megabyte beroenden i en bild som annars bara har pg-drivrutinen. Den korsverifieras bit för bit mot botocore i testerna. Det avslöjade en riktig bugg direkt: host-huvudet saknade portnummer, vilket hade fungerat mot AWS men avvisats av all självhostad S3. Kodningen av objektnycklar kanoniseras medvetet inte. S3 följer andra URL-regler än övriga AWS-tjänster och en felgissad regel ger signaturer som ser rimliga ut men avvisas. I stället begränsas hink och prefix till tecken som aldrig behöver kodas — då finns ingen regel att gissa fel på. Delningsgränsen gäller även bilagor: en bilaga lämnas bara ut via en delningslänk om händelsen den hör till är synlig på den nivån, så den skannade arbetsordern nås aldrig via kundlänken. Uppladdningen sker på ett enda ställe — sidans egna skicka() flyttar innehållet innan händelsen skrivs, så ingen panel behövde ändras. Misslyckas det, eller saknas server som i lokalt läge, bäddas det in precis som förut. Dokumentationen får aldrig gå förlorad för att nätet ligger nere, och äldre händelser med inbäddad data-URL fortsätter fungera för alltid eftersom loggen är append-only. Verifierat: 96 vitest-tester (varav 9 nya för signering och innehållsadressering), typkontroll, eslint, OpenAPI-validering, terraform fmt och referenskontroll, samt integrationstest mot riktig Postgres med 13 nya kontroller — bland annat att ett manipulerat innehåll upptäcks och inte lämnas ut, och att kundlänken når fotot men inte arbetsordern. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012EQg3rJsrQ1ZNTvkzmQAtt
97 lines
3.3 KiB
TypeScript
97 lines
3.3 KiB
TypeScript
// Bilagor på klientsidan.
|
|
//
|
|
// Innehållet ligger inte längre i händelsen utan hämtas separat. Det gör
|
|
// synken lätt igen: en ärendesynk var femtonde sekund drar inte med sig
|
|
// hela bildmassan, och kundvyn laddar bara de bilder som faktiskt visas.
|
|
//
|
|
// I lokalt läge (ingen inloggning) finns ingen server att ladda upp till.
|
|
// Då används data-URL:en precis som förut — appen ska fungera utan
|
|
// backend, och en tekniker som dokumenterar offline får inte tappa något.
|
|
|
|
import type { Bilaga } from "./domain";
|
|
|
|
// Objekt-URL:er per bilage-id. Innehållsadresserat på servern, så en
|
|
// hämtad bilaga kan cachas obegränsat under sidans livstid.
|
|
const cache = new Map<string, Promise<string | null>>();
|
|
|
|
export function harBilaga(b: Bilaga | undefined): boolean {
|
|
return !!b && (!!b.bilagaId || !!b.dataUrl);
|
|
}
|
|
|
|
/**
|
|
* Laddar upp innehållet och returnerar referensen som ska sparas i
|
|
* händelsen. Returnerar null i lokalt läge — då sparas data-URL:en i
|
|
* stället.
|
|
*/
|
|
export async function laddaUppBilaga(
|
|
arendeId: string,
|
|
dataUrl: string,
|
|
): Promise<{ bilagaId: string; bilagaHash: string } | null> {
|
|
const { plattformAktiv, plattformToken, PLATTFORM_URL } = await import("./plattform");
|
|
if (!plattformAktiv() || !plattformToken()) return null;
|
|
|
|
const svar = await fetch(dataUrl);
|
|
const blob = await svar.blob();
|
|
|
|
const res = await fetch(`${PLATTFORM_URL}/api/arenden/${arendeId}/bilagor`, {
|
|
method: "POST",
|
|
headers: {
|
|
"Content-Type": blob.type || "application/octet-stream",
|
|
Authorization: `Bearer ${plattformToken()}`,
|
|
},
|
|
body: blob,
|
|
});
|
|
if (!res.ok) throw new Error(`Bilagan kunde inte sparas (${res.status}).`);
|
|
const { id, hash } = (await res.json()) as { id: string; hash: string };
|
|
return { bilagaId: id, bilagaHash: hash };
|
|
}
|
|
|
|
/**
|
|
* Bygger det som ska in i händelsen. Lyckas uppladdningen bär händelsen
|
|
* en referens; annars data-URL:en. Det senare är inte ett fel utan
|
|
* lokalt läge — dokumentationen får aldrig gå förlorad för att nätet
|
|
* ligger nere.
|
|
*/
|
|
export async function bilageFalt(arendeId: string, dataUrl: string): Promise<Bilaga> {
|
|
try {
|
|
const referens = await laddaUppBilaga(arendeId, dataUrl);
|
|
if (referens) return referens;
|
|
} catch {
|
|
// Faller igenom till inbäddning nedan.
|
|
}
|
|
return { dataUrl };
|
|
}
|
|
|
|
/**
|
|
* Var innehållet finns att hämta. `delningskod` sätts i den publika
|
|
* vyn — där går hämtningen via delningens egen väg, som filtrerar på
|
|
* samma nivå som händelserna.
|
|
*/
|
|
export async function hamtaBilaga(b: Bilaga, delningskod?: string): Promise<string | null> {
|
|
if (b.dataUrl) return b.dataUrl;
|
|
if (!b.bilagaId) return null;
|
|
|
|
const nyckel = `${delningskod ?? ""}:${b.bilagaId}`;
|
|
const befintlig = cache.get(nyckel);
|
|
if (befintlig) return befintlig;
|
|
|
|
const hamtning = (async () => {
|
|
const { PLATTFORM_URL, plattformToken } = await import("./plattform");
|
|
if (!PLATTFORM_URL) return null;
|
|
|
|
const url = delningskod
|
|
? `${PLATTFORM_URL}/api/delad/${delningskod}/bilagor/${b.bilagaId}`
|
|
: `${PLATTFORM_URL}/api/bilagor/${b.bilagaId}`;
|
|
const token = plattformToken();
|
|
|
|
const res = await fetch(url, {
|
|
headers: !delningskod && token ? { Authorization: `Bearer ${token}` } : {},
|
|
});
|
|
if (!res.ok) return null;
|
|
return URL.createObjectURL(await res.blob());
|
|
})();
|
|
|
|
cache.set(nyckel, hamtning);
|
|
return hamtning;
|
|
}
|