boc/AMOS_SYSTEM_OVERVIEW.md

# AMOS — AI Management Operating System

## Översikt

AMOS är ett komplett företagsoperativsystem byggt för AI-åldern. Det kombinerar CRM, försäljning, ekonomi, HR, juridik, marknadsföring, support och automation i en enhetlig plattform.

## Arkitektur

```
┌─────────────────────────────────────────┐
│           Kong API Gateway              │
│    (SSL, Auth, Rate limit, Routing)     │
└─────────────────────────────────────────┘
                   │
    ┌──────────────┼──────────────┬──────────────┐
    ▼              ▼              ▼              ▼
┌────────┐   ┌──────────┐   ┌──────────┐   ┌──────────┐
│ AMOS   │   │  BOC     │   │ quiXzoom │   │  Rust    │
│ Admin  │   │  Engine  │   │  Engine  │   │  Economy │
│ (Go)   │   │  (Go)    │   │  (Go)    │   │ (Ledger) │
└────────┘   └──────────┘   └──────────┘   └──────────┘
    │              │              │              │
    └──────────────┴──────────────┴──────────────┘
                   │
        ┌─────────────────┐
        │   PostgreSQL    │
        │  (RDS, schemas) │
        │  public, boc,   │
        │  quixzoom,ledger│
        └─────────────────┘
                   │
        ┌─────────────────┐
        │     Redis       │
        │ (Cache,Session) │
        └─────────────────┘
                   │
        ┌─────────────────┐
        │     Kafka       │
        │ (Event Bus)     │
        └─────────────────┘
```

## Komponenter

### Frontend (React 19 + Vite + Tailwind)
- **Design**: Claude Light Edition — extrem minimalism, whitespace, premium feel
- **Plats**: `/home/bernt/.openclaw/workspace/boc/web-v2/`
- **Deploy**: `admin.aamos.systems`

### BOC Backend (Go)
- **Plats**: `/home/bernt/.openclaw/workspace/boc/backend/`
- **Port**: 9092 (Docker → 9096)
- **Moduler**: CRM, Sales, Finance, HR, Legal, Marketing, Support, Automation
- **Auth**: RS256 (prexo-identity)

### Ledger (Rust)
- **Plats**: `/home/bernt/.openclaw/workspace/aamos-ledger-rust/`
- **Port**: 3250
- **Funktion**: Dubbel bokföring, BAS-konton, SIE4, moms

### Databas
- **PostgreSQL RDS**: `wavult-identity-core.cvi0qcksmsfj.eu-north-1.rds.amazonaws.com`
- **Schemas**: `public` (core), `boc` (operations), `quixzoom` (platform), `ledger` (bokföring)

## API Endpoints

### Auth
```
POST /api/v1/auth/login     → RS256 token (via prexo-identity)
GET  /api/v1/auth/me        → Current user
POST /api/v1/auth/logout    → Invalidate token
```

### CRM
```
GET    /api/v1/crm/customers              → List customers
POST   /api/v1/crm/customers              → Create customer
GET    /api/v1/crm/customers/{id}         → Get customer
PUT    /api/v1/crm/customers/{id}         → Update customer
DELETE /api/v1/crm/customers/{id}         → Delete customer
GET    /api/v1/crm/leads                  → List leads
GET    /api/v1/crm/pipeline               → Get pipeline
POST   /api/v1/crm/interactions           → Create interaction
```

### Sales
```
GET /api/v1/sales/deals     → List deals
GET /api/v1/sales/mrr       → MRR metric
GET /api/v1/sales/arr       → ARR metric
GET /api/v1/sales/products  → List products
```

### Finance
```
GET /api/v1/finance/balance    → Balance sheet (from ledger)
GET /api/v1/finance/income     → Income statement
GET /api/v1/finance/moms       → VAT report
GET /api/v1/finance/accounts   → Chart of accounts
GET /api/v1/finance/invoices   → Invoices
GET /api/v1/finance/cashflow   → Cashflow
GET /api/v1/finance/budget     → Budget
```

### HR
```
GET  /api/v1/hr/employees    → List employees
POST /api/v1/hr/employees    → Create employee
GET  /api/v1/hr/leaves       → List leaves
GET  /api/v1/hr/timesheets   → List timesheets
```

### Legal
```
GET  /api/v1/legal/contracts → List contracts
POST /api/v1/legal/contracts → Create contract
```

### Settings
```
GET  /api/v1/settings        → Get all settings
PUT  /api/v1/settings        → Update settings
GET  /api/v1/settings/modules/{id}/toggle → Toggle module
```

## Konfiguration

### System-wide Settings
Fil: `/home/bernt/.openclaw/workspace/boc/web-v2-config.json`

Allt går att konfigurera:
- **Appearance**: tema, densitet, sidebar, animationer
- **Dashboard**: KPIs, charts, activity feed
- **Modules**: aktivera/avaktivera moduler och features
- **Notifications**: kanaler, events
- **Integrations**: bank, email, SMS
- **Permissions**: roller och rättigheter
- **Advanced**: API limits, cache, logging, export

### Default Behavior
- Allt fungerar out-of-the-box med smarta defaults
- Ingen konfiguration krävs för att komma igång
- Finjusteringar finns under Settings → Advanced

## Utveckling

### Bygga Frontend
```bash
cd /home/bernt/.openclaw/workspace/boc/web-v2
npm install
npm run dev     # Development
npm run build   # Production
```

### Bygga Backend
```bash
cd /home/bernt/.openclaw/workspace/boc/backend
go build -o bin/boc .
```

### Deploy
```bash
cd /home/bernt/.openclaw/workspace/boc
docker compose up -d
```

## Miljövariabler

### BOC Backend
```env
PORT=9092
DB_URL=postgres://boc:password@postgres:5432/boc?sslmode=disable
JWT_SECRET=your-secret
REDIS_URL=redis://redis:6379
LEDGER_URL=http://172.17.0.1:3250
AMOS_BASE_URL=http://172.17.0.1:3250
```

### Ledger (Rust)
```env
DATABASE_URL=postgres://wavult_admin:password@host:5432/amos?sslmode=disable
JWT_SECRET=your-secret
PORT=3250
```

## Teknikstack

| Komponent | Teknik | Varför |
|-----------|--------|--------|
| Frontend | React 19 + Vite + Tailwind | Snabb, modern, typad |
| Backend | Go | Snabb, enkel, bra för API:er |
| Economy | Rust | Prestanda, säkerhet, precision |
| Databas | PostgreSQL | Pålitlig, skalbar, ACID |
| Cache | Redis | Snabb, enkel |
| Events | Kafka | Durable, skalbar |
| Gateway | Kong | Standard, pålitlig |
| Auth | RS256 (prexo-identity) | Säker, federerad |

## Roadmap

### Nu (v2.0)
- ✅ Claude Light Design
- ✅ Unified backend (BOC)
- ✅ Ledger integration
- ✅ Module system
- ✅ Settings API

### Nästa (v2.1)
- 🔄 Bank integration
- 🔄 Email/SMS notifications
- 🔄 Advanced analytics
- 🔄 Mobile app

### Framtid (v3.0)
- 🔄 AI-assistent
- 🔄 Prediktiv analys
- 🔄 Autonoma arbetsflöden
- 🔄 Multi-tenant

---

*AMOS — Det här känns som Claude, men för företag.*