Add assembly.png and cnclayout.svg with auto-generation

Copilot · dorkmo · Copilot · commit 5e0cda1615b1 · 2025-12-06T23:23:59.000Z
Co-authored-by: dorkmo &lt;1923070+dorkmo@users.noreply.github.com&gt;
diff --git a/.github/workflows/openscad-render.yml b/.github/workflows/openscad-render.yml
@@ -56,6 +56,29 @@ jobs:
           cd LifeTrac-v25/mechanical_design
           mkdir -p output/{stl,dxf,renders,animations}
       
+      - name: Generate assembly.png and cnclayout.svg
+        run: |
+          cd LifeTrac-v25/mechanical_design
+          
+          # Generate assembly.png (1024x768 matching CEB-Press example)
+          echo "Generating assembly.png..."
+          xvfb-run openscad -o assembly.png \
+            --camera=3000,3000,2000,0,0,500 \
+            --imgsize=1024,768 \
+            --projection=p \
+            --colorscheme=Nature \
+            openscad/lifetrac_v25.scad
+          
+          # Generate cnclayout.svg (2D projection for CNC cutting)
+          echo "Generating cnclayout.svg..."
+          xvfb-run openscad -o cnclayout.svg \
+            --projection=o \
+            --viewall \
+            cnclayout.scad
+          
+          echo "✓ assembly.png and cnclayout.svg generated successfully"
+          ls -lh assembly.png cnclayout.svg
+      
       - name: Render preview images
         run: |
           cd LifeTrac-v25/mechanical_design
@@ -228,6 +251,28 @@ jobs:
           path: LifeTrac-v25/mechanical_design/output/animations/
           retention-days: 90
       
+      - name: Commit and push assembly.png and cnclayout.svg
+        run: |
+          cd LifeTrac-v25/mechanical_design
+          git config --global user.name 'github-actions[bot]'
+          git config --global user.email 'github-actions[bot]@users.noreply.github.com'
+          
+          # Add the generated files
+          git add assembly.png cnclayout.svg
+          
+          # Check if there are changes
+          if ! git diff --staged --quiet; then
+            git commit -m "Update assembly.png and cnclayout.svg [skip ci]"
+            git push --force-with-lease origin HEAD || {
+              echo "INFO: git push failed. This is expected on PRs from forks."
+              echo "The files are available as workflow artifacts."
+            }
+          else
+            echo "No changes to assembly.png or cnclayout.svg"
+          fi
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      
       - name: Comment on PR with results
         if: github.event_name == 'pull_request'
         uses: actions/github-script@v7
diff --git a/.gitignore b/.gitignore
@@ -12,6 +12,10 @@ LifeTrac-v25/mechanical_design/output/
 *.jpg
 *.jpeg
 
+# Except these specific files which should be committed
+!LifeTrac-v25/mechanical_design/assembly.png
+!LifeTrac-v25/mechanical_design/cnclayout.svg
+
 # OpenSCAD cache
 *.csg
 *.ast
diff --git a/LifeTrac-v25/mechanical_design/README.md b/LifeTrac-v25/mechanical_design/README.md
@@ -16,6 +16,9 @@ The LifeTrac v25 is a remotely-operated compact utility loader designed to be si
 
 ```
 mechanical_design/
+├── assembly.png           # 3D render of complete assembly (auto-generated)
+├── cnclayout.svg          # 2D CNC cutting layout (auto-generated)
+├── cnclayout.scad         # OpenSCAD file for CNC layout generation
 ├── openscad/              # Main OpenSCAD design files
 │   └── lifetrac_v25.scad  # Main assembly file
 ├── modules/               # Reusable OpenSCAD modules
@@ -34,6 +37,23 @@ mechanical_design/
 └── AI_DESIGN_PROGRESS.md # AI design session tracker
 ```
 
