cyclecad 0.2.2 → 0.2.3

package/DFM-ANALYZER-INTEGRATION.md

@@ -0,0 +1,368 @@
+# DFM Analyzer Integration Guide
+
+## Overview
+The **DFM Analyzer** (`app/js/dfm-analyzer.js`) is a complete design for manufacturability (DFM) module for cycleCAD.
+
+**File:** `/app/js/dfm-analyzer.js`
+**Lines:** 1,760
+**Status:** Production-ready
+
+## Features
+
+### 1. Manufacturing Processes Supported
+- **FDM** - Fused Deposition Modeling (3D printing)
+- **SLA** - Stereolithography (resin printing)
+- **SLS** - Selective Laser Sintering (powder printing)
+- **CNC Milling** - Subtractive 3-axis/5-axis milling
+- **CNC Lathe** - Rotational machining
+- **Laser Cutting** - 2D profile cutting
+- **Injection Molding** - High-volume plastic parts
+- **Sheet Metal** - Bending, stamping, forming
+
+### 2. Material Database (30+ Materials)
+**Metals:**
+- Steel (1018, 4140, 316 Stainless)
+- Aluminum (6061, 7075)
+- Brass, Copper, Titanium
+
+**Thermoplastics:**
+- ABS, PLA, PETG, Nylon, Polycarbonate, Acetal (Delrin), PEEK, UHMWPE
+
+**Composites:**
+- Carbon Fiber, Fiberglass
+
+Each material includes:
+- Density, tensile/yield strength, elongation, hardness
+- Thermal conductivity, melting point
+- Cost per kg, machinability rating (1-10)
+- Corrosion resistance, food safety flags
+
+### 3. DFM Analysis Engine
+
+```javascript
+// Analyze single process
+const result = window.cycleCAD.dfm.analyze(mesh, 'cnc_mill');
+// Returns: { score: 0-100, grade: 'A'-'F', issues: [], warnings: [], suggestions: [] }
+
+// Analyze all processes and compare
+const comparison = window.cycleCAD.dfm.analyzeAll(mesh);
+// Returns: { processes: {...}, bestProcess, bestGrade, summary }
+```
+
+**Analysis Includes:**
+- Design rule checks (min wall thickness, overhangs, undercuts, etc.)
+- Severity scoring (fail/warn/ok)
+- Detailed issue descriptions
+- Actionable improvement suggestions
+- Pass/fail grade (A-F)
+
+**Example Checks:**
+- FDM: wall thickness, overhangs, bridges, small holes, thin features
+- CNC: internal corners, deep pockets, thin walls, undercuts
+- Injection Molding: draft angles, wall uniformity, undercuts, rib proportions
+- Sheet Metal: bend radius, bend relief, flange length
+
+### 4. Cost Estimation
+
+```javascript
+const cost = window.cycleCAD.dfm.estimateCost(mesh, 'cnc_mill', 10, 'steel-1018');
+// Returns detailed breakdown:
+// {
+//   materialCost: { perUnit, total, volume, waste% },
+//   machineCost: { hourlyRate, hours, total },
+//   setupCost: { fixturing, programming, amortized },
+//   toolingCost: { molds, jigs, total },
+//   finishingCost: { deburring, painting, anodizing },
+//   totalPerUnit, totalBatch, breakEvenQuantity
+// }
+```
+
+**Cost Components:**
+- Material cost (with waste factor per process)
+- Machine time cost (hourly rates for each process)
+- Setup cost (amortized over quantity)
+- Tooling cost (injection mold, sheet metal dies)
+- Finishing cost (deburring, painting, anodizing)
+- Break-even quantity calculation (when molding becomes cheaper than CNC)
+
+```javascript
+// Compare costs across quantities
+const comparison = window.cycleCAD.dfm.compareCosts(mesh, 'cnc_mill', [1, 10, 100, 1000]);
+// Shows cost crossovers where cheaper processes kick in
+```
+
+### 5. Material Recommendations
+
+```javascript
+const recommendations = window.cycleCAD.dfm.recommendMaterial({
+  strength: 'high',      // 'low'|'medium'|'high'
+  weight: 'light',       // 'light'|'medium'|'heavy'
+  temperature: 200,      // °C requirement
+  cost: 'low',           // 'low'|'medium'|'high'
+  corrosion: true,
+  foodSafe: true
+});
+// Returns: [{ materialKey, name, score, properties }, ...]
+// Top 5 materials ranked by score
+```
+
+### 6. Weight & Strength Analysis
+
+```javascript
+// Estimate weight
+const weight = window.cycleCAD.dfm.estimateWeight(mesh, 'steel-1018');
+// Returns: { material, volumeCm3, densityGperCm3, weightKg, weightLb }
+
+// Tolerance analysis
+const tolerances = window.cycleCAD.dfm.analyzeTolerance(mesh, [
+  { feature: 'bore', tolerance: 0.05 },
+  { feature: 'surface finish', tolerance: 1.6 }
+]);
+// Shows which processes can achieve each tolerance
+// Grades: IT5-IT14 per ISO 286
+```
+
+### 7. Report Generation
+
+```javascript
+const report = window.cycleCAD.dfm.generateReport(mesh, {
+  title: 'Part XYZ DFM Report',
+  process: 'cnc_mill',
+  material: 'aluminum-6061',
+  quantity: 100
+});
+// Returns: { html, title, timestamp }
+// HTML includes:
+// - Grade card (A-F with score)
+// - Issues/warnings/suggestions
+// - Process comparison grid
+// - Detailed cost breakdown table
+// - Material properties
+// - Print-friendly styling
+```
+
+### 8. UI Panel
+
+```javascript
+// Create and display analysis panel
+window.cycleCAD.dfm.createPanel();
+```
+
+**Panel Features:**
+- Process selector dropdown
+- Material selector dropdown
+- Quantity input
+- Analyze button
+- Results display (grade, score, issues, cost)
+- Export Report button (downloads HTML)
+- Auto-hides cost details until analysis runs
+
+### 9. Event System
+
+```javascript
+// Listen for analysis completion
+window.cycleCAD.dfm.on('dfm-analysis-complete', (result) => {
+  console.log('Analysis finished:', result.grade, result.score);
+});
+
+// Listen for report generation
+window.cycleCAD.dfm.on('dfm-report-generated', (data) => {
+  console.log('Report ready:', data.title);
+});
+
+// Remove listener
+window.cycleCAD.dfm.off('dfm-analysis-complete', callback);
+```
+
+## Integration Steps
+
+### 1. Add Script to `app/index.html`
+
+```html
+<!-- In the <head> or before other scripts -->
+<script src="js/dfm-analyzer.js"></script>
+```
+
+### 2. Wire into Agent API (Optional)
+
+In `app/js/agent-api.js`, add validate.* namespace commands:
+
+```javascript
+'validate.dfm': ({ target, process = 'fdm' }) => {
+  const mesh = getFeatureMesh(target);
+  const result = window.cycleCAD.dfm.analyze(mesh, process);
+  return {
+    process: result.process,
+    grade: result.grade,
+    score: result.score,
+    issues: result.issues.length,
+    warnings: result.warnings.length,
+    passed: result.passed
+  };
+},
+
+'validate.costEstimate': ({ target, process = 'fdm', quantity = 1, material = 'steel-1018' }) => {
+  const mesh = getFeatureMesh(target);
+  const cost = window.cycleCAD.dfm.estimateCost(mesh, process, quantity, material);
+  return {
+    totalPerUnit: cost.totalPerUnit,
+    totalBatch: cost.totalBatch,
+    breakdown: { material, machine, setup: cost.setupCost }
+  };
+}
+```
+
+### 3. Add Token Billing (Optional)
+
+In `token-engine.js`, add to OPERATION_PRICES:
+
+```javascript
+// DFM analysis
+'dfm.analyze': 10,           // 5-15 tokens per analysis
+'dfm.cost_estimate': 5,
+'dfm.material_recommend': 3,
+'dfm.report_generate': 20,   // Heavier for full report
+```
+
+### 4. Create UI Controls (Optional)
+
+Add button to toolbar to trigger panel:
+
+```javascript
+// In app/index.html
+<button onclick="window.cycleCAD.dfm.createPanel()" class="toolbar-btn" title="DFM Analysis">
+  📋 Analyze
+</button>
+```
+
+## Usage Examples
+
+### Example 1: Quick Analysis
+```javascript
+const mesh = window.allParts[0].mesh;
+const result = window.cycleCAD.dfm.analyze(mesh, 'fdm');
+console.log(`Grade: ${result.grade}, Score: ${result.score}`);
+console.log(`Issues: ${result.issues.map(i => i.name).join(', ')}`);
+```
+
+### Example 2: Cost Comparison
+```javascript
+const mesh = window._selectedMesh;
+const processes = ['cnc_mill', 'injection_mold', 'sls'];
+
+for (const proc of processes) {
+  const cost = window.cycleCAD.dfm.estimateCost(mesh, proc, 100, 'plastic');
+  console.log(`${proc}: €${cost.totalBatch} for 100 units`);
+}
+```
+
+### Example 3: Material Recommendation
+```javascript
+const materials = window.cycleCAD.dfm.recommendMaterial({
+  strength: 'high',
+  temperature: 300,
+  corrosion: true,
+  cost: 'medium'
+});
+
+console.log('Top recommendations:');
+materials.forEach((m, i) => {
+  console.log(`${i+1}. ${m.name} (score: ${m.score})`);
+});
+```
+
+### Example 4: Full Report
+```javascript
+const report = window.cycleCAD.dfm.generateReport(
+  window._selectedMesh,
+  {
+    title: 'Pump Housing - DFM Analysis',
+    process: 'injection_mold',
+    material: 'polycarbonate',
+    quantity: 10000
+  }
+);
+
+// Download HTML
+const blob = new Blob([report.html], { type: 'text/html' });
+const url = URL.createObjectURL(blob);
+const a = document.createElement('a');
+a.href = url;
+a.download = 'pump-housing-dfm.html';
+a.click();
+```
+
+## API Reference
+
+### analyze(mesh, process)
+- **Returns:** `{ ok, process, processName, score, grade, passed, issues, warnings, suggestions, ... }`
+- **Fires:** `dfm-analysis-complete` event
+
+### analyzeAll(mesh)
+- **Returns:** `{ ok, processes, bestProcess, bestGrade, bestScore, summary, ... }`
+
+### estimateCost(mesh, process, quantity, materialKey)
+- **Returns:** `{ ok, process, quantity, material, materialCost, machineCost, setupCost, toolingCost, finishingCost, totalPerUnit, totalBatch, breakEvenQuantity, ... }`
+
+### compareCosts(mesh, process, quantities = [1, 10, 100, 1000, 10000], materialKey)
+- **Returns:** `{ ok, process, material, comparison: [{quantity, perUnit, total}, ...], crossovers, ... }`
+
+### recommendMaterial(requirements = {})
+- **Parameters:** `{ strength, weight, temperature, cost, corrosion, foodSafe }`
+- **Returns:** `[{ materialKey, name, score, properties }, ...]` (top 5)
+
+### estimateWeight(mesh, materialKey)
+- **Returns:** `{ ok, material, volumeCm3, densityGperCm3, weightKg, weightLb, ... }`
+
+### analyzeTolerance(mesh, tolerances = [])
+- **Parameters:** `[{ feature, tolerance, type }, ...]`
+- **Returns:** `{ ok, tolerances: [{ feature, tolerance, achievable, notAchievable, costImpact }, ...], ... }`
+
+### generateReport(mesh, options = {})
+- **Parameters:** `{ title, process, material, quantity }`
+- **Returns:** `{ ok, html, title, timestamp }`
+- **Fires:** `dfm-report-generated` event
+
+### createPanel()
+- Creates and appends UI panel to document
+- Auto-wires event handlers
+
+### on(eventName, callback) / off(eventName, callback)
+- Event system for listening to analysis/report events
+
+## Performance Notes
+
+- **Analysis time:** <100ms per process (mostly geometry inspection)
+- **Cost calculation:** <10ms per estimate
+- **Material recommendation:** <50ms (30+ materials ranked)
+- **Report generation:** <500ms (HTML building)
+- **Memory:** ~50KB for full material/rule database
+
+## Limitations & Future Work
+
+**Current:**
+- Geometry analysis simplified (uses bbox estimates, not full mesh traversal)
+- Overhangs, undercuts detected heuristically (not true geometric analysis)
+- FEA-style strength estimation very rough (bbox volume only)
+- No multi-body part assembly analysis
+
+**Potential Improvements:**
+- Integrate real FEA library (Three.js physics) for stress analysis
+- Ray-casting for true undercut detection
+- CAM integration for actual machine time estimation
+- Machine learning for cost prediction
+- Real-time manufacturing feedback as user models
+- Integration with vendor APIs (McMaster, Xometry) for live quotes
+
+## Files Modified
+
+- **Created:** `/app/js/dfm-analyzer.js` (1,760 lines)
+- **To integrate:** Add `<script>` tag to `/app/index.html`
+- **Optional:** Update `agent-api.js` with `validate.*` commands
+- **Optional:** Update `token-engine.js` with DFM operation pricing
+
+## Support
+
+Module is self-contained and requires no external dependencies beyond what cycleCAD already uses (Three.js, DOM APIs). All material data, rules, and cost algorithms are built-in.
+
+For questions or enhancements, see the inline code comments throughout `dfm-analyzer.js`.

