IU da área de trabalho

Arquitetura de aplicativo

O aplicativo de desktop combina um webview SolidJS, Vite, Three.js e um shell Tauri v2 Rust. O webview possui telas e estados de interação. O sidecar Bun possui manipuladores de API, acesso a banco de dados, sessões de IA e serviços de projeto. O processo Rust possui a janela, os menus, a bandeja, as caixas de diálogo do sistema operacional, o acesso às chaves, as atualizações e o ciclo de vida do sidecar.

apps/desktop/src/main.tsx monta o aplicativo. app/App.tsx estabelece a conexão API e fornece estado compartilhado; app/routes.tsx mapeia URLs para módulos de páginas lentas. Telas de recursos ao vivo features/. A presença de uma rota não estabelece a disponibilidade de seus serviços externos: o faturamento precisa da configuração do Stripe e a IA precisa de um provedor configurado.

Inicialização e recuperação de conexão

1. O shell inicia o sidecar empacotado com um token de inicialização gerado e dados de aplicativo e diretórios de migração.
2. O sidecar vincula uma porta efêmera em 127.0.0.1, aguarda a resposta de sua rota de integridade e grava um JSON ready evento contendo a porta.
3. A visualização da web invoca get_sidecar_endpoint e cria um cliente API e um tempo de execução de efeito gerenciado.
4. Uma solicitação de integridade bem-sucedida cria o estado do aplicativo e monta o roteador e o shell.

O webview permite 150 segundos para recuperação de conexão, com um tempo limite de 30 segundos por tentativa e uma pausa de repetição de 750 milissegundos. Tentativas fracassadas descartam o endpoint armazenado em cache para que um sidecar reiniciado possa fornecer uma nova porta. O supervisor Rust espera 60 segundos para cada handshake pronto e permite uma reinicialização automática. A nova tentativa fica disponível quando o orçamento de conexão do webview expira.

Rotas de tela

Usar app/routes.tsx para nomes exatos de parâmetros e pages/ para localizar a tela montada em um URL. Os adaptadores de rota são intencionalmente pequenos; leia a tela e suas chamadas de API ao diagnosticar uma visualização vazia ou uma ação com falha.

Organização de origem

• app/: inicialização, roteador, cliente API global, integração nativa, shell e atalhos de teclado.
• pages/: adaptadores de rota importando ou reexportando telas.
• features/: áreas de produtos com telas, componentes, ganchos, estado e auxiliares específicos de domínio.
• shared/: controles reutilizáveis, componentes do shell, estado do aplicativo, cache de consultas e histórico de comandos.
• viewport/: desenho de tela, encaixe, gestos de ferramentas, renderização Three.js, malha e reprodução.
• i18n/, styles/, e testing/: traduções, estilos globais e acessórios de teste.

A área de trabalho depende de @cadcamfun/api para o contrato HTTP e em @cadcamfun/core para geometria e operações CAM. A persistência do banco de dados permanece por trás da API secundária. O histórico do editor local é diferente das versões persistentes de desenho ou percurso e do controle de versão do projeto.

Concha nativa

A janela de produção é 1440 × 900 por padrão, com um mínimo de 960 × 600. Tauri prepara o frontend de apps/desktop/dist, um sidecar específico do alvo de src-tauri/binariese gerou migrações como recursos. Ele registra .cadcam, .nc, e .gcode associações de arquivos. Abrir um arquivo compatível ou iniciar uma segunda instância encaminha os caminhos dos arquivos para a janela existente.

src-tauri/src/sidecar.rs supervisiona o processo filho. Fechar o aplicativo escreve um {"event":"shutdown"} linha para o stdin da criança e espera um pouco antes de colhê-lo; a criança também observa o fechamento do stdin. O token de inicialização é composto por 32 bytes aleatórios, codificados em hexadecimal como 64 caracteres, e as linhas de log secundárias que podem conter credenciais são editadas. Os logs são separados do stdout, que carrega o handshake de prontidão/erro. Os segredos nativos são acessados por meio de src-tauri/src/secrets.rs usando o chaveiro do sistema operacional.

