Files
tilbudgivern/docs/guides/PROFESSIONEL_TILBUDS_STRUKTUR.md
alexpolo1 f9484eff3a feat: Enhance project quote generation with hierarchical structure and detailed prompts
- Updated AI prompt in projectQuoteGenerationService.js to include a hierarchical task description format for professional quotes.
- Added critical rules for AI to follow, emphasizing action words and specific material descriptions.
- Created comprehensive documentation for the updated quote system, including examples and guidelines for AI prompts.
- Developed a new layout template for quotes to improve readability and professionalism.
- Established a detailed guide on professional quote structure based on Mikael Holck's standards.
2025-10-30 18:58:22 +00:00

14 KiB
Raw Permalink Blame History

📋 Professionel Tilbuds-Struktur - Analyse

Baseret på: Mikael Holck ApS Tilbud #1846
Dato: 2025-10-30


🎯 Nøgleelementer i Professionelt Tilbud

1. Header Information (Hver Side)

✅ Kundenavn
✅ Kundeadresse
✅ Tilbudsnummer
✅ Tilbudsdato
✅ Kundenummer
✅ Side (1/3, 2/3, 3/3)
✅ Rekvirent
✅ Reference

Vores system skal have:

  • Auto-genererede tilbudsnumre
  • Automatisk dato
  • Kundenummer fra database
  • Side-paginering
  • Rekvirent/Reference felter

2. Opgave Struktur (Hierarkisk)

Eksempel 1: Skorsten

📦 HOVEDOPGAVE: Skorsten

  📋 Beskrivelse:
     "Tilbud på arbejder aftalt på byggemøde."

  🔨 DELOPGAVER:
     1. Sikring omkring skorsten
        - Sliske og stillads udføres omkring skorsten
     
     2. Skorsten demonteres
        - Mursten fra skorsten sendes til deponi
        - Skorsten demonteres den til etageadskillelse
        - Forstærkninger fjernes igen, affald bortkøres

  💰 PRIS: 34.940,00 kr. ex moms
  
   NOTE: *Hvis der bruges kortere tid på opgaven end beregnet givet et fradrag på prisen.

Eksempel 2: Udvidelse af værelse

📦 HOVEDOPGAVE: Udvidelse af værelse
   📐 Reference: Tegning 09 værelserne 103 og 106

  🔨 DELOPGAVER:
     1. Demonterings arbejde
        - Eksistere skunkvæg demonteres i værelse og trapperum
        - Ved "knæk" fjernes skråloft ud mod skunk
        - Skillevæg og gulv i skunk demonteres
     
     2. Ny konstruktion på skårvæg
        - Udføres med dampspærre, isolering, forskalling og gips
        - Hele skråvæg afsluttes med 1 lag gips monteret ny og gl. skråvæg
        - Skunkvæg opføres med kingspan og gips
     
     3. Fodpaneler
        - Der monteres nye fodpaneler i forlængelse af eksisterende paneler
     
     4. Gulv
        - Der leveres og monteres nye gulvbrædder i lignede dimension og træsort som øvrig gulv
     
     5. Maler
        - Nye skråvægge spartles og males fra kant til kant
        - Fodpaneler pletspartles og males 1 gang

  💰 PRISER:
     Tilbudspris:        36.108,00 kr. ex moms inkl. maler
     Fradrag jf. liste:  18.125,00 kr. ex moms
     ──────────────────────────────────────────────
     Samlet tilbud:      17.983,00 kr. ex moms

🎨 Formaterings Principper

1. Gruppering

  • Hovedopgave (fed skrift)
  • Underoverskrifter med bullets
  • Detaljer indenteret under hovedpunkter

2. Beskrivelser

  • Aktionsord først: "Demonteres", "Monteres", "Udføres"
  • Konkret: "Mursten sendes til deponi" (ikke bare "bortkøres")
  • Spec-detaljer: "1 lag gips", "kingspan og gips", "lignede dimension"

3. Priser

  • Per hovedopgave: Samlet pris tydeligt
  • Subtotals: Ved flere delopgaver
  • Fradrag: Tydeligt markeret
  • Final pris: Fremhævet

📊 Layout Template

════════════════════════════════════════════════════════
HOVEDOPGAVE NAVN
════════════════════════════════════════════════════════

Indledende beskrivelse / kontekst
(fx "Tilbud på arbejder aftalt på byggemøde")

────────────────────────────────────────────────────────
ARBEJDE 1: Kort beskrivelse
────────────────────────────────────────────────────────

