Utvecklare

Katselin är ett öppet projekt. Den här sidan riktar sig till alla som vill förstå webbläsarens struktur eller bygga program till Varustamo.

Repositorier

Katselin (webbläsaren)

Servo-baserad webbläsarmotor, vitlistlogik för Hamnen, lokal sökning och servoshell-embedder. Publiceras under MPL 2.0.

Källkod på GitHub

Katselin.fi (den här webbplatsen)

Den officiella publika anvisningarna, dokumentationen och filosofin. Statisk webbplats utan byggsteg. CC BY 4.0.

Repo på GitHub

Katselin Private

Vitlistor, signerad Varustamo-katalog och intern programutveckling (Pulloposti, Var är jag). Privat repo.

Varustamo

Testområde för program, oberoende av Katselins tunga build. Just nu en del av Katselin Private; tanken är att avskilja den senare.

Översikt av arkitekturen

[Katselin – Servo-fork]
    ├── components/kotisatama/whitelist   ← vitlistlogik
    ├── components/kotisatama/search      ← sök-API (Meilisearch-klient)
    └── ports/servoshell                  ← embedder-hook (navigation, UI)

[Android – servoshell EGL]
    └── support/android/apk + JNI-host    ← Servos egen Android-väg

[Administrationspanel – Tauri 2.0, valfri]
    └── Anhörig administrerar vitlistan   ← inte en webbläsarmotor

[CDN – statiskt]
    ├── /free/whitelist.json
    └── /pro/whitelist.json               ← API-nyckel krävs

[Crawler – CI-process]
    └── Playwright → Meilisearch-dump → CDN

Ingen egen server. Ingen VPN-infrastruktur. Sökningen sker mot ett Meilisearch-index som förladdats på enheten.

Programutveckling till Varustamo

Varustamo är lagret för betrodda program. Ett program är vanligen en Tauri 2.0-app som tillhandahåller ett lokalt HTTP-API och som Katselin öppnar i Hamnen som en egen vy.

De första programmen i Varustamo:

Pulloposti – krypterad offline/BLE-kommunikation i närverk och via Bluetooth.
Var är jag (Missä olen) – ett enknappsprogram som berättar nuvarande plats på klarspråk.

Programmen kan utvecklas självständigt utan Katselins fullständiga Servo-build. Officiella installationsfiler signeras och distribueras via Varustamo.

Nuläge

Vitlistebaserad surfning fungerar (kela, suomi.fi m.fl.). Öppna havet är ännu ofärdigt.

Läs detaljerad status

Varvet-arbetsflödet

Varvet är Katselins sätt att laga det som saknas i Servo. Principen är att vi inte gör knep i stil med if url contains kela.fi, utan löser varje observerat problem som en liten och generell Servo-fix.

Välj en viktig sida som inte fungerar.
Reproducera problemet i Servo.
Anteckna det första konkreta avbrottet (URL, konsolfel, saknat API).
Gör den minsta möjliga rättningen.
Lägg till ett test.
Föreslå rättningen för upstream Servo.
Ta bort den lokala patchen när upstream accepterar fixen.

Rättningar märks med status: upstreamable, submitted, local-only eller remove-when-upstreamed.

Kom igång

Sätt först upp Servos utvecklingsmiljö. Klona sedan Katselin-repot och kör:

git clone https://github.com/Mikko-Huuskonen-Pro/Kotisatama.git
cd Kotisatama
./mach build --release
./mach run

Mer detaljerade anvisningar, inklusive Android-build och lokal vitlistkonfiguration, finns i repots README-fil.

Licenser

Servo-koden och Katselins ändringar i Servo: MPL 2.0.
Den här dokumentationen (Katselin.fi): CC BY 4.0.
Vitlistdata och signerad distribution via Varustamo: hanteras i ett separat privat repo.

Utökad utvecklardokumentation finns på finska: fi/kehittajille och i docs/.