tilbudgivern/docs/api/ORDRESTYRING_REPORTS_INTEGRATION.md

# Integration med Ordrestyring Rapporter

## 📊 Oversigt

Ordrestyring har allerede omfattende native rapporter med detaljerede KPI'er, grafer og statistikker. Disse kan integreres direkte i Tilbudgivern systemet.

## 🔗 API Endpoint

### Get Ordrestyring Report URL
```bash
GET /api/analytics/ordrestyring-report
```

**Response:**
```json
{
  "success": true,
  "reportUrl": "https://login.intuitu.dk/redirect?token=...&id=...",
  "message": "Åbn denne URL for at se Ordrestyring's native rapporter"
}
```

## 📈 Tilgængelige Rapporter i Ordrestyring

Baseret på screenshots viser Ordrestyring følgende KPI'er:

### Økonomi KPI'er:
- **Faktureret salg for måneden** (262.294 DKK)
- **Faktureret salg år-til-dato** (11.371.184 DKK)
- **Tilgodehavende fakturaer** (3.589.872 DKK)
- **Akkumuleret faktureret salg** (graf over tid)

### Ordrer:
- **Ordrer for måneden** (15)
- **Ordrer år-til-dato** (142)
- **Oprettede tilbud** (26 for måneden, 189 år-til-dato)

### Timer:
- **Fakturerbare timer for måneden** (1.610,8 timer)
- **Faktureringsgrad for måneden** (71%)
- **Faktureringsgrad år-til-dato** (64%)

### Grafer:
- Faktureret salg fordelt på kunder
- Faktureret salg per kunde (pie chart)
- Faktureret salg over 3 måneder (trend line)

## 🎯 Integration i Frontend

### Eksempel 1: Redirect Button
```javascript
const openOrdrestyringReport = async () => {
  try {
    const response = await fetch('http://localhost:4032/api/analytics/ordrestyring-report');
    const data = await response.json();
    
    if (data.success) {
      window.open(data.reportUrl, '_blank');
    }
  } catch (error) {
    console.error('Fejl ved hentning af rapport:', error);
  }
};

// I din component:
<button onClick={openOrdrestyringReport}>
  📊 Åbn Ordrestyring Rapporter
</button>
```

### Eksempel 2: Embedded iFrame (hvis tilladt)
```javascript
const [reportUrl, setReportUrl] = useState(null);

useEffect(() => {
  fetch('http://localhost:4032/api/analytics/ordrestyring-report')
    .then(res => res.json())
    .then(data => {
      if (data.success) {
        setReportUrl(data.reportUrl);
      }
    });
}, []);

return (
  <div style={{ width: '100%', height: '800px' }}>
    {reportUrl && (
      <iframe 
        src={reportUrl} 
        style={{ width: '100%', height: '100%', border: 'none' }}
        title="Ordrestyring Rapporter"
      />
    )}
  </div>
);
```

## 🔐 Sikkerhed

- Report URL indeholder en token og session ID
- Token udløber efter en vis tid
- Kræver Ordrestyring login for at se rapporterne
- URL genereres dynamisk for hver request

## 💡 Fordele ved Native Rapporter

1. **✅ Altid opdateret:** Rapporterne trækker direkte fra Ordrestyring's database
2. **✅ Komplette grafer:** Intuitu har bygget professionelle visualiseringer
3. **✅ Ingen duplikering:** Vi skal ikke vedligeholde separate rapporter
4. **✅ Mere detaljeret:** Ordrestyring har adgang til alle felter i deres system
5. **✅ Historiske data:** Fuld adgang til alle tidligere perioder

## 📋 Vores KPI Endpoint (Supplerende)

Vi vedligeholder stadig vores eget `/api/analytics/kpis` endpoint for:
- Quick overview i vores UI
- Custom beregninger (profit margins med targets)
- Integration med vores lokale data (installation manuals, materials, etc.)

**Response format:**
```json
{
  "success": true,
  "data": {
    "totalProjects": 200,
    "totalRevenue": 1541443111,
    "avgProfitMargin": 47,
    "hoursMargin": 67.9,
    "materialsMargin": 18,
    "targets": {
      "hoursMargin": 2,
      "materialsMargin": 20,
      "note": "Ledelsens forventede profit margins"
    },
    "ordrestyringReportUrl": "/api/analytics/ordrestyring-report"
  }
}
```

## 🎨 UI Anbefaling

**Dashboard Layout:**
```
┌─────────────────────────────────────────────────────┐
│  Tilbudgivern - Analytics Dashboard                 │
├─────────────────────────────────────────────────────┤
│                                                      │
│  Quick KPI Cards (vores egen data)                  │
│  ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐          │
│  │ 200   │ │ 1.5B  │ │ 132   │ │  19   │          │
│  │Projects│ │Revenue│ │Customers│ │Employees│      │
│  └───────┘ └───────┘ └───────┘ └───────┘          │
│                                                      │
│  Profit Margins vs Targets                          │
│  ┌─────────────────────────────────────┐           │
│  │ Timer: 67.9% (target: 2%)     🔴    │           │
│  │ Materialer: 18% (target: 20%) 🟡    │           │
│  └─────────────────────────────────────┘           │
│                                                      │
│  [📊 Åbn Detaljerede Ordrestyring Rapporter]       │
│                                                      │
└─────────────────────────────────────────────────────┘
```

## 📞 Support

For spørgsmål til Ordrestyring's rapporter:
- Kontakt Intuitu support
- API dokumentation: https://graphql.ordrestyring.dk/docs

For spørgsmål til vores integration:
- Se `/api/analytics/kpis` endpoint
- Tjek `PROFIT_MARGIN_ANALYSIS.md` for detaljeret økonomisk analyse