docs: add quixzoom-auth-core product to AAMOS
- Product documentation in docs/products/ - Updated MEMORY.md with product info - quiXzoom Auth Core as AAMOS Identity product
This commit is contained in:
Bernt
+212
-29
@@ -1,45 +1,228 @@
|
||||
# LandveX Admin v2
|
||||
# AAMOS Admin v2 — Fullständig affärsplattform
|
||||
|
||||
## Vad detta är
|
||||
## Moduler
|
||||
|
||||
En **adapter-baserad admin-konsol** som kopplar ihop dina befintliga system — inte ett nytt system.
|
||||
### 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
|
||||
|
||||
## Arkitektur
|
||||
### 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
|
||||
```
|
||||
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
|
||||
│ Din │────▶│ Admin v2 │────▶│ aamos- │
|
||||
│ Webbläsare│ │ Adapter │ │ ledger │
|
||||
│ │ │ (3456) │ │ (3250) │
|
||||
└─────────────┘ └─────────────┘ └─────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────┐
|
||||
│ ouroboros- │
|
||||
│ finance │
|
||||
│ (3202) │
|
||||
└─────────────┘
|
||||
POST /api/mail/webhook/quixzoom
|
||||
{
|
||||
"email": "user@example.com",
|
||||
"phone": "+46701234567",
|
||||
"name": "Test User",
|
||||
"source": "quixzoom.com/waitlist"
|
||||
}
|
||||
```
|
||||
|
||||
## Starta
|
||||
### 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
|
||||
cd /home/bernt/.openclaw/workspace/landvex-admin-v2
|
||||
npm install
|
||||
node src/index.mjs
|
||||
```
|
||||
|
||||
## Endpoints
|
||||
## Databas
|
||||
|
||||
- `GET /health` — Systemstatus
|
||||
- `GET /api/finance/overview` — Kopplingsstatus
|
||||
- `GET /api/finance/balance` — Bankbalans (USD)
|
||||
- `GET /api/finance/ledger?period=2026-06` — Verifikat
|
||||
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
|
||||
|
||||
## Nästa steg
|
||||
## API-endpoints
|
||||
|
||||
1. [ ] Koppla CRM (aamos-crm)
|
||||
2. [ ] Koppla Support (aamos-incidents)
|
||||
3. [ ] Koppla AI/ML (ai-gateway)
|
||||
4. [ ] Lägg till autentisering
|
||||
5. [ ] Deploya till admin.landvex.com
|
||||
### 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
|
||||
|
||||
Reference in New Issue
Block a user