Anleitungen und Arbeitsabläufe

Wählen Sie einen Führer

• Schnellstart: abhängigkeiten installieren, den Desktop starten und seine Datenbank suchen.
• Installieren: laden Sie einen veröffentlichten Desktop-Build herunter, überprüfen Sie seine Prüfsumme und unterscheiden Sie ihn von einem Quell-Checkout.
• Konten: profil, Passwort, API-Schlüssel und Git-Identität im lokalen Studio bearbeiten.
• Lokale Entwicklung: führen Sie eine Browservorschau oder einen echten Sidecar aus, konfigurieren Sie Prozesse und diagnostizieren Sie den Start.
• Mitwirkender Code: module suchen, gemeinsame Verträge ändern und Schecks auswählen.
• Pakete: navigieren Sie durch Arbeitsbereichsverantwortlichkeiten und öffentliche Einstiegspunkte.

Der Desktop, Sidecar, Companion und die Dokumentationsseite verfügen über unterschiedliche Startbefehle und Persistenzmodelle. Wählen Sie die Laufzeit aus, die das von Ihnen geänderte Verhalten ausübt. Für die Bildschirmarbeit ist eine Browser-Fixierung hilfreich; Datenbank-, Streaming- und Autorisierungsänderungen erfordern den echten Server.

Verstehen Sie die Laufzeit

Das Kernpaket implementiert Geometrie, Werkzeugwege, Pfosten und Überprüfung. Das API-Paket definiert gemeinsame Schemata, Endpunkte und generierte Clients. Der Sidecar kombiniert diese Verträge mit Repositorys, SQLite, KI, Plugins, Versionskontrolle und Workflow-Diensten. Der Desktop stellt diese Dienste über eine lokale API-Verbindung und eine native Shell bereit.

Der iOS-Begleiter stellt eine Verbindung über ein separates angeheftetes HTTPS-Gateway her. Das Webpaket führt die Astro-Dokumentationsseite und die lokale Studio-Integration aus. Dabei handelt es sich um separate Clients und es darf nicht davon ausgegangen werden, dass sie einen gemeinsamen Datenbankpfad oder Sicherheitskontext haben.

Allgemeine Befehle

bun install
bun run desktop:dev
bun run --filter @cadcamfun/desktop dev
bun run --cwd packages/web start

desktop:dev baut den echten Sidecar und führt Migrationen durch, bevor Tauri eröffnet wird. Der Desktop dev skript startet Vite auf Port 1420; Ohne Sidecar-URL wird eine In-Memory-Vorschau-API verwendet. Das Web start skript startet nur Astro; es ist dev das Skript startet auch die lokale Studio-API.

Die Migrationsgenerierung dient Schemaänderungen und ist keine Installationsvoraussetzung. Die Datenbankschicht erstellt eine neue Datenbank und wendet beim Öffnen verfügbare Migrationen an. Lesen Sie die Schnellstartanleitung, bevor Sie einen CLI-Datenbankpfad auswählen.

Root-Skripte werden im Repository definiert package.json: typecheck, test, build, build:sidecar, build:desktop, desktop:dev, generate, generate:check, db:generate, und db:migrate.

Beginnen Sie mit einem Betonfluss

Öffnen Sie für die Desktop-Entwicklung ein Projekt, erstellen oder laden Sie eine Zeichnung und überprüfen Sie den CAD/CAM-Ablauf, den Sie ändern möchten. Folgen Sie seinem Routenadapter in den Funktionsbildschirm und suchen Sie den API-Aufruf und -Handler. Verwenden Sie für Serverarbeiten das Schema, den Handler, den Dienst und die Repository-Kette, um zu identifizieren, wo Validierung, Besitz und Persistenz stattfinden.

Installieren Sie für begleitende Arbeiten einen nativen iOS-Build, aktivieren Sie das Desktop-Gateway und koppeln Sie es über seinen QR-Code. Starten Sie für Dokumentationsarbeiten Astro, öffnen Sie die geänderte Route und führen Sie den Web-Build aus, um Vorlagen- und Prerender-Fehler abzufangen.

Behalten Sie klare Grenzen bei

Halten Sie Anmeldeinformationen von Quellen, Beispielen, Protokollen und Browser-Screenshots fern. Verwenden Sie Platzhalter in der Dokumentation und stellen Sie die Laufzeitkonfiguration über die unterstützten Prozess- oder Anwendungseinstellungen bereit. Halten Sie generierte Clients mit ihrem Vertrag synchronisiert und generieren Sie SQL-Migrationen aus dem Schema, anstatt generierte Migrationsdateien zu bearbeiten.

