boc/landvex-admin-v2/README.md

# AAMOS Admin v2 — Fullständig affärsplattform

## Moduler

### 1. CRM (Kundhantering)
- **Kunder** — Fullständig kunddatabas med org.nr, adresser, kontaktuppgifter
- **Leads** — Automatisk lead-generering från alla 3 sajter
- **Konvertering** — Enkelt konvertera leads till kunder

### 2. Fakturering
- **Fakturor** — Skapa, skicka, spåra fakturor
- **Avtal** — Hantera återkommande avtal med automatisk fakturering
- **Inbetalningar** — Registrera och avstämma inbetalningar
- **Påminnelser** — Automatiska påminnelser vid försenade betalningar

### 3. Bokföring (Fortnox-nivå)
- **Konton** — BAS-kontoplan med saldon
- **Verifikat** — Manuella och automatiska verifikat
- **Trial Balance** — Automatisk balansering
- **Perioder** — Öppna/stänga räkenskapsperioder
- **Avstämning** — Bankavstämning

### 4. Rapporter
- **Balansräkning** — Tillgångar, skulder, eget kapital
- **Resultaträkning** — Intäkter, kostnader, resultat
- **Momsrapport** — Momsredovisning per period
- **Kundreskontra** — Obetalda fakturor per kund
- **Omsättning** — Månadsvis trend
- **Fakturaåldersanalys** — Förfallna fakturor

### 5. Automationer
- **Schemalagda** — Återkommande uppgifter (fakturering, påminnelser)
- **Event-baserade** — Triggas av händelser
- **Manuella** — Kör på begäran

### 6. Mailklient
- **Alla källor** — quiXzoom, Landvex, AAMOS
- **Väntelista** — Automatisk synk från quiXzoom
- **Kontaktformulär** — Från Landvex och AAMOS
- **Svara** — Direkt från adminpanelen
- **Konvertera** — Mail → Lead med ett klick

### 7. Support
- **Ärenden** — Ticket-hantering med prioritet och kategorier
- **Tilldelning** — Tilldela ärenden till handläggare
- **Meddelanden** — Konversationer inom ärenden
- **FAQ** — Kunskapsbas med sök

### 8. HR
- **Personal** — Fullständig medarbetarregister
- **Avtal** — Anställningsavtal med probetid och villkor
- **Löner** — Månadslön, övertid, bonus, skatt
- **Dokument** — Anställningsavtal, intyg, medarbetarsamtal
- **Avdelningar** — Organisationsstruktur

### 9. Intern Chatt 💬
- **Kanaler** — #general, #support, #hr, #försäljning, #teknik
- **Direktmeddelanden** — Privata konversationer
- **@mentions** — Omnämna kollegor med notiser
- **Ärendedelning** — Dela supportärenden till kanaler med full spårbarhet
- **Online-status** — Se vem som är online
- **Olästa meddelanden** — Badge-räknare
- **Auto-poll** — Uppdaterar var 10:e sekund

### 10. Notiscenter
- **Realtidsnotifieringar** — Alla händelser i systemet
- **Filtrering** — Per typ: leads, fakturor, ärenden, HR
- **Markera lästa** — Enkel eller alla
- **Navigering** — Klicka för att gå till relevant modul
- **Badge** — Visar antal olästa notiser

### 11. Rapportcenter
- **Ekonomi** — Balansräkning, resultaträkning, moms, omsättning, fakturaåldersanalys
- **CRM** — Kundtillväxt, lead-konvertering
- **Support** — Prestanda, kundnöjdhet
- **HR** — Personalstyrka, lönedistribution
- **Export** — CSV-export av alla rapporter

### 12. Inställningar
- **Företag** — Namn, org.nr, adress, betalningsvillkor
- **Moduler** — Per-modul konfiguration
- **Notiser** — Välj vilka händelser som notifierar
- **Integrationer** — quiXzoom, Landvex, SMTP

### 13. Kundportal
- **Översikt** — Aktiva avtal, obetalda fakturor
- **Avtal** — Se och hantera avtal
- **Fakturor** — Ladda ner PDF, betala online
- **Inställningar** — Uppdatera företagsinformation

## Webhook-endpoints

