feat(K): Blender Asset Library + production exports (GLB + .blend)

- feat(migration): 045_asset_libraries — new asset_libraries table (blend_file_path, catalog JSONB) - feat(model): AssetLibrary SQLAlchemy model in domains/materials/models.py - feat(api): POST/GET/PATCH/DELETE /api/asset-libraries + /upload-blend + /refresh-catalog endpoints - feat(celery): refresh_asset_library_catalog task on thumbnail_rendering queue — runs Blender headless - feat(blender): catalog_assets.py — extracts asset-marked materials + node_groups from .blend - feat(blender): asset_library.py — apply_asset_library_materials + apply_asset_library_node_groups helpers - feat(blender): export_gltf.py — STEP→STL→GLB production export with optional asset library - feat(blender): export_blend.py — STEP→STL→.blend production export with pack_all() - feat(frontend): api/assetLibraries.ts — full CRUD API client - feat(frontend): AssetLibraryPanel in Admin.tsx — upload, refresh, expand catalog view - docs: Blender asset_data marking requirement learning in LEARNINGS.md Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-06 20:56:26 +01:00
parent 7a1329958d
commit a18d4c23ec
14 changed files with 922 additions and 10 deletions
@@ -0,0 +1,78 @@
+"""Blender headless script: export a STEP-derived scene as a production .blend.
+
+Usage:
+    blender --background --python export_blend.py -- \\
+        --stl_path /path/to/file.stl \\
+        --output_path /path/to/output.blend \\
+        [--asset_library_blend /path/to/library.blend] \\
+        [--material_map '{"SrcMat": "LibMat"}']
+
+The script:
+1. Imports the STL file (with mm→m scale).
+2. Optionally applies asset library materials from a .blend.
+3. Packs all external data.
+4. Saves a copy as the output .blend.
+"""
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+import traceback
+
+
+def parse_args() -> argparse.Namespace:
+    argv = sys.argv
+    if "--" not in argv:
+        print("No arguments after --", file=sys.stderr)
+        sys.exit(1)
+    rest = argv[argv.index("--") + 1:]
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--stl_path", required=True)
+    parser.add_argument("--output_path", required=True)
+    parser.add_argument("--asset_library_blend", default=None)
+    parser.add_argument("--material_map", default="{}")
+    return parser.parse_args(rest)
+
+
+def main() -> None:
+    args = parse_args()
+    material_map: dict = json.loads(args.material_map)
+
+    import bpy  # type: ignore[import]
+
+    # Clean scene
+    bpy.ops.wm.read_factory_settings(use_empty=True)
+
+    # Import STL
+    bpy.ops.import_mesh.stl(filepath=args.stl_path)
+
+    # Scale mm → m
+    for obj in bpy.context.selected_objects:
+        obj.scale = (0.001, 0.001, 0.001)
+        bpy.context.view_layer.objects.active = obj
+        bpy.ops.object.transform_apply(scale=True)
+
+    # Apply asset library materials if provided
+    if args.asset_library_blend and material_map:
+        import os
+        sys.path.insert(0, os.path.dirname(__file__))
+        from asset_library import apply_asset_library_materials
+        apply_asset_library_materials(args.asset_library_blend, material_map)
+
+    # Pack all external data into the .blend
+    bpy.ops.file.pack_all()
+
+    # Save a copy to output_path
+    bpy.ops.wm.save_as_mainfile(filepath=args.output_path, compress=True, copy=True)
+
+    print(f".blend exported to {args.output_path}")
+
+
+try:
+    main()
+except SystemExit:
+    raise
+except Exception:
+    traceback.print_exc()
+    sys.exit(1)