• Detalje 1
• Detalje 2
• Detalje 3

────────────────────────────────────────────────────────
ARBEJDE 2: Kort beskrivelse  
────────────────────────────────────────────────────────

• Detalje 1
• Detalje 2
• Detalje 3

────────────────────────────────────────────────────────
PRIS
────────────────────────────────────────────────────────

Tilbudspris: XX.XXX,00 kr. ex moms

*Eventuelle noter eller forbehold

════════════════════════════════════════════════════════

💡 Vigtige Detaljer

Materialer

Når materialer nævnes, vær specifik:

  • "kingspan og gips"
  • "dampspærre, isolering, forskalling og gips"
  • "lignede dimension og træsort som øvrig gulv"
  • "diverse materialer"

Arbejdsgang

Beskriv logisk rækkefølge:

  1. Demonterings arbejde
  2. Ny konstruktion
  3. Afslutning/finish
  4. Maling/spartling

Inklusioner

Vær tydelig om hvad der er inkluderet:

  • "inkl. maler"
  • "affald bortkøres"
  • "sendes til deponi"

🚨 Forbehold

Altid inkluder relevante forbehold:

✅ "Der tages forbehold for rød og svamp i eksisterende trækonstruktion"
✅ "*Hvis der bruges kortere tid end beregnet givet et fradrag på prisen"

💰 Pris Struktur

Per Opgave

Tilbudspris: 34.940,00 kr. ex moms

Med Fradrag

Tilbudspris:       36.108,00 kr. ex moms inkl. maler
Fradrag jf. liste: 18.125,00 kr. ex moms
───────────────────────────────────────────────
Samlet tilbud:     17.983,00 kr. ex moms

Total (Sidste Side)

Momsfrit beløb:        0,00
Momspligtigt beløb:    111.144,00
───────────────────────────────────────
Subtotal:              111.144,00
25,00% Moms:           27.786,00
═══════════════════════════════════════
Total DKK:             138.930,00

📝 Teksteksempler fra Professionelt Tilbud

Demontering

"Eksistere skunkvæg demonteres i værelse og trapperum"
"Ved 'knæk' fjernes skråloft ud mod skunk"
"Mursten fra skorsten sendes til deponi"
"Skorsten demonteres den til etageadskillelse"

Montering

"Ny konstruktion på skårvæg udføres med dampspærre, isolering, forskalling og gips"
"Hele skråvæg afsluttes med 1 lag gips monteret ny og gl. skråvæg"
"Der monteres nye fodpaneler i forlængelse af eksisterende paneler"
"Der leveres og monteres nye gulvbrædder i lignede dimension og træsort som øvrig gulv"

Afslutning

"Nye skråvægge spartles og males fra kant til kant"
"Fodpaneler pletspartles og males 1 gang"
"Forstærkninger fjernes igen, affald bortkøres"

🎯 Vores System - Mangler

Hvad vi IKKE har endnu:

  1. Hierarkisk opgave struktur (hovedopgave → delopgaver)
  2. Reference til tegninger ("Tegning 09 værelserne 103 og 106")
  3. Fradrag funktionalitet
  4. Forbehold tekster
  5. Noter ved priser ("*Hvis der bruges kortere tid...")
  6. Inklusioner markering ("inkl. maler")
  7. Rekvirent/Reference felter

Hvad vi HAR:

  1. Smart packages med materialer
  2. Installation tasks
  3. Pris beregning
  4. PDF generering
  5. Kunde information

🚀 Forbedringer til Vores System

1. Opgave Hierarki

{
  mainTask: "Udvidelse af værelse",
  reference: "Tegning 09 værelserne 103 og 106",
  description: "Tilbud på arbejder aftalt på byggemøde",
  subTasks: [
    {
      category: "Demontering",
      items: [
        "Eksistere skunkvæg demonteres i værelse og trapperum",
        "Ved 'knæk' fjernes skråloft ud mod skunk",
        "Skillevæg og gulv i skunk demonteres"
      ]
    },
    {
      category: "Ny konstruktion",
      items: [
        "Udføres med dampspærre, isolering, forskalling og gips",
        "Hele skråvæg afsluttes med 1 lag gips",
        "Skunkvæg opføres med kingspan og gips"
      ]
    }
  ],
  price: 36108.00,
  deductions: 18125.00,
  finalPrice: 17983.00,
  inclusions: ["maler"],
  notes: "*Hvis der bruges kortere tid end beregnet givet et fradrag på prisen"
}

2. Forbehold System