No macOS, o shell registra o plugin Liquid Glass. A visualização na web segue a configuração do vidro e retrocede quando o efeito não está disponível. A configuração da App Store desativa a opção de API privada; a configuração regular permite isso. Estas são configurações de compilação separadas.

Limites de segurança e persistência

A política de conteúdo de produção permite ativos locais, conexões de API de loopback, imagens de dados/blob e avaliação de WebAssembly. Não permite execução remota arbitrária de scripts. As permissões nativas têm escopo em src-tauri/capabilities; a política de desenvolvimento também permite o Vite e seu websocket.

open_path canoniza caminhos, limita-os a diretórios de usuários/aplicativos permitidos e rejeita extensões executáveis, como .exe, .app, .sh, .bat, .msi, e .jar. .. segmentos e links simbólicos não podem escapar das pastas permitidas porque ambos os lados são canônicos. A seleção e o salvamento de arquivos usam diálogos e validação nativos. Um token de inicialização concede acesso à API do aplicativo local; trate-o separadamente de um token complementar ou de um token de ponte de IA no escopo do projeto.

As configurações da UI, o estado da consulta da API, os comandos do editor, as versões do projeto armazenadas e os segredos nativos têm proprietários diferentes. Diagnostique cada um por meio de seu serviço real, em vez de assumir que todo o estado do aplicativo está armazenado no SQLite.

Integração de recursos

Os módulos de recursos CAD e CAM compõem componentes de viewport reutilizáveis com seus próprios painéis, armazenamentos e fluxos de salvamento. O painel do assistente recebe o contexto do projeto e do editor e transmite eventos da ferramenta por meio do estado do recurso de IA. As telas de recursos usam o cliente API em vez de acessar diretamente o banco de dados.

Para uma alteração na interface do usuário, siga o adaptador de rota até sua tela de recursos e, em seguida, inspecione o feature store ou gancho que envia a solicitação. Reutilize componentes compartilhados somente quando o contrato existente corresponder à interação. Mantenha a geometria pura no pacote principal e o comportamento nativo do sistema operacional no shell Rust.

Carregamento de rota e erros

Cada rota usa o limite de importação lenta do Solid. A tabela inclui uma página abrangente, /500, /offlinee rotas legais. Uma navegação direta do navegador deve ser servida por meio do servidor de desenvolvimento Vite ou do webview empacotado para que o roteador do cliente possa resolver a URL.

A API de visualização implementa um conjunto limitado de coleções e pode injetar deliberadamente falhas de solicitação em testes. Uma renderização de visualização bem-sucedida demonstra o comportamento da UI em relação a esses equipamentos; verifique persistência, permissões, streaming e integrações externas com o sidecar ao vivo.

Interface de comando nativa

Eventos nativos

A casca emite sidecar-status para mudanças no ciclo de vida, open-file com caminhos suportados, menu para seleção de menu e update://status para o progresso do atualizador. As seleções de projetos recentes da bandeja são representadas por tray.recent.<projectId> identificadores de menu. Os módulos de menu e bandeja do shell definem seus conjuntos completos de identificadores.

Os ouvintes devem ter como escopo o ciclo de vida de seu componente ou aplicativo e ser removidos na limpeza. O webview deve resolver novamente o endpoint após a reinicialização do sidecar, em vez de continuar a usar a porta anterior.

Desenvolvimento e verificação

bun run --filter @cadcamfun/desktop dev
bun run desktop:dev
bun run --filter @cadcamfun/desktop typecheck
bun test apps/desktop/src
bun run build:desktop

O primeiro comando executa uma visualização do navegador. desktop:dev compila o sidecar real e prepara as migrações antes de iniciar o Tauri. O pacote desktop tauri:dev em vez disso, o script cria um binário stub somente quando não existe nenhum binário; use-o para trabalho de shell isolado e verifique qual binário está presente antes de interpretar suas respostas de API.

A área de trabalho build script é executado vite build apenas; ele não compila o sidecar nem empacota um pacote Tauri. Usar bun scripts/build.ts para o pipeline de lançamento completo (consulte Liberar).

Preferências e configurações

