initial checkin

2026-09-29 09:44:16 +00:00
commit 01569b00b5
7 changed files with 1701 additions and 0 deletions
@@ -0,0 +1,76 @@
+# Expolinc Booth Designer
+
+**AI-driven trade fair booth design for Expolinc modular exhibition systems, powered by FreeCAD + MCP.**
+
+Design complete trade fair booths using Expolinc Classic Frame and Light Frame components — via natural language commands through an AI assistant (Claude, etc.). Generate 3D models, technical drawings, and bill of materials from simple descriptions like *"a 4x3m island booth with backlit walls and storage room."*
+
+## Features
+
+- **Parametric Expolinc component library** — Classic Frame profiles, Light Frame backlit modules, connectors, storage rooms, doors, and accessories as parametric FreeCAD objects
+- **MCP server integration** — Extends the [sergiudanstan/freecad-mcp](https://github.com/sergiudanstan/freecad-mcp) server with 12 Expolinc-specific tools
+- **Layout engine** — Supports inline, corner, peninsula, island, and custom booth configurations
+- **Bill of materials** — Component count, dimensions, weights, part numbers, recommended transport cases
+- **Technical drawings** — Dimensioned multi-view drawings via FreeCAD TechDraw
+- **CAD export** — STEP, STL, OBJ, DXF for manufacturing handoff
+
+## Systems Supported
+
+| System | Description | Sizes |
+|---|---|---|
+| **Classic Frame** | Modular aluminum frame with SEG fabric graphics, tool-less magnetic assembly | Widths: 500–4950mm, Heights: 2500/3000mm |
+| **Light Frame** | Backlit LED frame system, integrates with Classic Frame | Same sizes + LED temperature/brightness config |
+| **Connectors** | 90° corner, 180° inline, T-connector | — |
+| **Accessories** | Storage rooms, doors, shelves, bridge connectors, support feet | — |
+
+## Quick Start
+
+```bash
+# 1. Install FreeCAD 1.0+ from freecad.org
+# 2. Clone the repository
+git clone https://github.com/your-org/expolinc-booth-designer
+cd expolinc-booth-designer
+
+# 3. Install component library
+cp -r ExpolincLib /path/to/FreeCAD/Mod/
+
+# 4. Install MCP server
+npm install
+npm run build
+
+# 5. Add to your AI assistant's MCP configuration
+# See docs/INSTALL.md for details
+```
+
+## Project Structure
+
+```
+expolinc-booth-designer/
+├── ExpolincLib/                  # FreeCAD Python component library
+│   ├── __init__.py
+│   ├── classic_frame.py          # Classic Frame parametric components
+│   ├── light_frame.py            # Light Frame parametric components
+│   ├── connectors.py             # Corner and inline connectors
+│   ├── accessories.py            # Storage rooms, doors, shelves
+│   ├── layouts.py                # Booth layout generators
+│   ├── bom.py                    # Bill of materials generator
+│   └── specs.py                  # Expolinc official specifications
+├── mcp-server/                   # FreeCAD MCP server extension
+│   ├── src/
+│   │   ├── server.ts             # MCP server entry point
+│   │   ├── expolinc_tools.ts     # Expolinc-specific MCP tools
+│   │   ├── layout_engine.ts      # Booth layout logic
+│   │   └── bom_generator.ts      # BOM generation logic
+│   └── package.json
+├── docs/
+│   ├── ARCHITECTURE.md           # System architecture
+│   ├── INSTALL.md                # Installation guide
+│   ├── COMPONENT_LIBRARY.md      # Component library reference
+│   ├── MCP_TOOLS.md              # MCP tools reference
+│   ├── BOOTH_LAYOUTS.md          # Booth layout patterns
+│   └── BILL_OF_MATERIALS.md      # BOM output guide
+└── README.md
+```
+
+## License
+
+MIT