# BOC — Business Operations Center

**Domän:** boc.aamos.com

Företagets kontrollrum. Inte utveckling — utan verksamheten.

## Arkitektur

```
┌─────────────────────────────────────────────────────────────┐
│                         BOC STACK                           │
├─────────────────────────────────────────────────────────────┤
│  Frontend (HTML/JS/CSS)  │  Mobile-first, extremt enkelt   │
├─────────────────────────────────────────────────────────────┤
│  Go Backend (API Gateway) │  Auth, CRUD, WebSocket, Cron   │
├─────────────────────────────────────────────────────────────┤
│  Redis                    │  Cache, sessions, rate limit   │
├─────────────────────────────────────────────────────────────┤
│  Kafka                    │  Event streaming, audit log    │
├─────────────────────────────────────────────────────────────┤
│  Rust Service (Analytics) │  Rapporter, batch, parallel    │
├─────────────────────────────────────────────────────────────┤
│  C Runtime (IPC)          │  Shared memory, ring buffers   │
├─────────────────────────────────────────────────────────────┤
│  PostgreSQL               │  Fullt schema, migrations      │
└─────────────────────────────────────────────────────────────┘
```

## Moduler

| Modul | Status | Datakälla | Automationsmönster |
|-------|--------|-----------|-------------------|
| CRM | ✅ | BOC intern | Lead-scoring, påminnelser |
| Sales | ✅ | BOC + aamos-ledger | Pipeline-rapporter, forecast |
| Finance | ✅ | aamos-ledger, bank | Moms, fakturapåminnelser, avstämning |
| HR | ✅ | BOC intern | Lönekörning, ledighet, tidrapporter |
| Legal | ✅ | BOC intern | Kontraktsförnyelser, påminnelser |
| Marketing | ✅ | BOC intern | Content-publicering, kampanjer |
| Support | ✅ | BOC intern | Ärendeprioritering, CSAT |
| Analytics | ✅ | Alla moduler | Dashboard, rapporter, trender |
| Automation | ✅ | Alla moduler | Workflows, cron, event-triggers |

## Teknikstack

### Backend (Go)
- **Router:** chi/v5
- **Auth:** JWT
- **DB:** PostgreSQL med migrations
- **Cache:** Redis (go-redis)
- **Events:** Kafka (segmentio/kafka-go)
- **Log:** zerolog
- **WebSocket:** gorilla/websocket
- **Automation:** Intern motor med cron-support

### Cache (Redis)
- **Sessions:** Användarsessioner med TTL
- **Rate limiting:** Sliding window per endpoint
- **Analytics cache:** 5-minuters TTL på metrics
- **Dashboard cache:** 1-minuts TTL
- **Pub/Sub:** Realtidsnotifikationer

### Event Streaming (Kafka)
- **Topics:** boc.events, boc.audit, boc.analytics, boc.notifications
- **Producers:** Alla CRUD-operationer publicerar events
- **Consumers:** Audit log, analytics aggregation, notifications
- **Schema:** JSON events med tenant_id, entity_id, timestamp

### Analytics (Rust)
- **Framework:** axum + tokio
- **Parallel:** rayon för batch-processing
- **Cache:** dashmap i minnet
- **Rapporter:** financial_summary, sales_pipeline, customer_analytics, revenue_forecast, expense_breakdown, cashflow_projection

### IPC (C)
- **Shared memory:** POSIX shm
- **Ring buffers:** Lock-free för hög genomströmning
- **Cache:** Inline analytics-cache med TTL

## Bygga

```bash
# Allt
make build

# Separat
make build-go
make build-rust
make build-c
```

## Kör

### Docker (rekommenderat)
```bash
make docker-up    # Starta allt
make docker-down  # Stoppa
make docker-logs  # Loggar
```

### Utveckling
```bash
# Kräver PostgreSQL på localhost:5432
make dev
```

### Manuellt
```bash
# Go backend
cd backend
export PORT=9092
export DB_URL=postgres://boc:boc@localhost:5432/boc?sslmode=disable
export JWT_SECRET=***
./boc

# Rust service
cd rust-service
cargo run --release

# C runtime
cd c-runtime
make
```

## API Endpoints

### Auth
- `POST /api/v1/auth/login` — Inloggning
- `GET /api/v1/auth/me` — Aktuell användare

### CRM
- `GET /api/v1/crm/customers` — Lista kunder
- `POST /api/v1/crm/customers` — Skapa kund
- `GET /api/v1/crm/customers/{id}` — Hämta kund
- `PUT /api/v1/crm/customers/{id}` — Uppdatera kund
- `DELETE /api/v1/crm/customers/{id}` — Ta bort kund
- `GET /api/v1/crm/leads` — Lista leads
- `GET /api/v1/crm/pipeline` — Pipeline
- `POST /api/v1/crm/interactions` — Skapa interaktion

### Sales
- `GET /api/v1/sales/deals` — Lista deals
- `POST /api/v1/sales/deals` — Skapa deal
- `GET /api/v1/sales/deals/{id}` — Hämta deal
- `PUT /api/v1/sales/deals/{id}` — Uppdatera deal
- `GET /api/v1/sales/mrr` — MRR
- `GET /api/v1/sales/arr` — ARR
- `GET /api/v1/sales/products` — Lista produkter
- `POST /api/v1/sales/products` — Skapa produkt

