boc/docs/MASTER_BACKEND_PLAN_v3.md

Master Backend Plan v3.0 — LandveX Operations Platform

Vision

En unified operations platform som hanterar ALLT utöver kärnprodukten:

• Kunder & avtal
• Fakturering & betalning
• Support & ärenden
• Press & kommunikation
• API-nycklar & åtkomst
• Ekonomi & redovisning

Arkitektur: "One Gateway, Many Services"

                    ┌─────────────────┐
                    │   LandveX UI    │
                    │  (React/Vite)   │
                    └────────┬────────┘
                             │
              ┌──────────────┼──────────────┐
              │              │              │
        ┌─────▼─────┐ ┌─────▼─────┐ ┌─────▼─────┐
        │  Public   │ │Professional│ │ Enterprise │
        │  (gratis) │ │ (betalt)   │ │ (avtal)    │
        └─────┬─────┘ └─────┬─────┘ └─────┬─────┘
              │              │              │
              └──────────────┼──────────────┘
                             │
                    ┌────────▼────────┐
                    │ LandveX Gateway │  ← Auth, routing, rate limits
                    │   (port 3004)   │
                    └────────┬────────┘
                             │
        ┌────────────────────┼────────────────────┐
        │                    │                    │
   ┌────▼────┐         ┌────▼────┐         ┌────▼────┐
   │Intelligence│      │Operations │       │  Billing  │
   │  Lab      │       │ Platform  │       │ Engine    │
   │(3002)     │       │(3004)     │       │(Rust)     │
   └───────────┘       └────┬─────┘       └───────────┘
                            │
        ┌───────────────────┼───────────────────┐
        │                   │                   │
   ┌────▼────┐        ┌────▼────┐        ┌────▼────┐
   │  CRM    │        │ Support │        │  Press  │
   │(Apollo) │        │(3303)   │        │         │
   └─────────┘        └─────────┘        └─────────┘

Services (befintliga + nya)

✅ Redan igång

Tjänst	Port	Tech	Status
Intelligence Lab	3002	Node.js	✅ MVP-0
Gateway	3004	Node.js	✅ Just startad
Apollo CRM	3001	Node.js	🔄 Behöver startas
AAMOS Gateway	8080	Go	✅ Kör
AAMOS CRM	3301	Go	✅ Kör
AAMOS Incidents	3303	Go	✅ Kör
AAMOS Ledger	3250	Rust	✅ Kör
AMOS Billing	?	Rust	✅ Kör

🆕 Nya tjänster att bygga

Tjänst	Port	Tech	Beskrivning
Operations API	3005	Node.js	Government portal, avtal, inställningar
Press Engine	3006	Node.js	Pressmeddelanden, nyhetsbrev
API Key Manager	3007	Node.js	API-nycklar, rate limits, access logs
Stripe Adapter	3008	Node.js	Stripe integration, webhooks
PEPPOL Gateway	3009	Node.js	Elektronisk faktura till myndigheter

Dataflöde: Government Customer

1. Myndighet registrerar sig
   → Skapas i Operations API
   → Skapas i Stripe som customer
   → Skapas i AAMOS Ledger som kund

2. Myndighet konfigurerar betalning
   → Sparas i Operations API
   → Uppdaterar Stripe customer
   → Validerar org-nr mot Skatteverket

3. Myndighet beställer uppdrag
   → Skapas i Intelligence Lab
   → Kostnad beräknas
   → Förbrukning uppdateras i Operations API

4. Uppdrag genomförs
   → Status uppdateras i Intelligence Lab
   → Kostnad bokförs i AAMOS Ledger
   → Faktura genereras (Stripe/PEPPOL)

5. Faktura betalas
   → Stripe webhook → Operations API
   → AAMOS Ledger uppdateras
   → Status ändras till "betald"

Teknisk Stack

Gateway (port 3004)

• Express.js med proxy middleware
• JWT auth med roller
• Rate limiting per API-nyckel
• Request logging och tracing

Operations API (port 3005)

• Express.js + TypeScript
• PostgreSQL för data
• Integrationer:
  • Stripe (betalning)
  • AAMOS Ledger (bokföring)
  • Skatteverket (org-nr validering)
  • PEPPOL (elektronisk faktura)

Press Engine (port 3006)

• Express.js + TypeScript
• PostgreSQL
• Mailgun/SendGrid för utskick
• RSS-flöde
• Arkiv med sök

API Key Manager (port 3007)

• Express.js + TypeScript
• Redis för rate limiting
• PostgreSQL för nycklar
• Audit log för alla anrop

Implementation Plan

Sprint 1: Gateway + Operations API (2 veckor)

• Gateway med auth och routing
• Operations API grund
• Government customer model
• Grundläggande CRUD

Sprint 2: Betalning + Faktura (2 veckor)

• Stripe integration
• Fakturagenerering (PDF)
• Kostnadsöversikt
• Budgetvarningar

Sprint 3: PEPPOL + Avancerat (2 veckor)

• PEPPOL gateway
• Org-nr validering
• Attestflöde
• Användarroller

Sprint 4: Press + API Keys (2 veckor)

• Press engine
• API key manager
• Dokumentation
• Monitoring

Kostnad

Komponent	Beräknad kostnad
Utveckling	4 sprintar × 2 veckor
Stripe	1.5% + 1.80 kr per transaktion
PEPPOL	~0.50 kr per faktura
Drift	ECS/Fargate ~$50/mån

Nästa steg

1. Starta Apollo CRM (port 3001)
2. Bygg Operations API (port 3005)
3. Konfigurera Stripe
4. Testa fakturaflöde

---

Status: Plan klar. Väntar på go-ahead för implementation.