Verwenden Sie ein separates verfügbares Datenverzeichnis für Integrationstests und lokale Experimente. Ein Vorschau-Fixture, eine CLI-Migrationsdatenbank, eine gepackte Anwendungsdatenbank und ein Companion-Gateway haben unterschiedliche Zwecke; Die Auswahl sollte explizit sein.

Finden Sie den richtigen Workflow

Verwenden Sie einen Leitfaden für eine Abfolge von Aktionen und die verknüpften Referenzseiten für Feld- und Verhaltensdetails. Halten Sie die Laufzeitauswahl während des gesamten Workflows explizit: Der Wechsel von einem Browser-Fixture zu einem nativen Sidecar ändert Persistenz, Anmeldeinformationen, native Funktionen und Fehlerverhalten.

Wissen Sie, was eine Prüfung ergibt

Verschiedene Checks beantworten unterschiedliche Fragen. Ein TypeScript-Compiler kann nachweisen, dass ein Client-Aufruf mit seiner generierten Signatur übereinstimmt. Ein Handler-Test kann die erwartete Reaktion unter den bereitgestellten Schichten nachweisen. Ein nativer Simulatorlauf kann das Anheften von Zertifikaten und den App-Start durchführen. Keines davon beweist unabhängig voneinander, dass ein signiertes Installationsprogramm auf jedem unterstützten Gerät ausgeführt wird oder dass ein Werkzeugweg für eine bestimmte Maschine sicher ist.

1. Notieren Sie die genaue Laufzeit und das Datenverzeichnis, die für die Prüfung verwendet wurden.
2. Führen Sie den Vorgang über die Grenze aus, die der Benutzer verwenden wird.
3. Untersuchen Sie den resultierenden persistenten Zustand oder das exportierte Artefakt, nicht nur einen Erfolgs-Toast.
4. Üben Sie den von der Änderung betroffenen Fehler- oder Abbruchpfad aus.
5. Melden Sie alle noch fehlenden externen Dienste, Signaturen, nativen Geräte oder Grafikabdeckungen.

Verwenden Sie für deterministische Integrationsarbeiten isolierte SQLite-Verzeichnisse und Skript-/Offline-KI-Fixtures. Für anbieterspezifisches Verhalten üben Sie den konfigurierten Anbieter separat mit den entsprechenden Anmeldeinformationen aus. Beispielanfragen in diesen Leitfäden beschreiben unterstützte Formen; Zeitstempel, Kennungen, Ports und Anmeldeinformationen variieren je nach Ausführung.

Praktische Leitfäden

Diese Leitfäden verfolgen den gesamten Betrieb durch die Anwendung und ihre API. Jeder enthält die erforderlichen Eingaben, die relevanten Zustandsänderungen und die zu prüfenden Fehlerfälle. Verwenden Sie die Subsystemreferenzen für zugrunde liegende Modelle und die API-Ressourcenseiten für genaue Feld- und Antwortverträge.

Design und Herstellung

Clients und Erweiterungen

Operationen und Wiederherstellung

Neu in einem veröffentlichten Build? Beginnen Sie bei Installieren. Neu an der Kasse? Beginnen Sie mit Schnellstart. Neu im HTTP-Verhalten? Benutzen Sie die komplettlösung mit erfassten Antworten, und wählen Sie dann einen eingegebenen Client oder eine Ressource aus vollständige API-Referenz.

Arbeiten Sie eine vollständige Aufgabe ab

Erstellen Sie ein gespeichertes Design

Erstellen Sie ein Projekt und behalten Sie die zurückgegebene Kennung bei. Erstellen Sie die Zeichnung oder Komponente über die entsprechende projektbezogene Sammlung. Bearbeiten Sie die Geometrie im CAD-Arbeitsbereich, speichern Sie sie über die tatsächliche Feature-Aktion dieser Ressource und öffnen Sie die gespeicherte Ressource erneut, um sicherzustellen, dass das beabsichtigte Dokument beibehalten wurde. Der aktuelle Auswahl- und Befehlsverlauf des Editors ist kein Ersatz für die gespeicherte Zeichnung.