### Finance
- `GET /api/v1/finance/balance` — Balansräkning (från aamos-ledger)
- `GET /api/v1/finance/income` — Resultaträkning (från aamos-ledger)
- `GET /api/v1/finance/moms` — Momsrapport (från aamos-ledger)
- `GET /api/v1/finance/accounts` — Konton (från aamos-ledger)
- `GET /api/v1/finance/invoices` — Fakturor
- `GET /api/v1/finance/cashflow` — Kassaflöde
- `GET /api/v1/finance/budget` — Budget
- `POST /api/v1/finance/expenses` — Skapa utgift
- `GET /api/v1/finance/expenses` — Lista utgifter

### HR
- `GET /api/v1/hr/employees` — Lista anställda
- `POST /api/v1/hr/employees` — Skapa anställd
- `GET /api/v1/hr/employees/{id}` — Hämta anställd
- `PUT /api/v1/hr/employees/{id}` — Uppdatera anställd
- `GET /api/v1/hr/leaves` — Lista ledigheter
- `POST /api/v1/hr/leaves` — Skapa ledighet
- `GET /api/v1/hr/timesheets` — Lista tidrapporter
- `POST /api/v1/hr/timesheets` — Skapa tidrapport

### Legal
- `GET /api/v1/legal/contracts` — Lista kontrakt
- `POST /api/v1/legal/contracts` — Skapa kontrakt
- `GET /api/v1/legal/contracts/{id}` — Hämta kontrakt
- `PUT /api/v1/legal/contracts/{id}` — Uppdatera kontrakt
- `GET /api/v1/legal/reminders` — Påminnelser

### Marketing
- `GET /api/v1/marketing/campaigns` — Lista kampanjer
- `POST /api/v1/marketing/campaigns` — Skapa kampanj
- `GET /api/v1/marketing/content` — Lista content
- `POST /api/v1/marketing/content` — Skapa content

### Support
- `GET /api/v1/support/tickets` — Lista ärenden
- `POST /api/v1/support/tickets` — Skapa ärende
- `GET /api/v1/support/tickets/{id}` — Hämta ärende
- `PUT /api/v1/support/tickets/{id}` — Uppdatera ärende
- `POST /api/v1/support/tickets/{id}/comments` — Lägg till kommentar
- `GET /api/v1/support/csat` — CSAT-score

### Analytics
- `GET /api/v1/analytics/users` — Aktiva användare
- `GET /api/v1/analytics/revenue` — Intäkt
- `GET /api/v1/analytics/retention` — Retention
- `GET /api/v1/analytics/dashboard` — Dashboard-data

### Automation
- `GET /api/v1/automation/workflows` — Lista workflows
- `POST /api/v1/automation/workflows` — Skapa workflow
- `POST /api/v1/automation/workflows/{id}/trigger` — Trigga workflow
- `GET /api/v1/automation/jobs` — Lista schemalagda jobb
- `POST /api/v1/automation/jobs` — Skapa schemalagt jobb
- `GET /api/v1/automation/runs` — Lista körningar

### WebSocket
- `GET /ws` — Realtidsuppdateringar

### Rust Service
- `GET /health` — Hälsokontroll
- `POST /api/v1/reports/generate` — Generera rapport
- `POST /api/v1/analytics/query` — Analytics-fråga
- `POST /api/v1/analytics/batch` — Batch-analytics

## Automation

### Schemalagda jobb (cron)
- **Rapportgenerering** — Dagligen/veckovis/månadsvis
- **Påminnelser** — Kontraktsförnyelser, fakturor
- **Synkronisering** — Externa system
- **Städning** — Gammal data
- **Backup** — Databasbackup

### Workflows
- **Event-triggers** — Vid skapande/uppdatering av entiteter
- **Schedule-triggers** — Cron-baserade
- **Webhook-triggers** — Externa händelser
- **Manuella triggers** — Via API/UI

### Åtgärdstyper
- `send_email` — Skicka e-post
- `send_notification` — Push-notis
- `create_task` — Skapa uppgift
- `update_record` — Uppdatera post
- `webhook` — Anropa extern URL
- `generate_report` — Generera och skicka rapport

## Databasschema

Fullt schema med:
- Multi-tenant (boc_tenants)
- Audit log (boc_audit_log) — immutable
- Alla moduler med proper indexes
- Triggers för updated_at
- JSONB för flexibla metadata
- Foreign keys med CASCADE

Se `backend/db/migrations/001_initial_schema.sql`

## Miljövariabler

| Variabel | Default | Beskrivning |
|----------|---------|-------------|
| PORT | 9092 | Go backend port |
| DB_URL | postgres://... | PostgreSQL connection string |
| JWT_SECRET | change-me... | JWT signing secret |
| AMOS_BASE_URL | http://localhost:9000 | aamos-ledger URL |
| MIGRATIONS_DIR | ./db/migrations | Migration files path |
| RUST_SERVICE_URL | http://localhost:9093 | Rust service URL |
| REDIS_URL | redis://localhost:6379 | Redis connection string |
| KAFKA_BROKERS | localhost:9092 | Comma-separated Kafka brokers |

## Säkerhet

- JWT-autentisering på alla endpoints utom /health och /login
- CORS-konfigurerbart
- SQL-injection skyddat via parameteriserade queries
- Audit log på alla förändringar
- HTTPS i produktion (via nginx)

## Roadmap

- [ ] Full integration med aamos-ledger
- [ ] Bank-API koppling (Nordea, Revolut)
- [ ] E-postutskick (SMTP)
- [ ] PDF-generering för fakturor
- [ ] Advanced analytics (Rust)
- [ ] Machine learning för lead-scoring
- [ ] Mobile app (React Native/Flutter)
- [ ] SSO-integration

## Licens

Proprietär — Landvex Inc