cf9b831e35
- CLAUDE.md: Claude Code instructions - .github/copilot-instructions.md: GitHub Copilot custom instructions - .cursorrules: Cursor IDE project rules - COPILOT_MEMORY.md: Active project context with documentation links - AGENTS.md: General repository guidelines and coding standards - GEMINI.md: Gemini AI detailed project overview All files include: project overview, tech stack, architecture patterns, Smart Packages system, roof types, Danish terminology, and common commands. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
108 lines
3.2 KiB
Plaintext
108 lines
3.2 KiB
Plaintext
# Tilbudgivern - Cursor Rules
|
|
|
|
## Project Context
|
|
|
|
This is **Tilbudgivern**, an AI-powered quote calculator for Danish carpenters (tømrere). The application generates professional quotes for roofing and construction work.
|
|
|
|
## Tech Stack
|
|
|
|
- Frontend: React 18 + Material-UI (served from `frontend/build/`)
|
|
- Backend: Node.js/Express unified server (`backend/unified-server.js`)
|
|
- Database: MariaDB on localhost:3306, database `tilbudgivern`
|
|
- AI: OpenAI GPT-4 API
|
|
- Process Manager: PM2 (`tilbudgivern-unified`)
|
|
- Tests: Playwright, Selenium, Jest
|
|
|
|
## Key Architecture
|
|
|
|
### Unified Server
|
|
Single server file `backend/unified-server.js` handles:
|
|
- Static frontend serving
|
|
- All API endpoints (port 4032)
|
|
- WebSocket connections (Socket.IO)
|
|
- Structured logging with correlation IDs
|
|
|
|
### Smart Packages
|
|
15 pre-configured roofing packages with:
|
|
- Auto-calculation from geometry (tagareal, rygningslængde)
|
|
- Materials with prices + labor hours
|
|
- Tables: `smart_packages`, `package_tasks`, `package_materials`
|
|
|
|
### 7 Roof Types
|
|
sadeltag, valmtag, koebenhavnertag, fladt_tag, pulttag, tag_med_kviste, mansard
|
|
|
|
## Code Patterns
|
|
|
|
### Backend Services
|
|
```javascript
|
|
// Use structured logging
|
|
const logger = require('./src/utils/logger');
|
|
logger.logInfo('Context', 'Message', { correlationId: req.correlationId, metadata: {} });
|
|
logger.logError('Context', error, { correlationId: req.correlationId });
|
|
|
|
// Use asyncHandler for routes
|
|
const { asyncHandler } = require('./src/middleware/errorHandler');
|
|
router.get('/endpoint', asyncHandler(async (req, res) => { ... }));
|
|
```
|
|
|
|
### API Response Format
|
|
```javascript
|
|
// Success
|
|
res.json({ success: true, data: result });
|
|
|
|
// Error
|
|
res.status(400).json({ success: false, error: { code: 'VAL_001', message: 'Danish error message' } });
|
|
```
|
|
|
|
### React Components
|
|
- Functional components with hooks
|
|
- Material-UI for UI consistency
|
|
- Follow patterns in `frontend/src/components/`
|
|
|
|
## Danish Language
|
|
|
|
UI and code comments are in Danish. Key terms:
|
|
- Tilbud = Quote, Tømrer = Carpenter, Tag = Roof
|
|
- Materiale = Material, Pakke = Package, Pris = Price
|
|
- Tagrende = Gutter, Nedløb = Downspout, Spær = Rafters
|
|
|
|
## Important Files
|
|
|
|
- `backend/unified-server.js` - Main server (~400K lines)
|
|
- `backend/src/services/openaiService.js` - AI quote generation
|
|
- `backend/src/services/smartPackageManagementService.js` - Package CRUD
|
|
- `backend/src/routes/smartPackagesRoutes.js` - Package API
|
|
- `frontend/src/components/InlineSmartPackage.js` - Package wizard
|
|
- `frontend/src/components/EnhancedGeometry.js` - Roof geometry with SVG
|
|
|
|
## External APIs
|
|
|
|
### Ordrestyring (GraphQL)
|
|
- Endpoint: `https://beta7-api.ordrestyring.dk/graphql`
|
|
- Token: `ORDRESTYRING_API_TOKEN`
|
|
- Used for: customers, cases, offers, calendar
|
|
|
|
### Material Imports
|
|
- Bygma: Price book import
|
|
- Stark: CSV import via `/api/stark/upload`
|
|
|
|
## Commands
|
|
|
|
```bash
|
|
npm run dev # Dev server with hot reload
|
|
npm run build # Build frontend
|
|
pm2 restart tilbudgivern-unified # Restart
|
|
npm run test:pw # Playwright tests
|
|
cd backend && npm test # Jest tests
|
|
```
|
|
|
|
## Environment
|
|
|
|
Required in `backend/.env`:
|
|
- OPENAI_API_KEY
|
|
- DB_HOST, DB_USER, DB_PASSWORD, DB_NAME
|
|
|
|
Optional:
|
|
- ORDRESTYRING_API_TOKEN
|
|
- OPENAI_ADMIN_KEY
|