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

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