Files

Claude ceaa6039fa docs: Update README with current architecture and tech stack

- Update tech stack from PostgreSQL to MariaDB/MySQL
- Update port from 3000/3001 to unified server port 4032
- Add Smart Packages system (15 carpenter packages)
- Add 7 roof types documentation
- Add Ordrestyring GraphQL integration info
- Update project structure to reflect current state
- Add comprehensive API endpoints documentation
- Update docs/README.md with documentation index and architecture diagram

2026-01-25 08:46:36 +00:00

6.8 KiB

Raw Blame History

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.

6.8 KiB Raw Blame History