### quiXzoom väntelista
```
POST /api/mail/webhook/quixzoom
{
  "email": "user@example.com",
  "phone": "+46701234567",
  "name": "Test User",
  "source": "quixzoom.com/waitlist"
}
```

### Landvex kontakt
```
POST /api/mail/webhook/landvex
{
  "email": "contact@company.se",
  "name": "Erik Svensson",
  "company": "Acme AB",
  "message": "Intresserad av VIMS"
}
```

### AAMOS kontakt
```
POST /api/mail/webhook/aamos
{
  "email": "info@company.se",
  "name": "Johan Berglund",
  "product_interest": "AMOS Vision"
}
```

## Chatt API

### Kanaler
- `GET /api/chat/channels` — Lista kanaler
- `POST /api/chat/channels` — Skapa kanal
- `GET /api/chat/channels/:id/messages` — Hämta meddelanden
- `POST /api/chat/channels/:id/messages` — Skicka meddelande
- `POST /api/chat/channels/:id/read` — Markera som läst

### Ärendedelning
- `POST /api/chat/share-ticket` — Dela ärende till kanal
- `GET /api/chat/ticket-shares/:ticketId` — Se delningshistorik

### Direktmeddelanden
- `GET /api/chat/direct/:userId` — Hämta DM-kanal

### Närvaro
- `POST /api/chat/presence` — Uppdatera status
- `GET /api/chat/presence/:userId` — Hämta status

### Olästa
- `GET /api/chat/unread` — Hämta olästa räknare

## Installation

```bash
npm install
node src/index.mjs
```

## Databas

PostgreSQL med följande tabeller:
- `billing_customers` — Kunder
- `crm_leads` — Leads
- `billing_agreements` — Avtal
- `billing_invoices` — Fakturor
- `billing_payments` — Inbetalningar
- `mail_messages` — Mail
- `support_tickets` — Supportärenden
- `support_messages` — Ärendemeddelanden
- `support_faq` — FAQ
- `hr_employees` — Anställda
- `hr_contracts` — Anställningsavtal
- `hr_documents` — HR-dokument
- `hr_salary` — Löner
- `hr_departments` — Avdelningar
- `chat_channels` — Chattkanaler
- `chat_messages` — Chattmeddelanden
- `chat_presence` — Närvaro
- `ticket_shares` — Ärendedelningar
- `automations` — Automationer
- `notifications` — Notiser
- `module_settings` — Modulinställningar
- `settings` — Allmänna inställningar

## API-endpoints

### Notiser
- `GET /api/notifications` — Lista notiser
- `POST /api/notifications/:id/read` — Markera som läst
- `POST /api/notifications/read-all` — Markera alla som lästa
- `GET /api/notifications/settings` — Hämta inställningar
- `POST /api/notifications/settings` — Spara inställningar

### Rapporter
- `GET /api/reports/dashboard` — Dashboard-data
- `GET /api/reports/crm/customer-growth` — Kundtillväxt
- `GET /api/reports/crm/lead-conversion` — Lead-konvertering
- `GET /api/reports/billing/revenue` — Omsättning
- `GET /api/reports/billing/aging` — Fakturaåldersanalys
- `GET /api/reports/support/performance` — Supportprestanda
- `GET /api/reports/support/satisfaction` — Kundnöjdhet
- `GET /api/reports/hr/headcount` — Personalstyrka
- `GET /api/reports/hr/salary-distribution` — Lönedistribution

### Inställningar
- `GET /api/settings` — Hämta företagsinställningar
- `POST /api/settings` — Spara företagsinställningar
- `GET /api/settings/modules/:module` — Hämta modulinställningar
- `POST /api/settings/modules/:module` — Spara modulinställningar
- `POST /api/settings/integrations` — Spara integrationsinställningar

## Landvex Platform Integration

Synkronisering med Landvex kundportal:
- Kunder synkas automatiskt
- Avtal synkas vid skapande
- Fakturor synkas vid skickande
- Kunder kan se sina avtal och fakturor i portalen

## Övervakning

Dashboard visar:
- Omsättning (år)
- Obetalda fakturor
- Aktiva kunder
- quiXzoom statistik
- Bokföringsstatus
- Mail-statistik
- Supportärenden
- HR-statistik
- Olästa chattmeddelanden
- Systemhälsa