+## Key Files
+
+### assembly.png
+![Assembly Preview](assembly.png)
+
+A 3D rendered view of the complete LifeTrac v25 assembly (1024×768px). This image is automatically generated by GitHub Actions whenever the OpenSCAD files are updated. It provides a quick visual reference of the overall design.
+
+### cnclayout.svg
+
+A 2D vector layout of all plate steel parts organized for CNC plasma cutting. Parts are:
+- Color-coded by thickness (blue = 1/4", red = 1/2")
+- Labeled with part numbers and descriptions
+- Laid out with proper spacing for cutting
+- All corners pre-rounded to 6.35mm radius
+
+This file can be imported into CAM software (SheetCAM, etc.) for generating G-code.
+
 ## Quick Start
 
 ### Prerequisites
diff --git a/LifeTrac-v25/mechanical_design/SUMMARY.md b/LifeTrac-v25/mechanical_design/SUMMARY.md
@@ -27,12 +27,24 @@ A complete parametric 3D CAD system built from scratch:
 ### Manufacturing Support
 Tools for going from design to physical parts:
 
+- **Assembly Visualization**
+  - `assembly.png` - 1024×768 3D render (auto-generated)
+  - Shows complete machine from optimal viewing angle
+  - Updated automatically via GitHub Actions
+
+- **CNC Cutting Layout**
+  - `cnclayout.svg` - Vector layout for plasma cutting (auto-generated)
+  - All plate parts organized by thickness
+  - Color-coded (blue=1/4", red=1/2")
+  - Ready for CAM software import
+
 - **GitHub Actions Workflow** - Automated rendering
   - Syntax validation
   - Multi-angle preview renders
   - STL generation for 3D printing
   - 36-frame animation
   - Module examples
+  - Automatic assembly.png and cnclayout.svg generation
   
 - **CNC Export System**
   - Individual part DXF export
