COVEROQ CAD Platform - Parametric CAD Configurator & Studio
Welcome to the technical documentation for the COVEROQ CAD Platform (3D-platforma).
🧭 Documentation Overview
| Section | Description |
|---|---|
| System Requirements | Minimum hardware, power consumption, software dependencies, and FreeCAD requirements. |
| Deployment & Architecture | Distributed C# .NET 10 & SignalR WebSocket CAD architecture between Hetzner Cloud (cad.coveroq.cz) and pc-jakub. |
| Autonomous AI Lifecycle | Multi-agent co-development loop (Antigravity & Google Jules) and autonomous sentinels (Drift, Hygiene, Coverage, Logs). |
| Public API Docs | Architecture layer contracts, domain models, Minimal API endpoints, and SignalR hubs (/hubs/cad, /hubs/telemetry). |
| Developer Notes | Local development setup with .NET 10, FreeCAD geometry scripting, and telemetry log sentinels. |
🚀 Key Architectural Concepts
- Clean Architecture v2 (.NET 10): Strict dependency layering (
Domain->Application->Infrastructure->Api) enforced by Roslyn Analyzers (CCAD001–CCAD015) andCoveroq.Cad.ArchitectureTests. - Distributed CAD Worker Engine (
Coveroq.Cad.Worker): Offloads heavy FreeCAD 1.1 geometry calculations and GLB/STEP exports from the Hetzner Cloud VPS to a dedicated GPU-accelerated worker station (pc-jakub) connected via SignalRCadHub(/hubs/cad). - Web CAD Studio & LCS Snapping: WebGL 3D assembly editor (
/studio), skeleton structures, bottom parts filmstrip carousel (PartsFilmstripComponent), and magnetic LCS anchor point snapping (LcsSnapController). - Zero-Fallback Principle (Rule 12): Single deterministic execution path, failing fast with explicit telemetry context (
TraceId,CorrelationId). - Autonomous AI Engineering & Sentinels: Automated task queueing and PR code reviews via
Coveroq.Cad.Orchestratorcombined with continuous repo auditing by autonomous sentinels.