https://github.com/alipsa/accounting
Bokföringsprogram för små företag
https://github.com/alipsa/accounting
Last synced: 30 days ago
JSON representation
Bokföringsprogram för små företag
- Host: GitHub
- URL: https://github.com/alipsa/accounting
- Owner: Alipsa
- License: mit
- Created: 2026-04-08T18:54:39.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-19T11:16:12.000Z (about 1 month ago)
- Last Synced: 2026-05-19T12:07:53.600Z (about 1 month ago)
- Language: Groovy
- Size: 4.9 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# 
Alipsa Accounting
Desktopbaserat bokföringsprogram för små svenska företag.
Byggt med Groovy, Swing och en inbäddad H2-databas — inga externa tjänster behövs.
Programmet hanterar löpande bokföring, moms, rapporter, SIE-utväxling och årsbokslut.
Det är inte ett komplett affärssystem — fakturering, lönehantering, bankintegration och årsredovisningsflöden ingår inte.
## Funktioner
- **Flerföretagsstöd** — skapa och växla mellan flera företag i samma installation. Varje företag har egen kontoplan, egna räkenskapsår, nummerserier, hashkedjor och rapportarkiv. Data isoleras fullständigt via `company_id` i datamodellen.
- **Kontoplan** — BAS-baserad kontoplan med import från Excel och automatisk klassificering. Kontoplanen är företagsspecifik — två företag kan ha samma BAS-kontonummer utan konflikt.
- **Räkenskapsår och perioder** — skapa år, dela in i perioder och lås perioder när de är klara.
- **Verifikationer** — registrera, bokför och korrigera verifikationer med bilagor.
- **Moms** — beräkna, rapportera och bokför momsöverföring per period. Stöder månads-, kvartals- och årsmoms.
- **Rapporter** — generera verifikationslista, huvudbok, provbalans, resultat- och balansrapport, transaktionsrapport och momsrapport som PDF eller CSV. Rapporter arkiveras med checksumma.
- **SIE4** — importera och exportera bokföringsdata via SIE4 med dubblettskydd, automatisk import/ersätt-logik och integritetskontroll.
- **Bokslut** — stäng räkenskapsår med bokslutsverifikation och automatisk generering av nästa års ingående balanser.
- **Arkivering och radering** — arkivera företag som inte längre ska visas i normalflödet, återställ arkiverade företag och radera företag eller räkenskapsår när bevarandekraven tillåter det.
- **Kraschsäkra filarkiv** — bilagor och rapportarkiv verifieras vid start, och avbrutna bilageoperationer återställs eller rapporteras tydligt.
- **Revisionskedja** — alla väsentliga händelser loggas i en hashkedja för spårbarhet.
- **Uppdateringar och avinstallation** — kontrollera uppdateringar från programmet, installera generiska uppdateringsarkiv och använd plattformsspecifika avinstallationsskript med separata bekräftelser för programfiler och användardata.
### Avgränsningar
Följande funktioner ingår inte i v1.3.0:
- Fakturering och lön
- Bankintegration
- Årsredovisningsflöden
- Anläggningsregister (planerat till v1.4.0)
## Förutsättningar
- Java 21 eller senare
## Kom igång
```bash
git clone https://github.com/Alipsa/accounting.git
cd accounting
./gradlew run
```
Applikationen skapar sin H2-databas automatiskt vid första start.
## Bygg och kör
- `./gradlew build` kör full validering med kompilering, tester, Spotless och CodeNarc.
- `./gradlew test` kör testsviten.
- `./gradlew run` startar desktopapplikationen.
- `./gradlew :app:packageCurrentPlatformRelease` bygger releasepaket för aktuell plattform via `jpackage`.
- `./gradlew :app:verifyCurrentPlatformRelease` paketerar aktuell plattform och verifierar att launchern kan starta applikationen i ett isolerat hemkatalogsläge.
## Utveckling
### Projektstruktur
```
app/src/main/groovy/se/alipsa/accounting/
├── domain/ # domänmodeller
├── service/ # databas- och affärslogik
├── ui/ # Swing-paneler och dialoger
└── support/ # hjälpklasser
app/src/main/resources/
├── db/migrations/ # SQL-migrationer
└── reports/ # FreeMarker-mallar för PDF-rapporter
app/src/test/groovy/
├── unit/ # enhetstester
├── integration/ # integrationstester
└── acceptance/ # acceptanstester
req/ # kravdokumentation och färdplan
```
### Kommandon för utvecklare
```bash
./gradlew build # kompilering, tester, Spotless och CodeNarc
./gradlew test # kör enbart tester
./gradlew spotlessApply # auto-formatera kod
./gradlew spotlessCheck # kontrollera formatering utan att ändra
./gradlew codenarcMain # statisk analys på produktionskod
```
Kör alla kommandon från rotmappen.
### Teknikstack
| Komponent | Teknologi |
|---------------|-----------------------------------------|
| Språk | Groovy (`@CompileStatic`) |
| UI | Swing med flatlaf look and feel |
| Databas | H2 (inbäddad) |
| PDF-rapporter | Alipsa Journo (FreeMarker + HTML → PDF) |
| SIE-parsning | Alipsa SieParser |
| Bygg | Gradle 9.4 |
| Kodstil | Spotless + CodeNarc |
| Tester | JUnit 6 + groovier-junit |
## Drift och säkerhet
- Applikationen använder endast embedded H2 i fil-läge.
- Databasen, bilagor, rapportarkiv, loggar, backups och exporterad dokumentation lagras under applikationskatalogen i användarens profil.
- Startup-verifiering kontrollerar driftkonfiguration och integritet för hashkedjor, bilagor och rapportarkiv.
- Känsliga operationer som rapportexport, SIE-export, backup och årsstängning blockerar på kritiska integritetsfel.
- Bokföringsdata, bilagor och rapportarkiv omfattas av sju års bevarandespärr.
- Borttagning av räkenskapsår och företag visar förhandsgranskning eller blockerande fel innan data tas bort.
## Backup och restore
- Backupformatet är ZIP med:
- H2 `SCRIPT`-dump
- `manifest.txt` med schema-version och checksummor
- bilagearkiv
- rapportarkiv
- Restore verifierar manifest och checksummor innan data och filarkiv återskapas.
- Backup och restore kan köras från fliken `System`.
## Dokumentation
- Fliken `System` visar diagnostik, backup/restore och inbyggd systemdokumentation.
- Hjälpmenyn öppnar användarmanualen från `app/src/main/resources/docs/user-manual.md`.
## AI/MCP och LLM-klienter
Alipsa Accounting kan köras i två lägen:
- **Desktopläge** — standardläget med Swing-gränssnittet.
- **MCP-läge** — ett headless stdio-läge för LLM-klienter som kan prata Model Context Protocol.
MCP-läget startas med `--mode=mcp` och använder samma lokala H2-databas, samma valideringar och samma affärsregler som desktopappen. Servern exponerar verktyg för bland annat företag, räkenskapsår, konton, verifikationer, rapporter, moms, bokslut samt SIE-import och SIE-export. Den skriver JSON-RPC-svar på stdout; loggar och fel skrivs inte till stdout.
Exempel vid utveckling:
```bash
./gradlew run --args='--mode=mcp'
```
Exempel från en installerad eller uppackad distribution:
```bash
# Linux/macOS
/path/to/AlipsaAccounting --mode=mcp
# Windows
C:\path\to\AlipsaAccounting.exe --mode=mcp
```
En LLM CLI, till exempel Claude Code eller Codex, behöver normalt två saker:
1. **MCP-serverkonfiguration** som pekar på Alipsa Accounting-kommandot med argumentet `--mode=mcp`.
2. **Skill-instruktioner** från `skill/accounting-mcp.md`, som beskriver bokföringsarbetsflöden, bekräftelsekrav och säkerhetsregler för LLM:en.
MCP-servern ger klienten verktygen. Skill-filen styr hur LLM:en bör använda verktygen. Skill-filen installeras inte automatiskt av Claude Code eller Codex; se releaseavsnittet nedan för hur den länkas eller kopieras till respektive klients skill-katalog.
## Release
### Nedladdningar
Varje release publiceras på [GitHub Releases](https://github.com/Alipsa/accounting/releases) med tre användardistributioner och ett generiskt uppdateringsarkiv:
| Fil | Plattform |
|-------------------------------------------|-----------------------------------------------------------------------|
| `alipsa-accounting--linux.zip` | Linux — app-image, install-/avinstallationsskript och `skill/accounting-mcp.md` |
| `alipsa-accounting--windows.zip` | Windows — exe-installerare, cleanup-skript och `skill/accounting-mcp.md` |
| `alipsa-accounting--macos.zip` | macOS — `AlipsaAccounting.app`, avinstallationsskript och `skill/accounting-mcp.md` |
| `app-.zip` | Generiskt arkiv som används av den inbyggda automatiska uppdateraren |
Varje distributionsfil åtföljs av två verifieringsfiler:
- **`.sha256`** — SHA-256-kontrollsumma. Verifiera att nedladdningen är intakt:
```
sha256sum -c alipsa-accounting--linux.zip.sha256
```
- **`.asc`** — GPG-signatur. Verifiera att filen är publicerad av releaseansvarig:
```
gpg --verify alipsa-accounting--linux.zip.asc alipsa-accounting--linux.zip
```
För vanliga användare räcker det att ladda ner distributionsfilen. Verifieringsfilerna riktar sig till den som vill kontrollera filens integritet och äkthet.
### Artifact verification and signing
Released artifacts are accompanied by SHA-256 checksum files and GPG signatures so the download can be verified after publication.
The project does not currently ship platform-trusted code signatures for Windows or notarized/signature-stamped macOS app bundles. Users on those platforms may therefore see the standard unsigned-application warnings from the operating system.
- Committers and reviewers: repository contributors with write access to the project. Public contribution history: [Contributors](https://github.com/Alipsa/accounting/graphs/contributors)
- Release approvers: project maintainers responsible for publication. Current project home page: [Alipsa/accounting](https://github.com/Alipsa/accounting)
- Privacy policy: [docs/privacy-policy.md](docs/privacy-policy.md)
The application stores accounting data locally on the user's system.
The application does not upload accounting records, attachments, reports, backups, or exported files to project-operated servers.
The application can perform a background update check against GitHub Releases on startup, and may download release artifacts from GitHub when the user explicitly chooses to install an update. Automatic update checks can be disabled in Settings. See the privacy policy for details.
The in-app updater uses the generic `app-.zip` archive and updates the installed jpackage app image in place. Platform release zips are used for fresh installs or manual upgrades.
### Bygga en release
Releasebyggen använder `jpackage` och kräver Java 21 med tillhörande paketeringsverktyg på respektive plattform.
- Linux: `./gradlew :app:packageLinuxReleaseZip`
- Windows: `./gradlew :app:packageWindowsRelease`
- macOS: `./gradlew :app:packageMacosRelease`
- Aktuell plattform: `./gradlew :app:packageCurrentPlatformRelease`
- Smoke test av aktuell plattform: `./gradlew :app:verifyCurrentPlatformRelease`
Om Gradle hittar fel JDK för jpackage (t.ex. en inbäddad JDK utan jpackage) kan sökvägen sättas explicit:
```
./gradlew :app:verifyCurrentPlatformRelease -Pjpackage.executable=/path/to/jdk-21/bin/jpackage
```
Byggartefakter skrivs till `app/build/release/` och använder samma appnamn, versionsnummer och ikonuppsättning för alla tre plattformar.
Alla tre plattformsreleaserna producerar ett zip-arkiv som innehåller `skill/accounting-mcp.md`. Linux-arkivet innehåller app-imagen samt `install.sh` och `uninstall.sh`. Windows-arkivet innehåller exe-installeraren med meny- och skrivbordsgenväg samt `uninstall-cleanup.ps1` för valfri borttagning av kvarvarande installationskatalog och användardata. macOS-arkivet innehåller `AlipsaAccounting.app` och `uninstall.command`.
Claude Code och Codex läser inte automatiskt `skill/`-katalogen; extrahera arkivet och länka eller kopiera den till klientens skill-katalog:
```
# Claude Code
ln -s /path/to/release/skill ~/.claude/skills/accounting
# Codex
ln -s /path/to/release/skill ~/.agents/skills/accounting
# Windows PowerShell, Claude Code
New-Item -ItemType Junction -Path "$HOME\.claude\skills\accounting" -Target "C:\path\to\release\skill"
# Windows PowerShell, Codex
New-Item -ItemType Junction -Path "$HOME\.agents\skills\accounting" -Target "C:\path\to\release\skill"
```
Applikationen använder plattformsspecifika standardvägar för data och loggar:
- Linux: `~/.local/share/alipsa-accounting`
- Windows: `%APPDATA%\\Alipsa\\Accounting`
- macOS: `~/Library/Application Support/AlipsaAccounting`
Datakatalogen är skild från applikationsinstallationen. Det innebär att befintlig data är tillgänglig direkt när en ny version installeras — ingen manuell flytt behövs. På Windows tar avinstallationen av den gamla versionen inte bort `%APPDATA%\Alipsa\Accounting`.
Avinstallationsskripten frågar innan de tar bort installationskatalogen och frågar separat innan de tar bort användardata. Standardvalet är att behålla både installation och data om användaren bara trycker Enter.
Signering av Windows-installatör och notarisering/signering av macOS-app är avsiktligt lämnade som framtida release-steg. Nuvarande buildflöde producerar signerbara artefakter men utför inte signering automatiskt.