Files
wenil 6bc922cabf Add hex holder designer page (/holder)
Server-side OpenSCAD renders STL from bundled hex_cell.scad with parameter
overrides via -D. Frontend is a Three.js viewer with auto-form generated
from /api/holder/params. 'Design busbars →' button posts the computed
cell coordinates to /api/projects and redirects to the busbar editor with
the holder cells pre-loaded.

  - holder.py:                openscad subprocess wrapper + compute_cells()
                              (Python mirror of get_hex_center_points_*)
  - scad/hex_cell.scad:       verbatim copy of Addy/Hex-Cell-Holder source
  - app.py:                   /holder route + /api/holder/{params,render,cells}
  - static/holder.html etc:   parameter form + Three.js STL viewer
  - Dockerfile / install.sh:  apt install openscad
  - static/index.html:        nav link Holder ↔ Busbars in topbar
2026-05-24 19:27:50 +03:00

238 lines
6.7 KiB
Python

"""Flask entrypoint for Busbar Designer.
Serves the static frontend, the /api/export/<fmt> CAD endpoints (build123d →
STEP/DXF/SVG), and the /api/projects, /api/presets, /api/snapshots persistence
endpoints (SQLite via storage.py).
Run:
python app.py
"""
from __future__ import annotations
import os
import sys
import traceback
from flask import Flask, Response, jsonify, request, send_from_directory
from busbar_export import WRITERS
import storage
import holder
APP_DIR = os.path.dirname(os.path.abspath(__file__))
STATIC_DIR = os.path.join(APP_DIR, "static")
app = Flask(__name__, static_folder=STATIC_DIR, static_url_path="")
storage.init_db()
# ---------------------------------------------------------------------------
# Static + health
# ---------------------------------------------------------------------------
@app.get("/")
def index():
return send_from_directory(STATIC_DIR, "index.html")
@app.get("/holder")
def holder_page():
return send_from_directory(STATIC_DIR, "holder.html")
@app.get("/api/health")
def health():
return jsonify({"status": "ok", "openscad": holder.openscad_available()})
# ---------------------------------------------------------------------------
# Hex holder designer (OpenSCAD-backed)
# ---------------------------------------------------------------------------
@app.get("/api/holder/params")
def holder_params():
"""Schema for the parameter form + their defaults."""
return jsonify({"params": holder.schema_dict(), "defaults": holder.default_params()})
@app.post("/api/holder/render")
def holder_render():
"""Render STL for the supplied parameter overrides."""
body = request.get_json(silent=True) or {}
try:
data = holder.render_stl(body.get("params", {}))
except (FileNotFoundError, RuntimeError) as e:
return jsonify({"error": str(e)}), 500
return Response(
data,
mimetype="model/stl",
headers={"Content-Disposition": 'attachment; filename="hex_holder.stl"'},
)
@app.post("/api/holder/cells")
def holder_cells():
"""Cell-center coordinates for the supplied parameters (no OpenSCAD needed)."""
body = request.get_json(silent=True) or {}
try:
cells = holder.compute_cells(body.get("params", {}))
except ValueError as e:
return jsonify({"error": str(e)}), 400
return jsonify({"cells": cells, "count": len(cells)})
# ---------------------------------------------------------------------------
# CAD export (unchanged contract)
# ---------------------------------------------------------------------------
@app.post("/api/export/<fmt>")
def export(fmt: str):
fmt = fmt.lower()
if fmt not in WRITERS:
return jsonify({"error": f"unsupported format: {fmt}"}), 400
payload = request.get_json(silent=True) or {}
writer, mimetype, ext = WRITERS[fmt]
try:
data = writer(payload)
except ValueError as e:
return jsonify({"error": str(e)}), 400
except Exception as e:
traceback.print_exc()
return jsonify({"error": f"{type(e).__name__}: {e}"}), 500
filename = f"busbars.{ext}"
return Response(
data,
mimetype=mimetype,
headers={"Content-Disposition": f'attachment; filename="{filename}"'},
)
# ---------------------------------------------------------------------------
# Projects
# ---------------------------------------------------------------------------
@app.get("/api/projects")
def projects_index():
return jsonify(storage.list_projects())
@app.post("/api/projects")
def projects_create():
body = request.get_json(silent=True) or {}
name = (body.get("name") or "Untitled").strip() or "Untitled"
data = body.get("data") or {}
pid = storage.create_project(name, data)
return jsonify({"id": pid, "name": name})
@app.get("/api/projects/<int:pid>")
def projects_show(pid: int):
p = storage.get_project(pid)
if p is None:
return jsonify({"error": "not found"}), 404
return jsonify(p)
@app.put("/api/projects/<int:pid>")
def projects_update(pid: int):
body = request.get_json(silent=True) or {}
ok = storage.update_project(
pid,
name=body.get("name"),
data=body.get("data"),
snapshot=bool(body.get("snapshot", False)),
note=body.get("note"),
)
if not ok:
return jsonify({"error": "not found"}), 404
return jsonify({"ok": True})
@app.delete("/api/projects/<int:pid>")
def projects_delete(pid: int):
storage.delete_project(pid)
return jsonify({"ok": True})
# ---------------------------------------------------------------------------
# Snapshots
# ---------------------------------------------------------------------------
@app.get("/api/projects/<int:pid>/snapshots")
def snapshots_index(pid: int):
return jsonify(storage.list_snapshots(pid))
@app.get("/api/snapshots/<int:sid>")
def snapshot_show(sid: int):
snap = storage.get_snapshot(sid)
if snap is None:
return jsonify({"error": "not found"}), 404
return jsonify(snap)
@app.post("/api/snapshots/<int:sid>/restore")
def snapshot_restore(sid: int):
if not storage.restore_snapshot(sid):
return jsonify({"error": "not found"}), 404
return jsonify({"ok": True})
# ---------------------------------------------------------------------------
# Presets
# ---------------------------------------------------------------------------
@app.get("/api/presets")
def presets_index():
return jsonify(storage.list_presets())
@app.post("/api/presets")
def presets_create():
body = request.get_json(silent=True) or {}
name = (body.get("name") or "").strip()
if not name:
return jsonify({"error": "name required"}), 400
pid = storage.create_preset(name, body.get("params") or {})
if pid is None:
return jsonify({"error": "name already in use"}), 409
return jsonify({"id": pid, "name": name})
@app.put("/api/presets/<int:pid>")
def presets_update(pid: int):
body = request.get_json(silent=True) or {}
ok = storage.update_preset(pid, name=body.get("name"), params=body.get("params"))
if not ok:
return jsonify({"error": "not found or name conflict"}), 404
return jsonify({"ok": True})
@app.delete("/api/presets/<int:pid>")
def presets_delete(pid: int):
storage.delete_preset(pid)
return jsonify({"ok": True})
# ---------------------------------------------------------------------------
# Boot
# ---------------------------------------------------------------------------
if __name__ == "__main__":
port = int(os.environ.get("PORT", 5000))
host = os.environ.get("HOST", "127.0.0.1")
debug = os.environ.get("FLASK_DEBUG", "1") == "1"
print(f" * Busbar Designer running on http://{host}:{port}", file=sys.stderr)
app.run(host=host, port=port, debug=debug)