O armazenamento de configurações compartilhadas mantém um registro validado em cadcamfun.settings no armazenamento local do webview. Campos ausentes, inválidos ou ilegíveis retornam de forma independente. Uma área de armazenamento cheia ou bloqueada não interrompe a edição, mas as alterações de preferência podem não persistir. As preferências de visualização do navegador pertencem à origem do navegador e são separadas das preferências nativas de visualização da web.

A tela Configurações possui guias Perfil, Conta, Segurança, Assinatura, Notificações, IA, Dispositivos e Idioma. A guia Dispositivos incorpora o painel de gateway complementar. As configurações de idioma incluem a alternância do vidro. O armazenamento de localidade comum valida atualmente a localidade padrão; não inferir cobertura de tradução adicional a partir de uma lista de rótulos de exibição.

Salve e reabra um programa CAM

1. Gere ou carregue o código NC no CAM e abra a caixa de diálogo salvar/exportar a partir do ponto de entrada existente.
2. Para uma exportação de arquivo, escolha o código G ou o formato de percurso portátil. O código G baixa o texto NC atual; a escolha do percurso grava um texto estruturado .cam.json instantâneo.
3. Para persistência do aplicativo, escolha um projeto existente, um novo projeto ou atualize o programa já salvo. Forneça o nome do programa e os campos de destino obrigatórios.
4. Ao atualizar, o fluxo de salvamento registra o programa completo anterior como uma versão do percurso antes de substituir os dados atuais.
5. Abra o item salvo em sua rota detalhada do percurso para inspecionar ou restaurar versões.

O resumo salvo inclui linhas NC, bytes, movimentos, identificadores de ferramentas, nomes de operações, estoque, unidades, deslocamento de trabalho e identidade de verificação quando essa evidência pertence ao NC atual. Um texto NC modificado pode tornar obsoletas as evidências previamente computadas. Revise a relação código/evidência atual antes de confiar no resumo.

Se a criação de um novo projeto for bem-sucedida, mas uma etapa de salvamento posterior falhar, o modal retém o destino criado para novas tentativas e inclui seu identificador no erro. Tentar novamente nesse modal evita criar o mesmo projeto novamente. Não presuma que o fluxo de salvamento é uma transação atômica entre recursos.

Diagnóstico de teclado e falhas

Cmd/Ctrl+K abre a paleta de comandos e Cmd/Ctrl+J alterna o painel do assistente. Os atalhos do shell são ignorados quando o foco está em um elemento de entrada, área de texto, seleção ou conteúdo editável. As telas do editor têm seu próprio controle de teclado. Vários retornos de chamada de comando shell, incluindo Salvar/Exportar na tabela de atalhos genérica, são espaços reservados; use os controles reais de salvar/exportar do recurso em vez de assumir que cada acelerador listado executa uma operação de documento.

Âncoras de implementação: shared/state/settings.ts, app/shortcuts.ts, features/settings/screens/settings.tsx, e features/cam/components/SaveCamModal.tsx.

Cargas úteis de eventos nativos

import { invoke } from "@tauri-apps/api/core"
import { listen } from "@tauri-apps/api/event"

const { baseUrl, token } = await invoke<{ baseUrl: string; token: string }>("get_sidecar_endpoint")

const path = await invoke<string | null>("pick_file", {
  filters: [{ name: "G-code", extensions: ["nc", "gcode"] }],
})                                    // null when the user cancels

await invoke("save_file", { defaultName: "part.nc", contents: gcodeText })

const unlisten = await listen<{ state: string; port?: number }>("sidecar-status", (e) => {
  if (e.payload.state === "ready") reconnect()
})
// later: unlisten()

try {
  await invoke("install_update", { unsavedWork: editorIsDirty })
} catch (error) {
  // { kind, message }: the update variant carries the refusal (unsavedWork | noneAvailable | failed)
}

get_sidecar_endpoint retorna { baseUrl, token } (serializado em camelCase de SidecarEndpoint). Erros de cada comando chegam como o valor rejeitado de invoke, em forma { kind, message }.

Atalhos de teclado

Cada rota de tela

O roteador em apps/desktop/src/app/routes.tsx declara 68 rotas, cada uma carregada lentamente de apps/desktop/src/pages/ (segmentos dinâmicos são _id_.tsx arquivos). Agrupados por primeiro segmento:

Em 3D