📝 doc improvements

Author: LuiseFreese

.gitignore

@@ -12,8 +12,12 @@ src/logs/
 dist/
 coverage/
 
-# Deployment data (contains personal/environment-specific information)
-data/
+# Data directory - environment-specific files
+data/environments.json
+data/deployments/
+
+# Keep the example file for reference
+!data/environments.example.json
 
 # Backup files
 *.backup

data/environments.example.json

@@ -0,0 +1,58 @@
+{
+    "version": "1.0.0",
+    "defaultEnvironmentId": "customer-dev",
+    "environments": [
+        {
+            "id": "customer-dev",
+            "name": "Customer Development",
+            "url": "https://contoso-dev.crm.dynamics.com",
+            "description": "Development environment for customer-facing solutions",
+            "color": "blue",
+            "lastConnected": null,
+            "metadata": {
+                "organizationName": "contoso-dev",
+                "organizationDisplayName": "Contoso Development",
+                "region": "North America"
+            }
+        },
+        {
+            "id": "integration-test",
+            "name": "Integration Testing",
+            "url": "https://contoso-integration.crm.dynamics.com",
+            "description": "Integration testing with external systems",
+            "color": "yellow",
+            "lastConnected": null,
+            "metadata": {
+                "organizationName": "contoso-integration",
+                "organizationDisplayName": "Contoso Integration Test",
+                "region": "North America"
+            }
+        },
+        {
+            "id": "partner-uat",
+            "name": "Partner UAT",
+            "url": "https://contoso-partneruat.crm.dynamics.com",
+            "description": "User acceptance testing with partner organizations",
+            "color": "green",
+            "lastConnected": null,
+            "metadata": {
+                "organizationName": "contoso-partneruat",
+                "organizationDisplayName": "Contoso Partner UAT",
+                "region": "North America"
+            }
+        },
+        {
+            "id": "production-main",
+            "name": "Production (Main)",
+            "url": "https://contoso.crm.dynamics.com",
+            "description": "Live production environment",
+            "color": "red",
+            "lastConnected": null,
+            "metadata": {
+                "organizationName": "contoso",
+                "organizationDisplayName": "Contoso Production",
+                "region": "North America"
+            }
+        }
+    ]
+}

docs/USAGE-GUIDE.md

@@ -161,38 +161,6 @@ The rollback system is **environment-aware**:
 - Each environment maintains its own deployment history
 - Rollback buttons only appear for eligible deployments in each environment
 
-### Multi-Environment Workflow Example
-
-**Typical deployment workflow:**
-
-1. **Development Phase**:
-   - Deploy ERD to Dev environment
-   - Test and iterate
-   - View Dev deployments: Filter by "Development" in history
-
-2. **Testing Phase**:
-   - Deploy same ERD to Test environment
-   - Perform validation
-   - View Test deployments: Filter by "Test" in history
-
-3. **Production Deployment**:
-   - Deploy verified ERD to Production
-   - Monitor in production
-   - View Prod deployments: Filter by "Production" in history
-
-4. **Rollback if Needed**:
-   - If issues found in Test, rollback Test deployment
-   - Dev and Production remain unaffected
-   - Fix issues and redeploy to Test
-
-### Best Practices
-
-- **Use Environment Filters**: Switch between environments to see environment-specific deployments
-- **Check Environment Before Rollback**: Always verify you're rolling back from the correct environment
-- **Monitor Progress**: Watch the progress tracker to ensure rollback completes successfully
-- **Review Dependencies**: Before rollback, check if other solutions depend on your entities
-- **Backup Data**: If your entities contain important data, export it before rollback
-
 ## Intelligent Validation & Auto-Corrections
 
 The React application includes sophisticated validation that provides real-time feedback and intelligent fixes:

docs/intro.md

@@ -13,6 +13,7 @@ The **Mermaid to Dataverse Converter** is a powerful tool that converts [Mermaid
 - **Global Choices**: Automatically manage and reuse global choice sets
 - **CDM Integration**: Seamlessly integrate with Common Data Model entities
 - **Solution Packaging**: Create complete Dataverse solutions ready for deployment
+- **Multi-Environment Support**: Deploy to multiple Dataverse environments (dev/test/prod) from a single deployment with dynamic environment selection
 - **Microsoft Entra Authentication**: Secure access with Microsoft identity
 - **Deployment History**: Track all your deployments with detailed logging
 - **Modular Rollback**: Selectively rollback components of your deployment
@@ -26,22 +27,24 @@ Get up and running in minutes:
 git clone https://github.com/LuiseFreese/mermaid.git
 cd mermaid
 
-# Install dependencies
-npm install
+# Install all dependencies (root + frontend)
+npm run install:all
 
-# Set up environment variables
-copy .env.example .env.local
+# Configure your Dataverse environments
+copy data\environments.example.json data\environments.json
+# Edit data/environments.json with your Dataverse environment URLs and IDs
 
-# Start the backend server
-npm start
+# Set up local environment variables (optional for local dev)
+copy .env.example .env.local
+# Edit .env.local with your credentials if testing real Dataverse connections
 
-# In a separate terminal, start the frontend
-cd src/frontend
-npm install
-npm start
+# Start both backend and frontend servers
+npm run dev
 ```
 
-The backend will be available at `http://localhost:8080` and the frontend wizard at `http://localhost:3003/wizard`.
+The backend will be available at `http://localhost:8080` and the frontend wizard at `http://localhost:3003`.
+
+> **Note**: Authentication is disabled by default in development mode (`AUTH_ENABLED=false`), so you can test the UI without Azure AD credentials. Configure `data/environments.json` to enable multi-environment features.
 
 ## Key Features
 

src/backend/data/environments.json

@@ -0,0 +1,19 @@
+{
+  "version": "1.0.0",
+  "defaultEnvironmentId": "default",
+  "environments": [
+    {
+      "id": "default",
+      "name": "Default Environment",
+      "url": "https://org4caa9250.crm4.dynamics.com",
+      "description": "Default environment from environment variables",
+      "color": "blue",
+      "metadata": {
+        "organizationName": "",
+        "organizationDisplayName": "",
+        "region": "Unknown"
+      },
+      "lastConnected": null
+    }
+  ]
+}

src/backend/src/backend/data/environments.json

@@ -0,0 +1,19 @@
+{
+  "version": "1.0.0",
+  "defaultEnvironmentId": "default",
+  "environments": [
+    {
+      "id": "default",
+      "name": "Default Environment",
+      "url": "https://org4caa9250.crm4.dynamics.com",
+      "description": "Default environment from environment variables",
+      "color": "blue",
+      "metadata": {
+        "organizationName": "",
+        "organizationDisplayName": "",
+        "region": "Unknown"
+      },
+      "lastConnected": null
+    }
+  ]
+}