Katselin (selain)
Servo-pohjainen selainmoottori, Sataman whitelist-logiikka, paikallinen haku ja servoshell-embedder. Julkaistaan MPL 2.0 -lisenssillä.
Kehittäjille
Katselin on avoin projekti. Tämä sivu on suunnattu kaikille, jotka haluavat ymmärtää selaimen rakennetta tai rakentaa sille sovelluksia Varustamoon.
Repositoriot
Katselin.fi (tämä sivusto)
Viralliset julkiset ohjeet, dokumentaatio ja filosofia. Staattinen sivusto ilman build-vaihetta. CC BY 4.0.
Katselin Private
Whitelist-listat, allekirjoitettu Varustamo-katalogi ja sisäinen sovelluskehitys (Pulloposti, Missä olen). Suljettu repo.
Varustamo
Sovellusten testialue, joka ei riipu Katselimen raskaasta buildista. Tällä hetkellä osa Katselin Private -repoa, tarkoitus eriyttää myöhemmin.
Dokumentaatio
Nykytila
Mikä toimii nyt, mikä ei — ja mitä rakennetaan seuraavaksi.
Arkkitehtuuri
Komponentit, datavirrat, Meilisearch, selaustilat ja Varustamo.
Telakka — Kela
Ensimmäinen Telakka-kierros: miten Kela-testataan ilman sivukohtaisia hackeja.
Osallistuminen
Miten auttaa kehityksessä, bugiilmoitukset ja Rust-muutokset.
Tietoturva
Haavoittuvuuksien ilmoittaminen ja laajuus.
Markdown-lähteet: docs/-hakemistossa.
Sovelluskehitys Varustamoon
Varustamo on luotettujen sovellusten varasto. Sovellus on tyypillisesti Tauri 2.0 -sovellus, joka julkaisee paikallisen HTTP-rajapinnan ja jonka Katselin avaa Sataman sisällä omana näkymänään.
Ensimmäiset Varustamon sovellukset:
- Pulloposti – salattu offline/BLE-viestintä lähiverkossa ja Bluetoothilla.
- Missä olen – yhden painikkeen osoitesovellus, joka kertoo nykyisen sijainnin selkokielellä.
Sovelluksia voidaan kehittää itsenäisesti ilman Katselimen täyttä Servo-buildia. Sovellusten viralliset asennustiedostot allekirjoitetaan ja jaetaan Varustamon kautta.
Lokikirja (selaimen sisäinen palaute)
Työkalupalkin Lokikirja-painike lähettää anonyymejä ilmoituksia suoraan tämän repon GitHub-issueihin. Loppukäyttäjä ei kirjaudu GitHubiin.
Kehityksessä aseta ympäristömuuttuja:
export KOTISATAMA_GITHUB_TOKEN=ghp_xxxxxxxx # Issues-oikeus Katselin.fi-repoon
Tuotannossa käytä Cloudflare Workeria
(workers/report/) ja aseta KOTISATAMA_REPORT_URL
workerin osoitteeseen. Tokenia ei upoteta julkaistuun selaimen binääriin.
Täysi Lokikirja-ohje (Markdown) · Verkkopalautesivu (käyttäjän oma GitHub-tili)
Aloita kehitys
Aseta ensin Servon kehitysympäristö. Sen jälkeen klonaa Katselimen repo ja aja:
git clone https://github.com/Mikko-Huuskonen-Pro/Kotisatama.git
cd Kotisatama
./mach build --release
./mach runTarkemmat ohjeet, mukaan lukien Android-build ja paikallinen whitelist-konfiguraatio, löytyvät repon README-tiedostosta.