tilbudgivern/docs/STARK_IMPORT_DEPLOYMENT.md

🚀 Stark Import Deployment Checklist

Date: 2025-11-26
Status: Ready for Deployment
Implementation: Complete ✅

---

Pre-Deployment Verification ✅

• Backend service created: starkImportService.js (16 KB)
• API routes created: starkImport.js (3.9 KB)
• Frontend handlers added: 4 mentions in MaterialsList.js
• Server route registration: Added to unified-server.js line ~1117
• Database schema: Added to customer_project_system.sql
• Documentation: STARK_IMPORT_IMPLEMENTATION.md created (13 KB)

---

Deployment Steps

Step 1: Database Migration (Required)

Execute the SQL migration to create the stark_materials_cache table:

# Option A: Direct SQL execution
mysql -u tilbuduser -p tilbudgivern << 'EOF'
CREATE TABLE IF NOT EXISTS stark_materials_cache (
  id INT AUTO_INCREMENT PRIMARY KEY,
  product_id VARCHAR(100) UNIQUE,
  product_name VARCHAR(255),
  category VARCHAR(100),
  subcategory VARCHAR(100),
  unit VARCHAR(50),
  price DECIMAL(10,2),
  stock_status VARCHAR(50),
  supplier_info JSON,
  last_updated TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  INDEX idx_category (category),
  INDEX idx_name (product_name),
  INDEX idx_updated (last_updated)
);
EOF

Verification:

# Check table created
mysql -u tilbuduser -p tilbudgivern -e "DESCRIBE stark_materials_cache;"

# Check indexes
mysql -u tilbuduser -p tilbudgivern -e "SHOW INDEX FROM stark_materials_cache;"

Step 2: Backend Server Restart

Restart the Node.js backend server to load new routes:

# Restart the service
sudo systemctl restart tilbudgivern-backend

# Or if using PM2:
pm2 restart unified-server

# Verify routes loaded (check logs for):
# ✅ Stark import routes loaded successfully

Step 3: Frontend Verification

No frontend build required - React component already updated via MaterialsList.js

Check:

• Navigate to Materials page
• Verify "📦 Importer Stark Katalog" button appears in action controls
• Button should be next to existing "📦 Importer Bygma Prisbog" button

---

Testing Protocol

Test 1: API Health Check

# Should return 200 OK
curl -X GET http://localhost:3000/api/stark/status

# Expected response:
# {
#   "success": true,
#   "status": {
#     "total_products": 0,
#     "categories": [],
#     "prices": { "min": null, "max": null, "avg": null }
#   }
# }

Test 2: Upload Sample CSV

Create test_stark_katalog.csv:

ProduktNr;Produktnavn;Kategori;Enhed;Pris
1;Test Produkt 1;Kategori A;m2;100.00
2;Test Produkt 2;Kategori B;stk;50.00
3;Test Produkt 3;Kategori A;meter;25.50

Upload via API:

curl -X POST http://localhost:3000/api/stark/upload \
  -F "csvFile=@test_stark_katalog.csv" \
  -F "uploadedBy=test_user"

# Expected response:
# {
#   "success": true,
#   "message": "Stark prisbog importeret succesfuldt! 3 nye produkter, 0 priser opdateret.",
#   "stats": {
#     "totalRows": 3,
#     "successfulRows": 3,
#     "newProducts": 3,
#     "updatedProducts": 0
#   }
# }

Test 3: Verify Database

# Check products imported
mysql -u tilbuduser -p tilbudgivern << 'EOF'
SELECT COUNT(*) as total_products FROM stark_materials_cache;
SELECT * FROM stark_materials_cache LIMIT 3;
EOF

Test 4: Check Import History

curl -X GET "http://localhost:3000/api/stark/import-history?limit=5"

# Should return list of recent imports

Test 5: Frontend Upload Test

1. Open browser → Materials page
2. Click "📦 Importer Stark Katalog"
3. Modal should appear
4. Select test_stark_katalog.csv
5. Click "Importer"
6. Should show uploading spinner
7. Should show success message with stats
8. Should auto-reload materials list
9. Modal should close after 3 seconds

---

Rollback Plan (If Issues)

If deployment has issues:

1. Revert Route Registration:

   • Remove lines 1113-1118 from unified-server.js
   • Restart backend server

2. Remove Database Table (if needed):

   DROP TABLE stark_materials_cache;
   

3. Verify Bygma Still Works:

   • Test Bygma import still functions
   • Check Materials page loads

---

Post-Deployment Monitoring

Critical Checks:

• Backend logs show "✅ Stark import routes loaded successfully"
• No 404 errors for /api/stark/* endpoints
• Frontend button visible and clickable
• Database table populated after first import

Performance Baseline:

• Import 1,000 rows: < 10 seconds
• CSV file upload: < 30 seconds
• Modal response time: < 1 second

Data Quality:

• No duplicate product_ids
• Prices correctly formatted
• Categories properly extracted
• Unit fields populated

---

Support Contacts

Issues?

1. Check log files: /var/log/tilbudgivern/backend.log
2. Review error: Check import_logs table
3. See documentation: STARK_IMPORT_IMPLEMENTATION.md

---

Success Criteria ✅

Deployment is SUCCESSFUL when:

1. ✅ Database table created without errors
2. ✅ Backend routes loaded (check console)
3. ✅ Frontend button visible
4. ✅ Sample CSV uploads successfully
5. ✅ Products appear in stark_materials_cache
6. ✅ Materials list auto-refreshes
7. ✅ No console errors in browser/server

---

Timeline

Step	Duration	Status
Database Migration	2 minutes	Ready
Backend Restart	1 minute	Ready
Frontend Check	2 minutes	Ready
Testing	10 minutes	Ready
Total	~15 minutes	✅

---

Files Modified/Created

Modified Files:

• /backend/unified-server.js - Added route registration (1 file, 2 lines)
• /frontend/src/MaterialsList.js - Added UI & handlers (1 file, ~70 lines)
• /backend/sql/customer_project_system.sql - Added schema (1 file, 1 table)

New Files Created:

• /backend/src/services/starkImportService.js (600+ lines)
• /backend/src/routes/starkImport.js (150 lines)
• /STARK_IMPORT_IMPLEMENTATION.md (documentation)
• /STARK_IMPORT_DEPLOYMENT.md (this file)

Total Changes: 3 files modified, 2 services created, 2 documentation files

---

Notes

• ⚠️ Database Migration Required: Must execute SQL before first use
• ✅ Zero Breaking Changes: Existing Bygma import unaffected
• ✅ Production Ready: All error handling implemented
• ✅ Fully Documented: Complete API & implementation docs included
• ✅ Tested Pattern: Matches proven Bygma import architecture

---

Ready to deploy! Execute database migration and restart backend to activate Stark import functionality.