Merge pull request #316 from SheetMetalConnect/claude/audit-metals-messaging-neN3a

Audit website messaging for metals fabrication

Author: SheetMetalConnect

src/components/onboarding/MockDataImport.tsx

@@ -117,13 +117,13 @@ export function MockDataImport({ onComplete, onSkip }: MockDataImportProps) {
         <Wrench className="h-12 w-12 mx-auto text-primary" />
         <h2 className="text-3xl font-bold tracking-tight">Import Sample Data</h2>
         <p className="text-muted-foreground text-lg">
-          Start exploring Eryxon MES with realistic metal fabrication shop data
+          Start exploring Eryxon MES with realistic custom metals fabrication data
         </p>
       </div>
 
       <Alert>
         <AlertDescription>
-          We'll create sample jobs, parts, and operations that represent a typical sheet metal
+          We'll create sample jobs, parts, and operations that represent a typical custom metals
           fabrication workflow. This helps you understand how Eryxon organizes and tracks
           manufacturing work.
         </AlertDescription>

src/i18n/locales/en/auth.json

@@ -74,8 +74,8 @@
     "cancelAnytime": "Cancel anytime",
     "moneyBackGuarantee": "30-day money-back guarantee",
     "sampleData": "Import Sample Data",
-    "sampleDataDescription": "Start exploring Eryxon MES with realistic metal fabrication shop data",
-    "sampleDataExplanation": "We'll create sample jobs, parts, and operations that represent a typical sheet metal fabrication workflow.",
+    "sampleDataDescription": "Start exploring Eryxon MES with realistic custom metals fabrication data",
+    "sampleDataExplanation": "We'll create sample jobs, parts, and operations that represent a typical custom metals fabrication workflow.",
     "planSelection": {
       "title": "Choose Your Plan",
       "comingSoon": "Pricing plans are being finalized",

src/i18n/locales/en/integrations.json

@@ -174,7 +174,7 @@
   },
   "apiDocsPage": {
     "title": "Eryxon Flow API",
-    "description": "Production workflow management API for sheet metal manufacturing. Build integrations, automate workflows, and manage your production data programmatically.",
+    "description": "Production workflow management API for custom metals fabrication. Build integrations, automate workflows, and manage your production data programmatically.",
     "version": "v1.0.0",
     "restApi": "REST API",
     "restApiDesc": "JSON-based RESTful API",

src/i18n/locales/en/translation.json

@@ -391,8 +391,8 @@
     "cancelAnytime": "Cancel anytime",
     "moneyBackGuarantee": "30-day money-back guarantee",
     "sampleData": "Import Sample Data",
-    "sampleDataDescription": "Start exploring Eryxon MES with realistic metal fabrication shop data",
-    "sampleDataExplanation": "We'll create sample jobs, parts, and operations that represent a typical sheet metal fabrication workflow.",
+    "sampleDataDescription": "Start exploring Eryxon MES with realistic custom metals fabrication data",
+    "sampleDataExplanation": "We'll create sample jobs, parts, and operations that represent a typical custom metals fabrication workflow.",
     "planSelection": {
       "title": "Choose Your Plan",
       "comingSoon": "Pricing plans are being finalized",
@@ -1216,7 +1216,7 @@
   },
   "apiDocsPage": {
     "title": "Eryxon Flow API",
-    "description": "Production workflow management API for sheet metal manufacturing. Build integrations, automate workflows, and manage your production data programmatically.",
+    "description": "Production workflow management API for custom metals fabrication. Build integrations, automate workflows, and manage your production data programmatically.",
     "version": "v1.0.0",
     "restApi": "REST API",
     "restApiDesc": "JSON-based RESTful API",

src/pages/common/ApiDocs.tsx

@@ -298,8 +298,9 @@ apiClient.post('/api-jobs', jobData)
                   Eryxon Flow API
                 </CardTitle>
                 <CardDescription className="text-base">
-                  Production workflow management API for sheet metal manufacturing.
+                  Production workflow management API for custom metals fabrication.
                   Build integrations, automate workflows, and manage your production data programmatically.
+                  See <a href="https://eryxon.eu/api/api_documentation/" target="_blank" rel="noopener noreferrer" className="text-primary hover:underline">full API documentation</a>.
                 </CardDescription>
               </div>
               <Badge variant="secondary" className="text-sm">

website/src/content/docs/architecture/app-architecture.md

@@ -3,7 +3,7 @@ title: "App Architecture"
 description: "Technical architecture overview of Eryxon Flow"
 ---
 
-MES for sheet metal fabrication. Tracks work through three levels: **Jobs** (customer orders) → **Parts** (components) → **Operations** (tasks like cutting, bending, welding).
+MES for custom metals fabrication—sheet metal, structural steel, precision machining. Tracks work through three levels: **Jobs** (customer orders) → **Parts** (components) → **Operations** (tasks like cutting, bending, welding, machining).
 
 ---
 

website/src/content/docs/index.mdx

@@ -1,11 +1,11 @@
 ---
 title: Eryxon Flow - Open Source MES
-description: Manufacturing Execution System for Job Shops. Self-hostable, API-first, and built for the shop floor.
+description: Manufacturing Execution System for custom metals fabrication. Self-hostable, API-first, and built for the shop floor.
 template: splash
 hero:
   title: |
-    MES for <span class="text-primary">Job Shops</span>
-  tagline: Open source production tracking for custom manufacturing. Real-time operator terminals, capacity planning, and ERP integration.
+    MES for <span class="text-primary">Metals Fabrication</span>
+  tagline: Open source production tracking for custom metals shops—high, mid, and low volume. Real-time operator terminals, QRM capacity planning, and ERP integration via unified namespace.
   actions:
     - text: Try Demo
       link: https://app.eryxon.eu
@@ -40,8 +40,8 @@ import LinkButton from "~/components/LinkButton.astro";
   <Card title="Self-Hostable" icon="seti:lock" iconColor="#4a9eff">
     Keep your production data private. Run on your own server. BSL 1.1 License (Free for internal use).
   </Card>
-  <Card title="ERP Integration" icon="seti:db" iconColor="#4a9eff">
-    Sync jobs and parts from your ERP via REST API. No double entry.
+  <Card title="ERP & Unified Namespace" icon="seti:db" iconColor="#4a9eff">
+    Sync jobs and parts from your ERP via REST API. Publish events to MQTT with ISA-95 unified namespace. No double entry.
   </Card>
   <Card title="Paperless Shop" icon="seti:image" iconColor="#4a9eff">
     Attach drawings, 3D files (STEP), and work instructions directly to the job.
@@ -81,8 +81,8 @@ import LinkButton from "~/components/LinkButton.astro";
 
 <Section title="Why <span class='text-primary'>Eryxon Flow?</span>">
 <Grid columns={2}>
-<Card title="For Job Shops" icon="seti:home" iconColor="#4a9eff">
-  High mix, low volume. Handling thousands of unique parts? We built Eryxon for that.
+<Card title="For Custom Metals" icon="seti:home" iconColor="#4a9eff">
+  Built for custom metals fabrication—sheet metal, structural steel, precision machining. High, mid, or low volume. Also works for job shops in construction, furniture, and other custom manufacturing.
 </Card>
 <Card title="Developer Friendly" icon="seti:code" iconColor="#4a9eff">
   API-first design. Extend functionality, build custom integrations, and own your data.

website/src/content/docs/introduction.md

@@ -1,17 +1,41 @@
 ---
 title: Welcome to Eryxon MES
-description: The simple, elegant and powerful manufacturing execution system that your people will love to use. Made for metals fabrication.
+description: The simple, elegant and powerful manufacturing execution system that your people will love to use. Made for custom metals fabrication—sheet metal, structural steel, precision machining.
 ---
 
 :::note[Early Access]
 Heads up – this is an early version. Free during early access, but expect some bugs or downtime. [Try the demo](https://app.eryxon.eu) or see the [Hosted Version](/hosted-version) page for details.
 :::
 
-**The simple, elegant and powerful manufacturing execution system that your people will love to use. Made for metals fabrication.**
+**The simple, elegant and powerful manufacturing execution system that your people will love to use. Made for custom metals fabrication.**
+
+### Who It's For
+
+**Primary:** Custom metals fabrication shops—sheet metal, structural steel, precision machining—handling high, mid, or low volume production.
+
+**Also useful for:** Other job shops and custom manufacturing companies in construction, furniture, woodworking, and similar industries.
+
+---
+
+## What is MES?
+
+A **Manufacturing Execution System (MES)** bridges the gap between your ERP (business system) and the shop floor. While your ERP manages orders, customers, and invoices, MES tracks *how work actually gets done*—who's working on what, where parts are in production, and whether you're on schedule.
+
+### Our Philosophy
+
+**Go paperless.** Leave paper travelers behind. Instead of printing job packets that get lost, damaged, or outdated the moment something changes, give operators a tablet with live information—drawings, 3D models, instructions, and status—all in one place.
+
+**Collect data.** Every start, stop, and completion is recorded. Know how long operations actually take. Identify bottlenecks. Build a foundation for continuous improvement.
+
+**Improve communication.** When an operator reports an issue, everyone sees it immediately. When a priority changes, everyone knows. No more walking the floor to find out what's happening—real-time visibility across all screens.
+
+**Integrate with your systems.** Eryxon connects to your ERP via REST API and publishes events to a unified namespace (MQTT/ISA-95). Your data flows where it needs to go—no islands, no double entry.
+
+---
 
 ## What It Does
 
-Eryxon tracks jobs, parts, and tasks through production with a mobile and tablet-first interface. Data comes from your ERP via API.
+Eryxon tracks jobs, parts, and tasks through production with a mobile and tablet-first interface. Integrate with your ERP and publish events to a unified namespace (MQTT/ISA-95).
 
 ### For Operators
 The interface shows what to work on, grouped by materials and manufacturing stages—organized the way your shop runs, not the way accountants think. 
@@ -67,7 +91,7 @@ Track who's on-site and what they're working on in real-time. No guessing, no de
 
 ## Integration-First Architecture
 
-**100% API-driven.** Your ERP pushes jobs, parts, and tasks via REST API. Eryxon sends completion events back via webhooks. MCP server enables AI/automation integration.
+**100% API-driven.** Your ERP pushes jobs, parts, and tasks via REST API. Eryxon sends completion events back via webhooks and MQTT (ISA-95 unified namespace). MCP server enables AI/automation integration.
 
 ### File handling
 Request a signed upload URL from the API, upload STEP and PDF files directly to Supabase Storage, then reference the file path when creating jobs or parts. Large files (5-50MB typical) upload directly to storage—no timeouts, no API bottlenecks.

website/src/content/docs/nl/index.mdx

@@ -1,11 +1,11 @@
 ---
 title: Eryxon Flow - Open Source MES
-description: Manufacturing Execution System voor Job Shops. Self-hostable, API-first, en gebouwd voor de werkvloer.
+description: Manufacturing Execution System voor metaalbewerking op maat. Self-hostable, API-first, en gebouwd voor de werkvloer.
 template: splash
 hero:
   title: |
-    MES voor <span class="text-primary">Job Shops</span>
-  tagline: Open source productie-tracking voor maatwerkproductie. Real-time operator terminals, capaciteitsplanning en ERP-integratie.
+    MES voor <span class="text-primary">Metaalbewerking</span>
+  tagline: Open source productie-tracking voor metaalbedrijven op maat—hoog, midden en laag volume. Real-time operator terminals, QRM capaciteitsplanning en ERP-integratie via unified namespace.
   actions:
     - text: Aan de slag
       link: /nl/guides/quick-start/
@@ -36,8 +36,8 @@ import LinkButton from "~/components/LinkButton.astro";
   <Card title="Zelf te hosten" icon="seti:lock" iconColor="#4a9eff">
     Houd uw productiegegevens privé. Draai op uw eigen server. BSL 1.1 Licentie (Gratis voor intern gebruik).
   </Card>
-  <Card title="ERP-Integratie" icon="seti:db" iconColor="#4a9eff">
-    Synchroniseer orders en onderdelen uit uw ERP via de REST API. Geen dubbele invoer.
+  <Card title="ERP & Unified Namespace" icon="seti:db" iconColor="#4a9eff">
+    Synchroniseer orders en onderdelen uit uw ERP via de REST API. Publiceer events naar MQTT met ISA-95 unified namespace. Geen dubbele invoer.
   </Card>
   <Card title="Papierloze Werkplaats" icon="seti:image" iconColor="#4a9eff">
     Koppel tekeningen, 3D-bestanden (STEP) en werkinstructies direct aan de order.
@@ -77,8 +77,8 @@ import LinkButton from "~/components/LinkButton.astro";
 
 <Section title="Waarom <span class='text-primary'>Eryxon Flow?</span>">
 <Grid columns={2}>
-<Card title="Voor Job Shops" icon="seti:home" iconColor="#4a9eff">
-  High mix, low volume. Beheert u duizenden unieke onderdelen? Daarvoor hebben we Eryxon gebouwd.
+<Card title="Voor Metaalbewerking" icon="seti:home" iconColor="#4a9eff">
+  Gebouwd voor metaalbewerking op maat—plaatwerk, staalconstructie, precisie-verspaning. Hoog, midden of laag volume. Ook geschikt voor job shops in de bouw, meubelindustrie en andere maatwerkproductie.
 </Card>
 <Card title="Ontwikkelaar Vriendelijk" icon="seti:code" iconColor="#4a9eff">
   API-first ontwerp. Breid functionaliteit uit, bouw eigen integraties en blijf eigenaar van uw data.

website/src/content/docs/nl/introduction.md

@@ -1,13 +1,37 @@
 ---
 title: Welkom bij Eryxon Flow
-description: Het eenvoudige, elegante en krachtige manufacturing execution system waar uw mensen graag mee zullen werken. Gemaakt voor de metaalbewerking.
+description: Het eenvoudige, elegante en krachtige manufacturing execution system waar uw mensen graag mee zullen werken. Gemaakt voor metaalbewerking op maat—plaatwerk, staalconstructie, precisie-verspaning.
 ---
 
-**Het eenvoudige, elegante en krachtige manufacturing execution system waar uw mensen graag mee zullen werken. Gemaakt voor de metaalbewerking.**
+**Het eenvoudige, elegante en krachtige manufacturing execution system waar uw mensen graag mee zullen werken. Gemaakt voor metaalbewerking op maat.**
+
+### Voor Wie Het Is
+
+**Primair:** Metaalbewerkingsbedrijven op maat—plaatwerk, staalconstructie, precisie-verspaning—voor hoog, midden of laag volume productie.
+
+**Ook geschikt voor:** Andere job shops en maatwerkproductiebedrijven in de bouw, meubelindustrie, houtbewerking en vergelijkbare sectoren.
+
+---
+
+## Wat is MES?
+
+Een **Manufacturing Execution System (MES)** overbrugt de kloof tussen uw ERP (bedrijfssysteem) en de werkvloer. Terwijl uw ERP orders, klanten en facturen beheert, houdt MES bij *hoe het werk daadwerkelijk wordt uitgevoerd*—wie waaraan werkt, waar onderdelen zich in de productie bevinden en of u op schema ligt.
+
+### Onze Filosofie
+
+**Ga papierloos.** Laat papieren werkbonnen achter. In plaats van werkpakketten te printen die zoekraken, beschadigd raken of verouderd zijn zodra er iets verandert, geef operators een tablet met actuele informatie—tekeningen, 3D-modellen, instructies en status—alles op één plek.
+
+**Verzamel data.** Elke start, stop en voltooiing wordt geregistreerd. Weet hoe lang bewerkingen werkelijk duren. Identificeer knelpunten. Bouw een fundament voor continue verbetering.
+
+**Verbeter communicatie.** Wanneer een operator een probleem meldt, ziet iedereen het direct. Wanneer een prioriteit wijzigt, weet iedereen het. Niet meer de werkvloer op om te ontdekken wat er gebeurt—real-time zichtbaarheid op alle schermen.
+
+**Integreer met uw systemen.** Eryxon verbindt met uw ERP via REST API en publiceert events naar een unified namespace (MQTT/ISA-95). Uw data stroomt waar nodig—geen eilandjes, geen dubbele invoer.
+
+---
 
 ## Wat Het Doet
 
-Eryxon volgt orders, onderdelen en taken door de productie met een mobiele en tablet-vriendelijke interface. Gegevens komen via een API uit uw ERP.
+Eryxon volgt orders, onderdelen en taken door de productie met een mobiele en tablet-vriendelijke interface. Integreer met uw ERP en publiceer events naar een unified namespace (MQTT/ISA-95).
 
 ### Voor Operators
 De interface toont waaraan gewerkt moet worden, gegroepeerd op materialen en productiestadia—georganiseerd zoals uw werkplaats draait, niet zoals accountants denken. 
@@ -63,7 +87,7 @@ Volg in realtime wie er aanwezig is en waaraan zij werken. Geen gegis, geen vert
 
 ## Integratie-Eerste Architectuur
 
-**100% API-gedreven.** Uw ERP stuurt orders, onderdelen en taken via de REST API. Eryxon stuurt voltooiingsgebeurtenissen terug via webhooks. MCP-server maakt AI/automatisering-integratie mogelijk.
+**100% API-gedreven.** Uw ERP stuurt orders, onderdelen en taken via de REST API. Eryxon stuurt voltooiingsgebeurtenissen terug via webhooks en MQTT (ISA-95 unified namespace). MCP-server maakt AI/automatisering-integratie mogelijk.
 
 ### Bestandsafhandeling
 Vraag een ondertekende upload-URL aan via de API, upload STEP- en PDF-bestanden rechtstreeks naar Supabase Storage en verwijs vervolgens naar het bestandspad bij het maken van orders of onderdelen. Grote bestanden (typisch 5-50MB) worden rechtstreeks naar de storage geüpload—geen timeouts, geen API-knelpunten.