Lisää README

README.md

@@ -0,0 +1,63 @@
+# Kululaskusilppuri
+
+Kululaskusilppuri pilkkoo ja siistii [kululaskut.fi](https://kululaskut.fi):n
+tuottamia CSV-tiedostoja OMS:n kirjanpitoon helpommin tuotavaan muotoon. Se
+poistaa tiedoista käyttämättömät kentät, siistii loput
+[Kitsaalla](https://kitsas.fi) luettavaan muotoon ja pilkkoo rivit erillisiin
+tiedostoihin maksupäivien perusteella.
+
+## Asentaminen
+
+Lisää tämä git-tietovaranto [Guixin kanavalistaan][guix-channels]
+seuraavankaltaisella pätkällä:
+
+[guix-channels]: https://guix.gnu.org/manual/devel/en/guix.html#Specifying-Additional-Channels
+
+```lisp
+(channel
+ (name 'kululaskusilppuri)
+ (url "https://git.olarinmaensamoojat.fi/OMS/kululaskusilppuri")
+ (branch "main")
+ (introduction
+  (make-channel-introduction
+   "3c7b52f0bf3615cba85466b139edceef9ae1d6e9"
+   (openpgp-fingerprint
+    "A0C9 1947 734F 076F 5F08 E9FF 257D 284A 2A1D 3A32"))))
+```
+
+Tämän jälkeen Kululaskusilppuri on saatavilla `kululaskusilppuri`-nimisenä
+pakettina kaikkialla Guixissa. Voit esimerkiksi ottaa sen käyttöön
+komentotulkkisessioosi komennolla `guix shell kululaskusilppuri`.
+
+## Ajaminen
+
+Yleensä kululaskusilppurin käyttö etenee seuraavasti:
+
+1. Lataa uudet kululaskut CSV-tiedostona osoitteesta
+   <https://hallinta.kululaskut.fi>
+2. Aja `kululaskusilppuri`
+3. Vie Kululaskusilppurin luomat CSV-tiedostot Kitsaaseen
+
+Jokaiselle komennolle tarvitsee määrittää oikeat asetukset komentorivillä
+annettavilla valitsimilla. Mahdolliset valitsimet voi listata kirjoittamalla
+komennon perään `--help`-valitsimen.
+
+## Kehittäminen
+
+Kehitysympäristön saat helposti Guixilla ajamalla komennon [`guix
+shell`][guix-shell] tässä hakemistossa. Muutoksia, vikailmoituksia ja
+kehitysideoita voi jättää Giteassa tai sähköpostilla osoitteeseen
+<saku@laesvuori.fi>. Tarkista, että kululaskusilppuri kääntyy vielä muutostesi
+jälkeen ajamalla komento `guix time-machine -C channels.scm -- build -f
+guix.scm`.
+
+[guix-shell]: https://guix.gnu.org/manual/devel/en/guix.html#Invoking-guix-shell
+
+## Kopioiminen
+
+Laskutin on [GNU AGPL lisenssin version kolme](COPYING.md), tai valintasi
+mukaan minkä tahansa myöhemmän [Free Software Foundationin julkaiseman
+version][fsf-agpl], alainen vapaa ohjelma, eli se kunniottaa käyttäjiensä
+vapautta päättää itse omasta tietojenkäsittelystään ja auttaa toisiaan.
+
+[fsf-agpl]: https://www.gnu.org/licenses/agpl-3.0.html