Descripción general

Producto

El escritorio combina un banco de trabajo SolidJS con un shell Tauri. El banco de trabajo edita dibujos y modelos, muestra la geometría en una ventana gráfica de Three.js, gestiona las operaciones de mecanizado y obtiene una vista previa o exporta código G. Los datos del proyecto, las herramientas, los materiales, las configuraciones de la máquina y el estado del asistente se gestionan mediante un sidecar Bun y se almacenan localmente.

El núcleo computacional se comparte entre el escritorio y el sidecar. La geometría interactiva se puede ejecutar en la vista web sin un viaje de ida y vuelta HTTP; Las operaciones persistentes, las llamadas a proveedores, el historial de proyectos y la ejecución del flujo de trabajo pasan por servicios complementarios. El almacenamiento local no requiere una cuenta de aplicación alojada. Los proveedores de inteligencia artificial, las operaciones de GitHub, los pagos y las actualizaciones de software utilizan sus servicios de red configurados.

Diseño a mecanizado

1. Cree o abra un proyecto y prepare sus dibujos, entidades o escena sólida. El referencia CAD cubre bocetos, geometría B-rep, teselación y formatos de intercambio.
2. Elija una operación, herramienta, material y configuración de la máquina. Generar trayectorias de herramientas con el servicios de leva e inspeccionar el resultado en la ventana gráfica.
3. Usar configuraciones de mecanizado y documentos del programa para conservar el orden de operación, los marcos de trabajo y la configuración del programa. Seleccione una publicación registrada para el controlador deseado.
4. Revise el programa generado y los resultados de la verificación antes de exportar. El núcleo de geometría, el registro posterior, las transformaciones avanzadas de código G y la configuración de la máquina son partes distintas de este proceso.
5. Grabe una instantánea del proyecto con historia, o ejecutar un registrado flujo de trabajo para validación y procesamiento repetidos.

El asistente invoca acciones de la aplicación a través de los mismos adaptadores de servicio utilizados por la aplicación. El compañero móvil se conecta a un escritorio emparejado; no ejecuta un segundo backend CAD/CAM en el teléfono.

Componentes de tiempo de ejecución

apps/desktop

El banco de trabajo SolidJS, adaptadores de ruta, módulos de funciones, ventana gráfica y shell Tauri nativo.

apps/sidecar

Controladores HTTP autenticados, repositorios, servicios Effect, identidad local, integración de IA, puerta de enlace complementaria y ciclo de vida de la base de datos.

apps/mobile

Compañero de exposición con transporte de emparejamiento nativo, vistas de proyectos e historial y acceso de asistente.

packages/web

Este sitio de documentación de Astro, exportación de Markdown, asistente de documentación, páginas de guía generadas y Studio local.

El referencia del espacio de trabajo describe cada biblioteca, su punto de entrada público y sus consumidores. El mapa fuente apunta a archivos de implementación para cambios comunes.

Iniciar desarrollo

bun install
bun run desktop:dev

# Documentation and local Studio
bun run --filter @cadcamfun/web dev

El comando de escritorio compila el sidecar y copia los recursos de migración antes de iniciar Tauri. Se deben instalar Rust y los requisitos previos de compilación de la plataforma webview. Para ejecutar el servidor de documentación sin iniciar la API de Studio local, utilice bun run --filter @cadcamfun/web start.

Seguir Inicio rápido para conocer los requisitos previos y el primer lanzamiento, o Desarrollo local para sidecar aislado y bucles de cliente.

Contratos y persistencia

packages/api/src/index.ts compone el contrato HTTP de primer esquema. el sidecar ServedApi selecciona los grupos a los que sirve y publica un documento OpenAPI en /api/openapi.json. El shell descubre el puerto loopback asignado dinámicamente a partir de un evento de preparación y proporciona a la vista web un punto final y un token de portador.

La base de datos del sidecar es cadcamfun.db en su directorio de datos configurado. La capa de base de datos habilita claves externas y WAL, aplica migraciones configuradas y realiza una copia de seguridad de un archivo existente antes de una actualización pendiente. El estudio de documentación tiene su propia selección de ruta de base de datos; no descubre automáticamente el archivo del sidecar en ejecución.

Estas páginas describen la implementación en este repositorio. Una exportación de paquete, un punto final HTTP, un control de escritorio y un instalador publicado son superficies de integración diferentes; consulte la referencia correspondiente para conocer los comportamientos y límites admitidos.

Elija una ruta de trabajo

Los guardados de proyectos, las versiones de recursos, las confirmaciones de todo el proyecto, la sincronización remota y los artefactos de guía generados son operaciones independientes. Guardar una trayectoria no la confirma automáticamente y una inserción exitosa en GitHub no verifica su resultado de mecanizado.

Para una primera integración API, siga las instrucciones solicitar tutorial. Muestra la sonda de salud pública, las llamadas protegidas, la creación de proyectos y el almacenamiento de preferencias con respuestas capturadas del controlador.

Documentación operativa

El biblioteca de guías recorre tareas completas. Empezar con creación de proyectos y trabajo guardado, luego usa fabricación nativa tomar un diseño capturado a través de la generación y la persistencia del programa. Ambos explican qué se salva y qué queda en estado derivado o no salvo.

Para el trabajo de integración, el Referencia de recursos API cubre cada operación declarada con esquemas de solicitud y respuesta. El guía de integración de clientes cubre la construcción, autenticación, cancelación y manejo de errores de Promesa y Efecto. El guía de transmisión agrega recuperación de conversación y manejo interactivo de permisos/preguntas.

Para operación y soporte consultar configuración de tiempo de ejecución, diagnóstico de escritorio, y pareja de compañeros. Cada uno mantiene distintos el shell nativo, el sidecar, la base de datos, el proveedor, la puerta de enlace telefónica y la implementación de la documentación para que se pueda investigar una falla en su límite real.

Para extensiones y trabajo en equipo, use creación de complementos y sucursales, revisiones y flujos de trabajo. Estas guías documentan las exportaciones de módulos admitidos, el comportamiento actual del host, las reglas de combinación estructural, las entradas de flujo de trabajo comprometidas y los efectos secundarios respaldados por el servicio.

CADCAMFUN en cifras

Qué hay de nuevo

Trabajo reciente en la rama principal, resumido del historial de confirmaciones:

• Núcleo exacto en el sidecar. A cadExact grupo (analyze, step, assembly) ejecuta un análisis de escena compartido desde el núcleo: validez por sólido, masa, agujeros, interferencia, lista de materiales y sujetadores faltantes.
• Modelado exacto. Barridos y barrido de estructuras, recubrimientos con columnas regladas racionales, push-pull y relación de posición en caras exactas y filetes aproximadamente 2.5 veces más rápido.
• Subprogramas NC. Las trayectorias repetidas se escriben una vez como incremental. M98 subprograma; la repetición entiende O-programas, M98/M99 y G91. Cableado de extremo a extremo desde la instantánea hasta el conmutador de escritorio.
• CAM de B-rep. El planificador lee agujeros, cavidades y contornos de sólidos exactos, incluidas piezas STEP y piezas rotadas; El desbaste volumétrico funciona a lo largo de un eje de herramienta inclinado.
• Asistente de endurecimiento. Every action declares its result schema; destructive tools always need a human; each turn is bound to its drawing with compare-and-swap writes; a durable background-task journal; kernel jobs in a worker.
• Documentación. Este sitio de Astro con una referencia API generada para cada operación.

Próximos pasos

En 3D