Driftmanual · Version 1.0

Från idé till trygg beta.

En visuell karta över hur vi utvecklar TriggerFreeze, hur information rör sig genom backend och hur nattjobb, granskning, backup och säkerhet hänger ihop.

01 · Det dagliga arbetsflödet

Lokalt först. Beta när vi har godkänt.

Den viktigaste principen är att betan inte är vår skissyta. Vi arbetar och kontrollerar lokalt, sparar en godkänd version i GitHub och låter därefter Railway bygga en ny beta.

01

Arbeta lokalt

Kod, design och innehåll ändras på datorn. Den lokala databasen är en separat arbetskopia.

02

Kontrollera visuellt

Sidan granskas i webbläsaren. Bilder, texter, kategorier och mobilvy kontrolleras.

03

Kvalitetsgrind

Automatiska tester, byggkontroll, dubblettkontroll och granskningskö fångar problem.

04

Godkänn version

Först när den lokala versionen är godkänd förbereds en avgränsad uppdatering.

05

GitHub sparar

Godkänd kod versionssparas. Tidigare kodversioner kan jämföras och återställas.

06

Railway bygger beta

Beta byggs på extern server. Hälsokontrollen måste bli grön innan versionen används.

07

Följ upp

Loggar, nattresultat, säkerhetskontroller och datakvalitet följs upp innan nästa arbetsvarv.

02 · Så fungerar backend

Fyra lager arbetar tillsammans.

LAGER 01

Besökare och admin

Webbläsaren visar produkter, priser, varumärken och manualer. Betan kräver inloggning och adminytor kräver rätt behörighet.

LAGER 02

Next.js-applikationen

Tar emot sidvisningar och API-anrop, bygger gränssnittet och hämtar bara den information som sidan behöver.

LAGER 03

SQLite-databasen

Lagrar produkter, handlare, erbjudanden, prishistorik, granskningsköer och jobbhistorik på Railways beständiga volym.

LAGER 04

Insamlare och nattjobb

Hämtar data från handlare, normaliserar den och lägger osäkra poster i granskning i stället för att publicera dem direkt.

Kort sagt: webbsidan frågar applikationen, applikationen läser databasen, nattjobben fyller på kontrollerad information och osäkra poster stoppas i granskning.

03 · Nattjobbet

Arbetar medan datorn är avstängd.

Nattjobben körs på Railway, inte på din dator. En misslyckad källa ska inte stoppa hela körningen, och resultatet ska alltid kunna följas i efterhand.

1

Kö

Valda jobb läggs i en tydlig arbetskö.

2

Start 01:00

Railways bakgrundsarbetare startar körningen även när din dator är avstängd.

3

Hämta

Insamlare läser källdata från godkända handlare.

4

Normalisera

Namn, pris, lager, kategori, modell och tekniska fakta städas.

5

Kontrollera

Dubbletter, trasiga bilder, låg upplösning och osäker information flaggas.

6

Granska

Säkra poster kan godkännas; osäkra poster väntar på mänskligt beslut.

7

Rapport

Resultat, varningar och fel sammanställs till morgonrapporten.

04 · Säkerhet och återställning

Flera skydd - med olika uppgifter.

Kodbackup

GitHub sparar kodhistoriken och gör det möjligt att gå tillbaka mellan versioner.

Databackup

Railway-volymen säkerhetskopieras enligt dagligt, veckovis och månatligt schema när det väntande schemat aktiverats.

Åtkomst

Betan har inloggning, separata adminroller och hemliga nycklar för interna nattjobb.

Webbskydd

Noindex, säkerhetsrubriker, spärr mot inbäddning och begränsning av upprepade anrop.

Drift

Hälsokontroll och automatisk omstart upptäcker och hanterar driftfel.

Kvalitet

Data publiceras genom regler, källspårning och granskningskö - inte genom gissningar.

Om koden går fel

Gå tillbaka via GitHub

En tidigare godkänd kodversion kan återställas och byggas på nytt i Railway.

Om data går fel

Återställ en databaskopia

Databasen återställs från Railway-backup. Återläsning testas först isolerat när den möjligheten finns.

Om ett nattjobb går fel

Behåll bra data och granska felet

Jobbhistoriken visar vad som lyckades, varnades eller misslyckades utan att hela katalogen skrivs om.