alexpolo1
bbb75ccce2
This commit introduces a new Advanced Dashboard feature, which provides enhanced analytics and system health monitoring. Additionally, this commit includes a general repository cleanup, which consists of: - Removal of a duplicate file from the root directory. - Addition of temporary report and documentation files to . - Relocation of several test files from the root to the directory. - Staging of various other modified files that were previously uncommitted. The new Advanced Dashboard feature includes: - and for the UI. - for the backend API. - for API documentation. New tests for smart packages and autosave functionality have also been added.
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 |
| 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.