package/DFM-QUICK-START.js

@@ -0,0 +1,253 @@
+/**
+ * DFM Analyzer Quick Start Examples
+ * Copy and paste these snippets into your browser console to test the DFM module
+ */
+
+// ============================================================================
+// BASIC ANALYSIS
+// ============================================================================
+
+// 1. Analyze a mesh for FDM (3D printing)
+const mesh = window.allParts[0].mesh;
+const fdmAnalysis = window.cycleCAD.dfm.analyze(mesh, 'fdm');
+console.log(`FDM Grade: ${fdmAnalysis.grade}, Score: ${fdmAnalysis.score}`);
+console.log('Issues:', fdmAnalysis.issues);
+console.log('Suggestions:', fdmAnalysis.suggestions);
+
+// 2. Analyze for all processes and get best match
+const allResults = window.cycleCAD.dfm.analyzeAll(mesh);
+console.log(`Best process: ${allResults.bestProcess} (Grade ${allResults.bestGrade})`);
+console.log(allResults.summary);
+
+// ============================================================================
+// COST ESTIMATION
+// ============================================================================
+
+// 3. Estimate cost for CNC milling with steel
+const cncCost = window.cycleCAD.dfm.estimateCost(mesh, 'cnc_mill', 1, 'steel-1018');
+console.log(`Material: €${cncCost.materialCost.perUnit}`);
+console.log(`Machine: €${cncCost.machineCost.total}`);
+console.log(`Setup: €${cncCost.setupCost.amortized}`);
+console.log(`TOTAL: €${cncCost.totalPerUnit}`);
+
+// 4. Compare costs across quantities
+const costComparison = window.cycleCAD.dfm.compareCosts(
+  mesh,
+  'cnc_mill',
+  [1, 10, 100, 1000],
+  'aluminum-6061'
+);
+console.table(costComparison.comparison);
+if (costComparison.crossovers.length > 0) {
+  console.log('Cost savings at higher quantities:', costComparison.crossovers);
+}
+
+// 5. Compare two different processes
+const fdmCost = window.cycleCAD.dfm.estimateCost(mesh, 'fdm', 100, 'pla');
+const moldfCost = window.cycleCAD.dfm.estimateCost(mesh, 'injection_mold', 100, 'abs');
+console.log(`FDM x100: €${fdmCost.totalBatch}`);
+console.log(`Molding x100: €${moldfCost.totalBatch}`);
+console.log(`Savings: €${fdmCost.totalBatch - moldfCost.totalBatch}`);
+
+// ============================================================================
+// MATERIAL SELECTION
+// ============================================================================
+
+// 6. Get material recommendations for high-strength, low-cost, corrosion-resistant
+const materials = window.cycleCAD.dfm.recommendMaterial({
+  strength: 'high',
+  weight: 'light',
+  temperature: 150,
+  cost: 'low',
+  corrosion: true
+});
+console.log('Top 5 recommended materials:');
+materials.forEach((m, i) => {
+  console.log(`${i+1}. ${m.name} (score: ${m.score})`);
+  console.log(`   Tensile: ${m.properties.tensile} MPa, Cost: €${m.properties.costPerKg}/kg`);
+});
+
+// ============================================================================
+// WEIGHT & TOLERANCES
+// ============================================================================
+
+// 7. Calculate part weight in different materials
+const weightSteel = window.cycleCAD.dfm.estimateWeight(mesh, 'steel-1018');
+const weightAluminum = window.cycleCAD.dfm.estimateWeight(mesh, 'aluminum-6061');
+const weightPLA = window.cycleCAD.dfm.estimateWeight(mesh, 'pla');
+console.log(`Steel: ${weightSteel.weightKg} kg`);
+console.log(`Aluminum: ${weightAluminum.weightKg} kg (${((weightAluminum.weightKg / weightSteel.weightKg) * 100).toFixed(0)}% of steel)`);
+console.log(`PLA: ${weightPLA.weightKg} kg`);
+
+// 8. Check tolerance achievability
+const toleranceAnalysis = window.cycleCAD.dfm.analyzeTolerance(mesh, [
+  { feature: 'bore_diameter', tolerance: 0.05, type: 'dimensional' },
+  { feature: 'surface_finish', tolerance: 0.8, type: 'surface' },
+  { feature: 'perpendicularity', tolerance: 0.1, type: 'geometric' }
+]);
+console.table(toleranceAnalysis.tolerances);
+
+// ============================================================================
+// REPORT GENERATION
+// ============================================================================
+
+// 9. Generate full DFM report and download as HTML
+const report = window.cycleCAD.dfm.generateReport(mesh, {
+  title: 'Part Analysis - CNC Mill Production',
+  process: 'cnc_mill',
+  material: 'aluminum-6061',
+  quantity: 100
+});
+
+// Download
+const blob = new Blob([report.html], { type: 'text/html' });
+const url = URL.createObjectURL(blob);
+const a = document.createElement('a');
+a.href = url;
+a.download = `dfm-report-${Date.now()}.html`;
+a.click();
+URL.revokeObjectURL(url);
+console.log('Report downloaded!');
+
+// ============================================================================
+// EVENT LISTENING
+// ============================================================================
+
+// 10. Listen for analysis events
+window.cycleCAD.dfm.on('dfm-analysis-complete', (result) => {
+  console.log(`Analysis complete: ${result.processName} Grade ${result.grade}`);
+  if (result.issues.length > 0) {
+    console.warn(`⚠️  ${result.issues.length} issues found`);
+  }
+});
+
+window.cycleCAD.dfm.on('dfm-report-generated', (data) => {
+  console.log(`Report generated: ${data.title}`);
+});
+
+// ============================================================================
+// UI PANEL
+// ============================================================================
+
+// 11. Create and show the interactive DFM analysis panel
+window.cycleCAD.dfm.createPanel();
+// Now select a mesh in the 3D view, choose process/material, and click "Analyze"
+
+// ============================================================================
+// ADVANCED: PROCESS-SPECIFIC CHECKS
+// ============================================================================
+
+// 12. Access the design rules for a process
+const fdmRules = window.cycleCAD.dfm.rules['fdm'];
+console.log(`FDM Rules: ${fdmRules.description}`);
+console.log('Checks:', fdmRules.checks.map(c => c.name));
+
+// 13. Access material properties directly
+const steel1018 = window.cycleCAD.dfm.materials['steel-1018'];
+console.log(`${steel1018.name}:`);
+console.log(`  Tensile: ${steel1018.tensile} MPa`);
+console.log(`  Density: ${steel1018.density} g/cm³`);
+console.log(`  Cost: €${steel1018.costPerKg}/kg`);
+console.log(`  Machinability: ${steel1018.machinability}/10`);
+
+// ============================================================================
+// BATCH OPERATIONS (Process ALL parts in scene)
+// ============================================================================
+
+// 14. Analyze all parts in the model
+if (window.allParts && window.allParts.length > 0) {
+  const results = [];
+  for (const part of window.allParts) {
+    const result = window.cycleCAD.dfm.analyze(part.mesh, 'cnc_mill');
+    results.push({
+      part: part.name || 'Unknown',
+      grade: result.grade,
+      score: result.score,
+      issues: result.issues.length,
+      warnings: result.warnings.length
+    });
+  }
+  console.table(results);
+}
+
+// 15. Find best process for all parts
+if (window.allParts && window.allParts.length > 0) {
+  const processCounts = {};
+  for (const part of window.allParts) {
+    const result = window.cycleCAD.dfm.analyzeAll(part.mesh);
+    const best = result.bestProcess;
+    processCounts[best] = (processCounts[best] || 0) + 1;
+  }
+  console.log('Best manufacturing processes across all parts:');
+  console.table(processCounts);
+}
+
+// ============================================================================
+// DEBUG INTERNALS
+// ============================================================================
+
+// 16. Access internal rate tables for debugging
+console.log('Machine hourly rates:', window.cycleCAD.dfm._machineRates);
+console.log('Time estimates (min/unit):', window.cycleCAD.dfm._timeEstimates);
+console.log('Tooling costs:', window.cycleCAD.dfm._toolingCosts);
+
+// ============================================================================
+// REAL-WORLD SCENARIO: Select Best Mfg for Volume Ramp
+// ============================================================================
+
+// 17. Find the inflection point where injection molding beats CNC
+function findCheapestProcess(mesh, quantities = [1, 10, 100, 1000, 10000]) {
+  const results = {};
+  const processes = Object.keys(window.cycleCAD.dfm.rules);
+
+  for (const qty of quantities) {
+    let cheapest = { process: null, cost: Infinity };
+    for (const proc of processes) {
+      const cost = window.cycleCAD.dfm.estimateCost(mesh, proc, qty, 'steel-1018');
+      const perUnit = parseFloat(cost.totalPerUnit);
+      if (perUnit < cheapest.cost) {
+        cheapest = { process: proc, cost: perUnit };
+      }
+    }
+    results[qty] = cheapest.process;
+  }
+  return results;
+}
+
+const bestByQuantity = findCheapestProcess(mesh);
+console.log('Cheapest process by volume:');
+console.table(bestByQuantity);
+
+// ============================================================================
+// INTERACTIVE: Manual step-by-step analysis
+// ============================================================================
+
+// 18. Step 1: Analyze
+console.log('Step 1: Analyzing for FDM...');
+const step1 = window.cycleCAD.dfm.analyze(mesh, 'fdm');
+console.log(`Result: Grade ${step1.grade}`);
+
+// Step 2: Get material recommendation
+console.log('\nStep 2: Recommending materials for FDM...');
+const step2 = window.cycleCAD.dfm.recommendMaterial({ cost: 'low', strength: 'medium' });
+const chosenMaterial = step2[0].materialKey; // Choose top recommendation
+console.log(`Recommended: ${step2[0].name}`);
+
+// Step 3: Estimate cost
+console.log('\nStep 3: Estimating cost for 100 units...');
+const step3 = window.cycleCAD.dfm.estimateCost(mesh, 'fdm', 100, chosenMaterial);
+console.log(`Cost per unit: €${step3.totalPerUnit}`);
+console.log(`Total batch (100): €${step3.totalBatch}`);
+
+// Step 4: Generate report
+console.log('\nStep 4: Generating report...');
+const step4 = window.cycleCAD.dfm.generateReport(mesh, {
+  title: 'Interactive DFM Analysis',
+  process: 'fdm',
+  material: chosenMaterial,
+  quantity: 100
+});
+console.log('Report ready. Download with:');
+console.log(`const blob = new Blob([${step4.html.substring(0, 50)}...], { type: 'text/html' });`);
+
+console.log('\n✅ All steps complete!');

