Bernt
148 lines
4.2 KiB
Markdown
148 lines
4.2 KiB
Markdown
# CLAUDE.md — aamos-ledger
|
||
|
||
> AI-kontext för alla som jobbar i detta repo.
|
||
|
||
## Vad är detta?
|
||
|
||
**aamos-ledger** är LandveX AB:s bokföringsmotor — en komplett, egenutvecklad redovisningsmotor med:
|
||
- Dubbel bokföring (debet = kredit, alltid)
|
||
- BAS 2024 kontoplan (svensk standard)
|
||
- SIE4-import och export
|
||
- Multi-tenant isolering (tenant_id på varje rad)
|
||
- Full audit trail (varje operation sparas i `ledger_audit_log`)
|
||
- Hermes event-publicering (alla ekonomiska händelser)
|
||
|
||
**Port:** 3250
|
||
**Tenant för LandveX AB:** `landvex`
|
||
**Tjänstnamn (systemd):** `aamos-ledger`
|
||
|
||
---
|
||
|
||
## Arkitektur
|
||
|
||
```
|
||
index.mjs — Express-app, alla API-routes
|
||
schema.sql — PostgreSQL-schema (kör vid start via initSchema())
|
||
hermes.mjs — Event-publishing till Hermes fabric
|
||
sie4-export.mjs — SIE4-exportlogik
|
||
Dockerfile.migrate — DB-migration container
|
||
package.json — Node ESM-modul
|
||
```
|
||
|
||
### Databasschema (nyckelltabeller)
|
||
|
||
| Tabell | Beskrivning |
|
||
|--------|------------|
|
||
| `ledger_accounts` | Kontoplan (BAS 2024, IFRS, custom) |
|
||
| `ledger_journal_entries` | Verifikationer (IMMUTABLE efter `posted`) |
|
||
| `ledger_entry_lines` | Kontolinjer per verifikat (debet/kredit) |
|
||
| `ledger_periods` | Perioder (`open`/`closed`/`locked`) |
|
||
| `ledger_audit_log` | Audit trail för varje operation |
|
||
| `ledger_reconciliation_items` | Kontoavstämning |
|
||
| `ledger_period_close_tasks` | Periodeclose workflow |
|
||
| `ledger_vat_returns` | Momsdeklarationer |
|
||
| `ledger_fiscal_years` | Räkenskapsår |
|
||
|
||
---
|
||
|
||
## API-design
|
||
|
||
Alla endpoints kräver auth (JWT eller API-key). Tenant sätts via:
|
||
- Header: `X-Tenant-ID: landvex`
|
||
- Body: `{ "tenant_id": "landvex" }`
|
||
|
||
Exempel:
|
||
```bash
|
||
GET /api/accounts?tenant=landvex
|
||
POST /api/journal-entries
|
||
GET /api/periods?tenant=landvex
|
||
POST /api/sie4/export
|
||
```
|
||
|
||
Trace-propagering via headers:
|
||
- `X-Trace-ID` — propageras genom hela systemet
|
||
- `X-Correlation-ID` — korrelation per request-träd
|
||
- `X-User-ID` — vem som triggar
|
||
|
||
---
|
||
|
||
## Designprinciper (OBRYTBARA)
|
||
|
||
1. **Determinism före AI** — alla bokföringsbeslut reproducerbara
|
||
2. **Audit First** — VARJE operation genererar auditpost
|
||
3. **Tenant Isolation** — kunddata korsas aldrig, `tenant_id` filtreras alltid
|
||
4. **Hermes** — ekonomiska händelser publiceras via event fabric
|
||
5. **Inga direktberoenden** — till andra moduler (utom Hermes via events)
|
||
6. **IMMUTABLE journal** — poster ändras ALDRIG efter `status=posted`; annullering = ny `voided`-post
|
||
|
||
---
|
||
|
||
## Etapp 1 — Vertikal stängning (pågår juni 2026)
|
||
|
||
Checklista:
|
||
- [x] Chart of Accounts (BAS 2024)
|
||
- [x] Journal Entries med audit trail
|
||
- [x] SIE4-import
|
||
- [ ] **E1-004** Reconciliation Engine
|
||
- [ ] **E1-005** Period Close Workflow
|
||
- [ ] **E1-006** SIE4 Export (komplett)
|
||
- [ ] Auth mot Identity Service
|
||
- [ ] aamos-audit-engine restart-fix
|
||
- [ ] **E1-008** Vertikal stängning acceptanstest
|
||
|
||
---
|
||
|
||
## LandveX AB — Nuläge (per 2026-06-17)
|
||
|
||
| Mått | Värde |
|
||
|------|-------|
|
||
| Journalposter totalt | ~710 |
|
||
| Alla poster | `posted` (inga drafts) |
|
||
| Obalanserade poster | **0** |
|
||
| Aktiva konton | 38 |
|
||
| Revolut-poster på 1689 (oklassificerade) | ~545 / 966 685 kr |
|
||
| Q1-moms förfallen | **202 787 kr** — OBETALD |
|
||
| Leon-fordran | **212 922 kr** (konto 1610) |
|
||
| Trygg Bil-avtal | 222 916 kr/mån t.o.m. mars 2027 |
|
||
|
||
---
|
||
|
||
## Ekonomisystem — Fortnox-klonen i Ouroboros
|
||
|
||
Live-URLer:
|
||
- **Fortnox-klonen:** https://landvex.com/ouroboros/finance/
|
||
- **Verifikatsvy:** https://landvex.com/ouroboros/finance/ledger.html
|
||
- **CFO-dashboard:** https://landvex.com/public/cfo-dashboard.html
|
||
|
||
Filer på disk:
|
||
- `/opt/amos/public/ouroboros/finance/index.html`
|
||
- `/opt/amos/public/ouroboros/finance/ledger.html`
|
||
- `/opt/amos/public/public/cfo-dashboard.html`
|
||
|
||
---
|
||
|
||
## Kör lokalt
|
||
|
||
```bash
|
||
cd /home/bernt/.openclaw/workspace/aamos-ledger
|
||
# eller källkoden live på servern:
|
||
sudo -n systemctl status aamos-ledger
|
||
sudo -n journalctl -u aamos-ledger -n 50
|
||
|
||
# Health check
|
||
curl -sk http://localhost:3250/health
|
||
```
|
||
|
||
---
|
||
|
||
## Bolagsinfo
|
||
|
||
- **Bolag:** LandveX AB (org.nr 559141-7042, f.d. Sommarliden Holding AB)
|
||
- **Räkenskapsår:** 1 maj – 30 april
|
||
- **FY 2025/2026:** avslutat, bokslut senast 31 okt 2026
|
||
- **Revisor:** Andreas Vretblad, KPMG, +46 70 865 67 27
|
||
|
||
---
|
||
|
||
*Senast uppdaterad: 2026-06-17*
|