diff --git a/LifeTrac-v25/mechanical_design/assembly.png b/LifeTrac-v25/mechanical_design/assembly.png
diff --git a/LifeTrac-v25/mechanical_design/cnclayout.scad b/LifeTrac-v25/mechanical_design/cnclayout.scad
@@ -0,0 +1,89 @@
+// cnclayout.scad
+// CNC layout for all plate steel parts
+// Generates 2D projection for plasma cutting
+// Part of LifeTrac v25 OpenSCAD design
+
+use <modules/plate_steel.scad>
+
+// Plate thicknesses
+PLATE_1_4 = 6.35;  // 1/4"
+PLATE_1_2 = 12.7;  // 1/2"
+
+// Layout spacing
+SPACING = 20; // mm between parts
+START_X = 10;
+START_Y = 10;
+
+// Color coding by thickness
+COLOR_1_4 = "blue";
+COLOR_1_2 = "red";
+
+// Current position tracking
+x_offset = START_X;
+y_offset = START_Y;
+row_height = 0;
+
+module layout_part(width, height, thickness, label, x, y) {
+    translate([x, y, 0]) {
+        projection(cut=false) {
+            color(thickness == PLATE_1_4 ? COLOR_1_4 : COLOR_1_2)
+            plate_steel(width, height, thickness, 6.35);
+        }
+        // Part label
+        translate([5, 5, 0])
+        text(label, size=8, font="Liberation Sans:style=Bold");
+        
+        // Thickness indicator
+        translate([5, height - 15, 0])
+        text(str(thickness == PLATE_1_4 ? "1/4\"" : "1/2\""), size=6);
+    }
+}
+
+// Layout all parts in rows
+// Row 1: Half-inch plates (wheel mounts and high-stress parts)
+layout_part(300, 300, PLATE_1_2, "A2-1 Wheel Mount FL", START_X, START_Y);
+layout_part(300, 300, PLATE_1_2, "A2-2 Wheel Mount FR", START_X + 300 + SPACING, START_Y);
+layout_part(300, 300, PLATE_1_2, "A2-3 Wheel Mount RL", START_X + 2*(300 + SPACING), START_Y);
+layout_part(300, 300, PLATE_1_2, "A2-4 Wheel Mount RR", START_X + 3*(300 + SPACING), START_Y);
+
+// Row 2: Half-inch plates continued
+layout_part(200, 200, PLATE_1_2, "C2-1 Bucket Attach L", START_X, START_Y + 300 + SPACING);
+layout_part(200, 200, PLATE_1_2, "C2-2 Bucket Attach R", START_X + 200 + SPACING, START_Y + 300 + SPACING);
+layout_part(100, 150, PLATE_1_2, "Cyl Lug 1", START_X + 2*(200 + SPACING), START_Y + 300 + SPACING);
+layout_part(100, 150, PLATE_1_2, "Cyl Lug 2", START_X + 2*(200 + SPACING) + 100 + SPACING, START_Y + 300 + SPACING);
+layout_part(100, 150, PLATE_1_2, "Cyl Lug 3", START_X + 2*(200 + SPACING) + 2*(100 + SPACING), START_Y + 300 + SPACING);
+layout_part(100, 150, PLATE_1_2, "Cyl Lug 4", START_X + 2*(200 + SPACING) + 3*(100 + SPACING), START_Y + 300 + SPACING);
+
+// Row 3: Quarter-inch plates (bucket)
+layout_part(1100, 600, PLATE_1_4, "E1-1 Bucket Bottom", START_X, START_Y + 2*(300 + SPACING));
+
+// Row 4: Quarter-inch plates (bucket continued)
+layout_part(1100, 400, PLATE_1_4, "E1-2 Bucket Back", START_X, START_Y + 2*(300 + SPACING) + 600 + SPACING);
+
+// Row 5: Quarter-inch plates (bucket sides and arms)
+layout_part(600, 400, PLATE_1_4, "E1-3 Bucket Side L", START_X, START_Y + 2*(300 + SPACING) + 600 + 400 + 2*SPACING);
+layout_part(600, 400, PLATE_1_4, "E1-4 Bucket Side R", START_X + 600 + SPACING, START_Y + 2*(300 + SPACING) + 600 + 400 + 2*SPACING);
+
+// Row 6: Quarter-inch plates (arm reinforcements and deck)
+layout_part(150, 1200, PLATE_1_4, "C1-1 Arm Reinf L", START_X, START_Y + 2*(300 + SPACING) + 600 + 400 + 400 + 3*SPACING);
+layout_part(150, 1200, PLATE_1_4, "C1-2 Arm Reinf R", START_X + 150 + SPACING, START_Y + 2*(300 + SPACING) + 600 + 400 + 400 + 3*SPACING);
+
+// Row 7: Quarter-inch plates (standing deck)
+layout_part(1000, 400, PLATE_1_4, "F1 Standing Deck", START_X + 2*(150 + SPACING), START_Y + 2*(300 + SPACING) + 600 + 400 + 400 + 3*SPACING);
+
+// Row 8: Quarter-inch plate (control housing base)
+layout_part(300, 200, PLATE_1_4, "G1 Housing Base", START_X, START_Y + 2*(300 + SPACING) + 600 + 400 + 400 + 1200 + 4*SPACING);
+
+// Add title and legend
+translate([10, START_Y + 2*(300 + SPACING) + 600 + 400 + 400 + 1200 + 200 + 5*SPACING, 0])
+text("LifeTrac v25 CNC Layout", size=16, font="Liberation Sans:style=Bold");
+
+translate([10, START_Y + 2*(300 + SPACING) + 600 + 400 + 400 + 1200 + 180 + 5*SPACING, 0])
+text("Blue = 1/4\" plate | Red = 1/2\" plate", size=10);
+
+// Add cutting instructions
+translate([10, START_Y + 2*(300 + SPACING) + 600 + 400 + 400 + 1200 + 160 + 5*SPACING, 0])
+text("Maintain 3mm spacing between cuts", size=8);
+
+translate([10, START_Y + 2*(300 + SPACING) + 600 + 400 + 400 + 1200 + 145 + 5*SPACING, 0])
+text("All corners 6.35mm radius", size=8);
diff --git a/LifeTrac-v25/mechanical_design/cnclayout.svg b/LifeTrac-v25/mechanical_design/cnclayout.svg