package/Dockerfile

@@ -0,0 +1,69 @@
+# cycleCAD — Agent-First OS for Manufacturing
+# Serves the landing page + app via nginx
+#
+# Build:  docker build -t cyclecad .
+# Run:    docker run -p 3000:80 cyclecad
+# Open:   http://localhost:3000 (landing) / http://localhost:3000/app/ (CAD app)
+
+FROM nginx:alpine
+
+# Copy landing page
+COPY index.html /usr/share/nginx/html/
+COPY screenshot.png /usr/share/nginx/html/
+COPY competitive-analysis.html /usr/share/nginx/html/
+COPY architecture.html /usr/share/nginx/html/
+
+# Copy app
+COPY app/ /usr/share/nginx/html/app/
+
+# Copy docs if they exist
+COPY docs/ /usr/share/nginx/html/docs/
+
+# Custom nginx config
+RUN cat > /etc/nginx/conf.d/default.conf << 'NGINX'
+server {
+    listen 80;
+    server_name _;
+    root /usr/share/nginx/html;
+    index index.html;
+
+    # Enable gzip
+    gzip on;
+    gzip_types text/plain text/css application/javascript application/json model/gltf-binary;
+    gzip_min_length 1000;
+
+    # CORS
+    add_header Access-Control-Allow-Origin *;
+    add_header Access-Control-Allow-Methods "GET, POST, OPTIONS";
+
+    # Cross-Origin headers for SharedArrayBuffer
+    add_header Cross-Origin-Opener-Policy same-origin;
+    add_header Cross-Origin-Embedder-Policy require-corp;
+
+    # Cache
+    location ~* \.(js|css|png|jpg|svg|woff2|glb|stl|pptx)$ {
+        expires 7d;
+        add_header Cache-Control "public, immutable";
+    }
+
+    # SPA fallback for app
+    location /app/ {
+        try_files $uri $uri/ /app/index.html;
+    }
+
+    location / {
+        try_files $uri $uri/ /index.html;
+    }
+
+    # Health check
+    location /health {
+        return 200 '{"status":"ok","app":"cyclecad"}';
+        add_header Content-Type application/json;
+    }
+}
+NGINX
+
+EXPOSE 80
+
+HEALTHCHECK --interval=30s --timeout=5s --retries=3 \
+    CMD wget -q -O /dev/null http://localhost:80/health || exit 1