tilbudgivern/docs

Tilbudgivern Dokumentation

Velkommen til Tilbudgivern dokumentationen. Her finder du detaljerede guides til alle aspekter af systemet.

Oversigt

Tilbudgivern er en AI-drevet tilbudsberegner for tømrerfaget med:

• 40+ backend services
• 57+ frontend komponenter
• 15 Smart Pakker til tagarbejde
• 7 understøttede tagtyper
• Ordrestyring GraphQL integration

Dokumentationsstruktur

API Dokumentation (/api/)

Dokument	Beskrivelse
ORDRESTYRING_API_INVENTORY	Komplet Ordrestyring API reference
ORDRESTYRING_API_STATUS_OVERSIGT	Status på API integrationer
CUSTOMER_SEARCH_INTEGRATION	Kundesøgning integration
CASE_ANALYTICS_SYSTEM_DOCUMENTATION	Sags-analytics system
BYGMA_AUTOMATION_README	Bygma automatisering

Feature Dokumentation (/features/)

Dokument	Beskrivelse
SMART_PACKAGES_COMPLETE_CATALOG	Komplet Smart Pakke katalog
TOMRER_SMART_PACKAGES_GUIDE	Tømrer smart pakke guide
BYGMA_IMPORT_FEATURE	Bygma import funktionalitet
ORDRESTYRING_GRAPHQL_INTEGRATION	GraphQL integration
INTELLIGENT_TASKS_FEATURE	Intelligente opgaver
MARKUP_SLIDER_SYSTEM	Avance slider system
FEATURE_ROADMAP	Feature roadmap

Deployment (/deployment/)

Dokument	Beskrivelse
DEPLOYMENT	Deployment guide
PM2_GUIDE	PM2 process manager
DEPLOYMENT-PIPELINE	CI/CD pipeline
DNS_MIGRATION_GUIDE	DNS migration

Guides (/guides/)

Dokument	Beskrivelse
KOMPLET_ORDRESTYRING_SYSTEM_OVERSIGT	Komplet Ordrestyring oversigt
KOMPLET_TILBUDSBEREGNING_LØSNING	Tilbudsberegning løsning
AI_TILBUDS_PROMPT_GUIDE	AI prompt guide
TAG_OPGAVE_DATABASE	Tag opgave database
TOMMER_QUICK_REFERENCE	Tømrer quick reference

System Dokumentation (root)

Dokument	Beskrivelse
LOGGING_SYSTEM	Struktureret logging system
PORT_MANAGEMENT	Port håndtering
DATABASE_BACKUP_SETUP	Database backup
ROOF_TYPES_IMPLEMENTATION	7 tagtype implementationer
OPENAI_COSTS_API	OpenAI omkostnings-API

Test Dokumentation

Dokument	Beskrivelse
UI_TESTING_SETUP	UI test opsætning
SVG_TESTING_GUIDE	SVG test guide

Quick Links

Primære Systemer

• Unified Server: backend/unified-server.js (port 4032)
• Smart Pakker: 15 forudkonfigurerede tømrerpakker
• Ordrestyring: GraphQL integration til ordre/kundestyring
• OpenAI: GPT-4 tilbudsgenerering ($9/måned budget)

Teknologi Stack

Komponent	Teknologi
Frontend	React 18, Material-UI 5
Backend	Node.js/Express
Database	MariaDB/MySQL
Real-time	Socket.IO
PDF	Puppeteer
Test	Playwright, Jest, Selenium

Vigtige Kommandoer

# Development
npm run dev

# Production
pm2 restart tilbudgivern-unified
pm2 logs tilbudgivern-unified

# Test
npm run test:pw           # Playwright E2E
npm run test:pw:local     # Lokal test
cd backend && npm test    # Unit tests

Arkitektur Oversigt

┌─────────────────────────────────────────────────────────┐
│                    Frontend (React 18)                   │
│              Material-UI + Socket.IO Client              │
└─────────────────────────┬───────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────┐
│              Unified Server (Port 4032)                  │
│                  backend/unified-server.js               │
├─────────────────────────────────────────────────────────┤
│  Routes    │  Services (40+)  │  Middleware             │
│  ────────  │  ─────────────── │  ──────────             │
│  /api/*    │  openaiService   │  auth                   │
│            │  smartPackage... │  correlationId          │
│            │  ordrestyring... │  errorHandler           │
│            │  pdfGeneration   │  requestLogger          │
└─────────────────────────┬───────────────────────────────┘
                          │
          ┌───────────────┼───────────────┐
          ▼               ▼               ▼
┌─────────────┐  ┌─────────────┐  ┌─────────────┐
│  MariaDB    │  │  OpenAI     │  │ Ordrestyring│
│  Database   │  │  GPT-4 API  │  │ GraphQL API │
└─────────────┘  └─────────────┘  └─────────────┘

Database Tabeller

Kategori	Tabeller
Tilbud	project_quotes, quotes, quote_feedback
Projekter	customer_projects, projects
Materialer	materials, material_prices, project_materials
Arbejde	labor_tasks, labor_prices, project_labor
Pakker	material_packages, smart_package_tasks, smart_package_materials
Geometri	roof_geometry
System	system_logs, request_logs, system_settings

Kontakt

Ved spørgsmål, opret et issue i GitHub repository.