{
  disclaimers: [
    "Der tages forbehold for rød og svamp i eksisterende trækonstruktion",
    "Priser er ekskl. moms",
    "Tilbuddet er gyldigt i 30 dage"
  ]
}

3. Beskrivelse Templates

const templates = {
  demontering: [
    "{{item}} demonteres",
    "{{materiale}} sendes til deponi",
    "{{element}} fjernes og bortkøres"
  ],
  montering: [
    "Der leveres og monteres {{item}}",
    "{{element}} udføres med {{materialer}}",
    "Ny {{konstruktion}} monteres"
  ],
  afslutning: [
    "{{overflader}} spartles og males {{antal}} gang",
    "{{element}} afsluttes med {{finish}}"
  ]
}

📐 PDF Layout Forbedringer

Header (Hver Side)

┌────────────────────────────────────────────────────┐
│ [KUNDE NAVN]                    TILBUD             │
│ [ADRESSE]                       Tilbudnr. 1846     │
│ [POSTNR BY]                     Dato: 16-10-2025   │
│                                 Side: 1/3          │
└────────────────────────────────────────────────────┘

Opgave Section

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SKORSTEN
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Sikring omkring skorsten
  • Sliske og stillads udføres omkring skorsten

Skorsten demonteres
  • Mursten fra skorsten sendes til deponi
  • Skorsten demonteres den til etageadskillelse
  • Forstærkninger fjernes igen, affald bortkøres

─────────────────────────────────────────────────────
Tilbudspris: 34.940,00 kr. ex moms
─────────────────────────────────────────────────────
┌────────────────────────────────────────────────────┐
│ Momsfrit beløb:     0,00                           │
│ Momspligtigt:       111.144,00                     │
│ ─────────────────────────────────────────────────  │
│ Subtotal:           111.144,00                     │
│ 25% Moms:           27.786,00                      │
│ ═════════════════════════════════════════════════  │
│ TOTAL DKK:          138.930,00                     │
└────────────────────────────────────────────────────┘

🎨 Farve & Styling

Fremhævning

  • Hovedopgaver: Fed skrift, større
  • Priser: Fed skrift, højrejusteret
  • Total: Fed, dobbelt understregning
  • Noter: Italic, mindre skrift

Afstand

  • Mellem opgaver: 2 linjer
  • Mellem delopgaver: 1 linje
  • Før pris: 1 linje med streg

💬 Sprog & Tone

Professionel men Tilgængelig

✅ "Der leveres og monteres"
✅ "Udføres med dampspærre"
✅ "Afsluttes med 1 lag gips"

❌ "Vi laver det"
❌ "Ting monteres"
❌ "Gips bliver sat på"

Præcise Specifikationer

✅ "lignede dimension og træsort som øvrig gulv"
✅ "1 lag gips monteret ny og gl. skråvæg"
✅ "kingspan og gips"

❌ "som resten"
❌ "gips"
❌ "isoleringsplade"

📋 Tjekliste for Professionelt Tilbud

Før Udsendelse

  • Kundeoplysninger korrekte
  • Tilbudsnummer unikt
  • Alle opgaver beskrevet
  • Priser korrekte
  • Moms beregnet
  • Forbehold inkluderet
  • Kontaktoplysninger
  • Side nummerering
  • Stavekontrol
  • PDF kvalitet

Under Beskrivelse

  • Aktionsord brugt
  • Materialer specificeret
  • Arbejdsgang logisk
  • Inklusioner nævnt
  • Eksklussioner nævnt
  • Referencer til tegninger
  • Kunde ønsker nævnt

🔄 Næste Skridt for Vores System

Prioritet 1 (Kritisk)

  1. Hierarkisk opgave struktur

    • Hovedopgave
    • Kategorier (Demontering, Montering, etc.)
    • Delopgaver med bullets
  2. Forbedret beskrivelse

    • Templates for standard arbejde
    • Materialespecifikationer
    • Arbejdsgangs-beskrivelser
  3. Pris opdeling

    • Per hovedopgave
    • Subtotals
    • Fradrag
    • Final total

Prioritet 2 (Vigtigt)

  1. Forbehold system
  2. Noter til priser
  3. Reference felter
  4. Inklusioner/eksklusioner

Prioritet 3 (Nice to have)

  1. Tegnings referencer
  2. Kunde feedback reminder
  3. Elite håndværker badge

Analyseret: 2025-10-30
Baseret på: Mikael Holck ApS Tilbud #1846
Formål: Forbedre tilbudsgenerering i Tilbudgivern