Merge pull request #43 from olefredrik/feature/nicegui-ui

Erstatt Streamlit med NiceGUI og oppdater dokumentasjon

Author: olefredrik

README.md

@@ -7,7 +7,9 @@
 ![Tester](https://github.com/olefredrik/Wenche/actions/workflows/test.yml/badge.svg)
 [![Dokumentasjon](https://img.shields.io/badge/docs-olefredrik.github.io%2FWenche-blue)](https://olefredrik.github.io/Wenche/)
 
-Wenche er et verktøy for holdingselskaper og småaksjeselskaper som må levere regnskap og skattedokumenter til norske myndigheter. Det kan brukes både fra kommandolinjen og via et grafisk webgrensesnitt — uten behov for et fullverdig regnskapsprogram.
+Wenche er et verktøy for holdingselskaper og småaksjeselskaper som må levere regnskap og skattedokumenter til norske myndigheter — uten behov for et fullverdig regnskapsprogram.
+
+Kjør `wenche ui` for å åpne et grafisk webgrensesnitt i nettleseren der du fyller ut og sender inn alt. Kommandolinjen er tilgjengelig for de som foretrekker det.
 
 Autentisering skjer via Maskinporten med et selvgenerert RSA-nøkkelpar — ingen virksomhetssertifikat eller BankID-innlogging nødvendig.
 

docs/bruk.md

@@ -1,6 +1,6 @@
 # Bruk
 
-Wenche kan brukes enten via **kommandolinjen** eller via **webgrensesnittet** (`wenche ui`). Begge gir tilgang til de samme funksjonene.
+Wenche brukes primært via **webgrensesnittet** (`wenche ui`) — et grafisk grensesnitt i nettleseren der du fyller ut og sender inn alt. Kommandolinjen er tilgjengelig som alternativ for de som foretrekker det.
 
 ---
 
@@ -196,6 +196,7 @@ Kommandoer:
   generer-skattemelding    Generer ferdig utfylt RF-1167 og RF-1028
   send-aarsregnskap        Send inn arsregnskap til Bronnoysundregistrene
   send-aksjonaerregister   Send inn aksjonaerregisteroppgave (RF-1086)
+  importer-saft            Importer SAF-T Financial XML og generer config.yaml
   ui                       Start webgrensesnittet i nettleseren
 
 Alternativer (send-aarsregnskap og send-aksjonaerregister):
@@ -205,6 +206,10 @@ Alternativer (send-aarsregnskap og send-aksjonaerregister):
 Alternativer (generer-skattemelding):
   --config TEXT            Sti til konfigurasjonsfil [standard: config.yaml]
   --ut TEXT                Lagre sammendrag til fil
+
+Alternativer (importer-saft):
+  SAF-T-FIL                Sti til SAF-T Financial XML-fil (pakrevd argument)
+  --ut TEXT                Sti til config.yaml som skal skrives [standard: config.yaml]
 ```
 
 !!! note

docs/index.md

@@ -1,6 +1,8 @@
 # Wenche
 
-Wenche er et verktøy for holdingselskaper og småaksjeselskaper som må levere regnskap og skattedokumenter til norske myndigheter. Det kan brukes både fra kommandolinjen og via et grafisk webgrensesnitt — uten behov for et fullverdig regnskapsprogram.
+Wenche er et verktøy for holdingselskaper og småaksjeselskaper som må levere regnskap og skattedokumenter til norske myndigheter — uten behov for et fullverdig regnskapsprogram.
+
+Du fyller ut selskapsinformasjon, regnskapstall og aksjonærdata i et grafisk webgrensesnitt, og Wenche håndterer innsendingen til riktig myndighet. Kommandolinjen er tilgjengelig for de som foretrekker det.
 
 Autentisering skjer via Maskinporten med et selvgenerert RSA-nøkkelpar. Ingen virksomhetssertifikat eller BankID-innlogging nødvendig.
 

docs/installasjon.md

@@ -55,31 +55,19 @@ Viser kommandoen 3.10 eller lavere (eller du får feilmeldingen `command not fou
 
 Det anbefales å installere Wenche i et virtuelt miljø for å unngå konflikter med andre Python-pakker.
 
-=== "macOS / Linux — kommandolinje"
+!!! tip "Anbefalt: installer med webgrensesnitt"
+    De fleste brukere ønsker webgrensesnittet (`wenche ui`). Installer da `wenche[ui]` som vist under.
+    Vil du kun bruke kommandolinjen, kan du installere `wenche` uten ekstra avhengigheter.
 
-    ```bash
-    python3.11 -m venv .venv
-    source .venv/bin/activate
-    pip install wenche
-    ```
-
-=== "macOS / Linux — webgrensesnitt"
+=== "macOS / Linux"
 
     ```bash
     python3.11 -m venv .venv
     source .venv/bin/activate
     pip install "wenche[ui]"
     ```
 
-=== "Windows — kommandolinje"
-
-    ```powershell
-    py -3.11 -m venv .venv
-    .venv\Scripts\Activate.ps1
-    pip install wenche
-    ```
-
-=== "Windows — webgrensesnitt"
+=== "Windows"
 
     ```powershell
     py -3.11 -m venv .venv
@@ -124,7 +112,7 @@ Har du installert `wenche[ui]`, starter du grensesnittet slik:
 wenche ui
 ```
 
-Streamlit starter og åpner `http://localhost:8501` i nettleseren. Åpnes ikke nettleseren automatisk, kan du lime inn adressen manuelt.
+Wenche åpner `http://localhost:8080` i nettleseren. Åpnes ikke nettleseren automatisk, kan du lime inn adressen manuelt.
 
 ## For utviklere
 
@@ -135,7 +123,7 @@ git clone https://github.com/olefredrik/wenche.git
 cd wenche
 python3.11 -m venv .venv
 source .venv/bin/activate
-pip install -e ".[dev]"
+pip install -e ".[dev,ui]"
 ```
 
 Kjør testsuiten:

docs/referanse.md

@@ -233,6 +233,32 @@ wenche opprett-systembruker
 
 ---
 
+### `wenche importer-saft`
+
+Importerer en SAF-T Financial XML-fil og genererer `config.yaml` automatisk.
+
+```bash
+wenche importer-saft SAF-T-FIL [--ut FILSTI]
+```
+
+| Argument/alternativ | Beskrivelse |
+|---|---|
+| `SAF-T-FIL` | Sti til SAF-T Financial XML-filen eksportert fra regnskapssystemet (påkrevd) |
+| `--ut` | Sti til `config.yaml` som skal skrives. Standard: `config.yaml` |
+
+Etter import må følgende felt fylles inn manuelt i `config.yaml`:
+
+- `selskap.daglig_leder`
+- `selskap.styreleder`
+- `selskap.stiftelsesaar`
+- `aksjonaerer` (navn, fødselsnummer, antall aksjer, utbytte)
+- `foregaaende_aar.resultatregnskap` (er ikke tilgjengelig i SAF-T)
+
+!!! tip "Tilgjengelig i webgrensesnittet"
+    SAF-T-import er også tilgjengelig under fanen **Selskap** i `wenche ui`.
+
+---
+
 ### `wenche ui`
 
 Starter webgrensesnittet i nettleseren.
@@ -241,4 +267,4 @@ Starter webgrensesnittet i nettleseren.
 wenche ui
 ```
 
-Åpner Streamlit på `http://localhost:8501`.
+Åpner webgrensesnittet på `http://localhost:8080`.

docs/tutorial.md

@@ -21,40 +21,118 @@ Denne veiledningen tar deg gjennom en komplett innsending fra start til slutt. V
 
 ---
 
-## Steg 1 — Fyll ut config.yaml
+## Steg 1 — Start webgrensesnittet
 
-`config.example.yaml` i prosjektmappen er allerede fylt ut med tallene for Eksempel Holding AS. Kopier den for å følge denne veiledningen uten å endre noe:
+=== "Webgrensesnitt"
 
-```bash
-cp config.example.yaml config.yaml
-```
+    ```bash
+    wenche ui
+    ```
 
-Når du er klar til å levere ditt eget regnskap, åpner du `config.yaml` i en teksteditor og erstatter verdiene med dine egne tall. Se [Referanse](referanse.md) for beskrivelse av alle felt.
+    Wenche åpner `http://localhost:8080` i nettleseren. Du ser fem faner øverst: **Selskap**, **Regnskap**, **Aksjonærer**, **Dokumenter** og **Send til Altinn**.
 
-!!! tip "Balansen må gå opp"
-    Sum eiendeler skal være lik sum egenkapital og gjeld. Stemmer ikke tallene, gir Wenche deg en advarsel og viser differansen.
+=== "Kommandolinje"
+
+    Ingen oppstart nødvendig — alle kommandoer kjøres direkte i terminalen. Se neste steg.
 
 ---
 
-## Steg 2 — Generer skattemeldingen
+## Steg 2 — Fyll ut selskapsinformasjon
+
+=== "Webgrensesnitt"
+
+    Gå til fanen **Selskap** og fyll inn:
+
+    - **Selskapsnavn:** Eksempel Holding AS
+    - **Organisasjonsnummer:** 123456789
+    - **Daglig leder:** Kari Nordmann
+    - **Styreleder:** Kari Nordmann
+    - **Forretningsadresse:** Eksempelveien 1, 0001 Oslo
+    - **Stiftelsesår:** 2020
+    - **Aksjekapital:** 30 000
+    - **Regnskapsår:** 2024
+
+    Klikk **Lagre konfigurasjon**.
+
+    !!! tip "Har du SAF-T fra regnskapssystemet ditt?"
+        Klikk **Importer fra SAF-T Financial** øverst i fanen. Last opp XML-filen og Wenche fyller inn alle regnskapstall automatisk. Du må fortsatt fylle inn daglig leder, styreleder og aksjonærdata manuelt.
+
+=== "Kommandolinje"
+
+    Kopier eksempelfilen og rediger den:
+
+    ```bash
+    cp config.example.yaml config.yaml
+    ```
+
+    Åpne `config.yaml` i en teksteditor og erstatt verdiene under `selskap` med dine egne tall. Se [Referanse](referanse.md) for beskrivelse av alle felt.
+
+---
+
+## Steg 3 — Fyll ut regnskapstall
+
+=== "Webgrensesnitt"
+
+    Gå til fanen **Regnskap** og fyll inn tallene for Eksempel Holding AS:
+
+    **Resultatregnskap:**
+
+    - Utbytte fra datterselskap: 250 000
+    - Andre driftskostnader: 5 500
+
+    **Balanse — eiendeler:**
+
+    - Aksjer i datterselskap: (kostpris)
+    - Bankinnskudd: 1 200
+
+    **Balanse — egenkapital og gjeld:**
+
+    - Aksjekapital: 30 000
+    - Annen egenkapital: (akkumulert resultat)
+
+    Klikk **Lagre konfigurasjon**. Wenche viser en advarsel hvis balansen ikke går opp — sum eiendeler skal være lik sum egenkapital og gjeld.
+
+=== "Kommandolinje"
+
+    Fyll inn tallene direkte i `config.yaml` under `resultatregnskap` og `balanse`. Balansen må stemme — sum eiendeler = sum egenkapital og gjeld.
+
+---
+
+## Steg 4 — Fyll ut aksjonærdata
+
+=== "Webgrensesnitt"
+
+    Gå til fanen **Aksjonærer** og registrer aksjonærene per 31.12:
+
+    - **Navn:** Kari Nordmann
+    - **Fødselsnummer:** (11 siffer)
+    - **Antall aksjer:** 1 000
+    - **Aksjeklasse:** ordinære
+    - **Utbytte utbetalt:** (beløp, eller 0)
+
+    Klikk **Lagre konfigurasjon**.
+
+=== "Kommandolinje"
+
+    Fyll inn aksjonærene under `aksjonaerer` i `config.yaml`. Se [Referanse](referanse.md) for feltoversikt.
+
+---
+
+## Steg 5 — Generer skattemeldingen
 
 Skattemeldingen (RF-1167 + RF-1028) genereres lokalt og sendes inn manuelt på skatteetaten.no.
 
-```bash
-wenche generer-skattemelding
-```
+=== "Webgrensesnitt"
 
-Du skal se en utskrift som inneholder:
+    Gå til fanen **Dokumenter** og klikk **Last ned skattemelding**.
 
-- Næringsoppgave (RF-1167) med driftsinntekter, driftskostnader og finansposter
-- Skatteberegning — for Eksempel Holding AS med 100 % eierandel er utbyttet fritatt under fritaksmetoden, og skatten blir **0 kr**
-- Egenkapitalnote (rskl. § 7-2b) — vises automatisk når `foregaaende_aar` er utfylt
+    Sammendraget inneholder næringsoppgaven (RF-1167) og skatteberegningen. For Eksempel Holding AS med 100 % eierandel er utbyttet fritatt under fritaksmetoden — skatten blir **0 kr**.
 
-Lagre til fil for enklere kopiering:
+=== "Kommandolinje"
 
-```bash
-wenche generer-skattemelding --ut skattemelding_2024.txt
-```
+    ```bash
+    wenche generer-skattemelding --ut skattemelding_2024.txt
+    ```
 
 **Send inn manuelt:**
 
@@ -65,49 +143,54 @@ wenche generer-skattemelding --ut skattemelding_2024.txt
 
 ---
 
-## Steg 3 — Test årsregnskapet (dry-run)
+## Steg 6 — Send årsregnskapet
 
-Før du sender inn, kan du se hva Wenche vil sende til Brønnøysundregistrene:
+=== "Webgrensesnitt"
 
-```bash
-wenche send-aarsregnskap --dry-run
-```
+    Gå til fanen **Send til Altinn** og klikk **Send årsregnskap**.
 
-Dette genererer XML-dokumentene lokalt (`aarsregnskap_hovedskjema.xml` og `aarsregnskap_underskjema.xml`) uten å sende dem til Altinn. Nyttig for å verifisere at tallene er riktige.
+    Når opplastingen er ferdig vises knappen **Signer i Altinn**. Klikk den og signer med BankID som daglig leder eller styreleder.
 
----
+=== "Kommandolinje"
 
-## Steg 4 — Send årsregnskapet
+    Test uten å sende (anbefalt første gang):
 
-```bash
-wenche login
-wenche send-aarsregnskap
-wenche logout
-```
+    ```bash
+    wenche send-aarsregnskap --dry-run
+    ```
 
-Wenche laster opp årsregnskapet og skriver ut en lenke til Altinn når opplastingen er ferdig:
+    Send inn:
 
-```
-Årsregnskap lastet opp.
-Signer her: https://tt02.altinn.no/ui/...
-```
+    ```bash
+    wenche login
+    wenche send-aarsregnskap
+    wenche logout
+    ```
 
-Åpne lenken i nettleseren og signer med BankID som daglig leder eller styreleder. Signeringen fullfører innsendingen.
+    Wenche skriver ut en lenke til Altinn-innboksen. Åpne lenken og signer med BankID.
 
 !!! note "Signering skjer i Altinn, ikke i Wenche"
     Dette er et juridisk krav og kan ikke gjøres maskinelt.
 
 ---
 
-## Steg 5 — Send aksjonærregisteroppgaven
+## Steg 7 — Send aksjonærregisteroppgaven
+
+=== "Webgrensesnitt"
+
+    Gå til fanen **Send til Altinn** og klikk **Send aksjonærregister til Skatteetaten**.
+
+    Forsendelse-ID vises i grensesnittet når innsendingen er fullført. Ingen manuell signering nødvendig.
+
+=== "Kommandolinje"
 
-```bash
-wenche login
-wenche send-aksjonaerregister
-wenche logout
-```
+    ```bash
+    wenche login
+    wenche send-aksjonaerregister
+    wenche logout
+    ```
 
-Aksjonærregisteroppgaven (RF-1086) sendes automatisk til Skatteetaten via Altinn. Ingen manuell signering nødvendig.
+    Wenche skriver ut forsendelse-ID når innsendingen er fullført.
 
 ---
 
@@ -119,4 +202,4 @@ Du har nå:
 - [x] Sendt inn årsregnskapet til Brønnøysundregistrene
 - [x] Sendt inn aksjonærregisteroppgaven (RF-1086) til Skatteetaten
 
-Neste år gjentar du fra steg 1 med oppdaterte tall — og husk å fylle ut `foregaaende_aar` med årets tall for å få med sammenligningstall (rskl. § 6-6).
+Neste år gjentar du fra steg 2 med oppdaterte tall — og husk å fylle ut `foregaaende_aar` med årets tall for å få med sammenligningstall (rskl. § 6-6).

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "wenche"
-version = "0.8.0"
+version = "0.9.0"
 description = "Enkel innsending av årsregnskap, skattemelding og aksjonærregisteroppgave til Altinn for holdingselskaper"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -31,7 +31,7 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
-ui = ["streamlit>=1.30"]
+ui = ["nicegui>=2.0"]
 dev = ["pytest>=8.0", "mkdocs-material>=9.5"]
 
 [project.urls]