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

GET /api/analytics/ordrestyring-report

Response:

{
  "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

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)

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:

{
  "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