Wenn zwei Clients dieselben Daten bearbeiten, befolgen Sie die aktuelle Aktualisierungssemantik des Endpunkts, anstatt davon auszugehen, dass jede Ressource über einen Vergleichs- und Austauschschutz verfügt. Lesen Sie die leitfaden zum Projektlebenszyklus für Zeichnungs-/Komponentenunterschiede, Ressourcenzuordnungen, Zugriffsprüfungen und Wiederherstellungsgrenzen.

Erzeugen Sie ein Fertigungsergebnis

Erfassen Sie Geometrie, Platzierung, Lagerbestand, Material, Maschine, Werkzeuge und Arbeitsreihenfolge. Führen Sie die Generierung mit diesen expliziten Eingaben aus. Überprüfen Sie die Probleme des Ergebnisses und die anwendbaren Beweise. Überprüfen Sie, ob Programm und NC dem beabsichtigten Snapshot entsprechen. Das Speichern ist ein separater Vorgang und muss ein tragbares Dokument beibehalten, das mit den genauen zu speichernden Bytes übereinstimmt.

Ein geänderter Fräser, Rohling, Modell oder Arbeitsrahmen ändert den zu bewertenden Auftrag. Die Wiederverwendung eines früheren Artefakts nach der Bearbeitung von NC überträgt seine Beweise nicht auf den neuen Text. Der anleitung zur nativen Herstellung erklärt Vorbereitung, Generierung, Ansprüche, Persistenzvalidierung und den Unterschied zwischen einem integrierten veröffentlichten Programm und verketteten Operationsabschnitten.

Integrieren Sie einen Assistenten

Konfigurieren Sie einen Anbieter auf dem Desktop und überprüfen Sie seinen Status, bevor Sie ein Gespräch beginnen. Behalten Sie die Projekt- und Sitzungsidentität bei, nutzen Sie Ereignisse inkrementell und implementieren Sie Berechtigungen und Fragenantworten über die zugelassenen Sitzungssteuerelemente. Stellen Sie nach dem Trennen der Verbindung den aktuellen Status wieder her, bevor Sie eine Anfrage erneut senden, die möglicherweise das Projekt bearbeitet hat.

Der streaming-Guide deckt Genesung, Stornierung und Nachaufnahme ab. Der kundenleitfaden erklärt, warum Promise-Ergebniswerte, ausgelöste HTTP-Körper, Effektfehler und Stream-Vervollständigung nicht als ein universeller Umschlag behandelt werden können.

Zeichnen Sie eine Änderung auf und überprüfen Sie sie

Speichern Sie die Arbeitsressource, überprüfen Sie den Projektstatus und übernehmen Sie den beabsichtigten Status für den vorgesehenen Zweig. Überprüfen Sie den strukturellen Unterschied und öffnen Sie eine lokale Pull-Anfrage, wenn die Änderung vorgeschlagen und nicht direkt übernommen werden soll. Lösen Sie blockierende Überprüfungsurteile und Konflikte vor der Zusammenführung.

Versionieren Sie Workflow-Definitionen mit dem Projekt und überprüfen Sie dann die ausgewählten Commit- und individuellen Prüfausgaben jedes Laufs. Ein erfolgreicher Lauf, bei dem die Bearbeitungsprüfungen übersprungen wurden, liefert keinen Bearbeitungsnachweis. Lesen Sie die branchen- und Workflow-Leitfaden bevor Sie einen Schreibschritt automatisieren oder einen Remote-Spiegel konfigurieren.

Betreiben Sie einen zweiten Client

Aktivieren Sie das Begleit-Gateway absichtlich, erstellen Sie eine individuell benannte Gerätepaarung und verbinden Sie einen nativen Build, der Zertifikat-Pinning umfasst. Behalten Sie die vollständige Desktop-Adresse, den Fingerabdruck und das Geräte-Token als gekoppelte Verbindung bei. Lesen Sie die aktuelle Routenrichtlinie, bevor Sie davon ausgehen, dass ein Telefon schreibgeschützt oder nicht eingeschränkt ist.

Wenn der Zugriff beendet werden soll, entziehen Sie das Gerät vom Desktop; Durch das alleinige Entfernen der Verbindung auf dem Telefon wird das serverseitige Token nicht widerrufen. Der pairing-Anleitung trennt Netzwerkdiagnose, native Transportverfügbarkeit, Zertifikatidentität und Token-Sperrung.

Leitfäden nach Aufgabe und Zeit

In 3D