@khester/create-dynamics-app 1.0.8 → 1.1.0

package/templates/dynamics-365-starter/deployment/scripts/team-onboarding.ps1

@@ -0,0 +1,486 @@
+# Team Onboarding Script with Platform Detection (PowerShell)
+# Automatically detects platform and guides developer through setup
+
+param(
+    [switch]$Interactive,
+    [switch]$SkipPrerequisites,
+    [switch]$Verbose
+)
+
+# Set error action preference
+$ErrorActionPreference = "Stop"
+
+# Script configuration
+$ScriptRoot = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ProjectRoot = Split-Path -Parent (Split-Path -Parent $ScriptRoot)
+
+function Show-Banner {
+    Write-Host "╔══════════════════════════════════════════════════════════════╗" -ForegroundColor Cyan
+    Write-Host "║            Dynamics 365 Team Onboarding Assistant           ║" -ForegroundColor Cyan
+    Write-Host "║                  Enterprise Consulting Edition              ║" -ForegroundColor Cyan
+    Write-Host "╚══════════════════════════════════════════════════════════════╝" -ForegroundColor Cyan
+    Write-Host ""
+}
+
+function Get-PlatformInfo {
+    $platform = [System.Environment]::OSVersion.Platform
+    $architecture = [System.Environment]::GetEnvironmentVariable("PROCESSOR_ARCHITECTURE")
+    $osVersion = [System.Environment]::OSVersion.Version
+    
+    return @{
+        Platform = "Windows"
+        Architecture = $architecture
+        Version = $osVersion.ToString()
+        PowerShellVersion = $PSVersionTable.PSVersion.ToString()
+    }
+}
+
+function Show-PlatformInfo {
+    param([hashtable]$PlatformInfo)
+    
+    Write-Host "🔍 Platform Detection:" -ForegroundColor Blue
+    Write-Host "   Platform: $($PlatformInfo.Platform)"
+    Write-Host "   Architecture: $($PlatformInfo.Architecture)"
+    Write-Host "   OS Version: $($PlatformInfo.Version)"
+    Write-Host "   PowerShell: $($PlatformInfo.PowerShellVersion)"
+    Write-Host ""
+    
+    Write-Host "✅ Windows detected - You can use PowerShell or Bash scripts" -ForegroundColor Green
+    Write-Host "   📖 PowerShell Guide: deployment/QUICKSTART-WINDOWS.md"
+    Write-Host "   📖 Bash Alternative: deployment/QUICKSTART-MAC.md"
+    Write-Host ""
+}
+
+function Test-Prerequisites {
+    Write-Host "🔧 Checking Prerequisites..." -ForegroundColor Blue
+    Write-Host ""
+    
+    $allGood = $true
+    $missingTools = @()
+    
+    # Check Node.js
+    try {
+        $nodeVersion = node --version 2>$null
+        Write-Host "   ✅ Node.js - $nodeVersion" -ForegroundColor Green
+    }
+    catch {
+        Write-Host "   ❌ Node.js - Not installed" -ForegroundColor Red
+        $missingTools += "Node.js"
+        $allGood = $false
+    }
+    
+    # Check npm
+    try {
+        $npmVersion = npm --version 2>$null
+        Write-Host "   ✅ npm - $npmVersion" -ForegroundColor Green
+    }
+    catch {
+        Write-Host "   ❌ npm - Not installed" -ForegroundColor Red
+        $missingTools += "npm"
+        $allGood = $false
+    }
+    
+    # Check Git
+    try {
+        $gitVersion = git --version 2>$null
+        Write-Host "   ✅ Git - $gitVersion" -ForegroundColor Green
+    }
+    catch {
+        Write-Host "   ❌ Git - Not installed" -ForegroundColor Red
+        $missingTools += "Git"
+        $allGood = $false
+    }
+    
+    # Check PowerShell modules
+    $requiredModules = @(
+        "Microsoft.PowerApps.Administration.PowerShell",
+        "Microsoft.PowerApps.PowerShell"
+    )
+    
+    foreach ($module in $requiredModules) {
+        if (Get-Module -Name $module -ListAvailable -ErrorAction SilentlyContinue) {
+            Write-Host "   ✅ $module - Installed" -ForegroundColor Green
+        }
+        else {
+            Write-Host "   ❌ $module - Not installed" -ForegroundColor Red
+            $missingTools += $module
+            $allGood = $false
+        }
+    }
+    
+    # Check optional tools
+    try {
+        $jqVersion = jq --version 2>$null
+        Write-Host "   ✅ jq - $jqVersion" -ForegroundColor Green
+    }
+    catch {
+        Write-Host "   ⚠️  jq - Not installed (optional)" -ForegroundColor Yellow
+    }
+    
+    Write-Host ""
+    
+    if ($allGood) {
+        Write-Host "🎉 All prerequisites are installed!" -ForegroundColor Green
+        return $true
+    }
+    else {
+        Write-Host "❌ Missing tools detected" -ForegroundColor Red
+        Show-InstallationInstructions -MissingTools $missingTools
+        return $false
+    }
+}
+
+function Show-InstallationInstructions {
+    param([array]$MissingTools)
+    
+    Write-Host "📦 Installation Instructions:" -ForegroundColor Yellow
+    Write-Host ""
+    
+    Write-Host "Install missing tools using Chocolatey (recommended):" -ForegroundColor White
+    Write-Host ""
+    
+    if ($MissingTools -contains "Node.js" -or $MissingTools -contains "npm") {
+        Write-Host "   choco install nodejs" -ForegroundColor Cyan
+    }
+    
+    if ($MissingTools -contains "Git") {
+        Write-Host "   choco install git" -ForegroundColor Cyan
+    }
+    
+    if ($MissingTools -contains "jq") {
+        Write-Host "   choco install jq" -ForegroundColor Cyan
+    }
+    
+    foreach ($module in $MissingTools | Where-Object { $_ -like "Microsoft.PowerApps*" }) {
+        Write-Host "   Install-Module -Name $module -Force" -ForegroundColor Cyan
+    }
+    
+    Write-Host ""
+    Write-Host "If Chocolatey is not installed:" -ForegroundColor White
+    Write-Host "   Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))" -ForegroundColor Cyan
+    Write-Host ""
+    Write-Host "Alternative manual installations:" -ForegroundColor White
+    Write-Host "   Node.js: https://nodejs.org/"
+    Write-Host "   Git: https://git-scm.com/"
+    Write-Host ""
+}
+
+function Test-ProjectSetup {
+    Write-Host "📁 Checking Project Setup..." -ForegroundColor Blue
+    Write-Host ""
+    
+    # Check if we're in a project directory
+    $packageJsonPath = Join-Path $ProjectRoot "package.json"
+    if (-not (Test-Path $packageJsonPath)) {
+        Write-Host "❌ Not in a Dynamics 365 project directory" -ForegroundColor Red
+        Write-Host "   Please navigate to your project root directory"
+        return $false
+    }
+    
+    Write-Host "✅ Project directory detected" -ForegroundColor Green
+    
+    # Check package.json
+    if (Test-Path $packageJsonPath) {
+        Write-Host "✅ package.json found" -ForegroundColor Green
+    }
+    else {
+        Write-Host "❌ package.json not found" -ForegroundColor Red
+        return $false
+    }
+    
+    # Check node_modules
+    $nodeModulesPath = Join-Path $ProjectRoot "node_modules"
+    if (Test-Path $nodeModulesPath) {
+        Write-Host "✅ node_modules exists" -ForegroundColor Green
+    }
+    else {
+        Write-Host "⚠️  node_modules not found - run 'npm install'" -ForegroundColor Yellow
+    }
+    
+    # Check deployment scripts
+    $bashScriptPath = Join-Path $ProjectRoot "deployment\scripts\deploy.sh"
+    $psScriptPath = Join-Path $ProjectRoot "deployment\scripts\deploy.ps1"
+    
+    if (Test-Path $psScriptPath) {
+        Write-Host "✅ PowerShell deployment script found" -ForegroundColor Green
+    }
+    else {
+        Write-Host "❌ PowerShell deployment script missing" -ForegroundColor Red
+    }
+    
+    if (Test-Path $bashScriptPath) {
+        Write-Host "✅ Bash deployment script found" -ForegroundColor Green
+    }
+    else {
+        Write-Host "⚠️  Bash deployment script missing" -ForegroundColor Yellow
+    }
+    
+    # Check configuration directory
+    $configPath = Join-Path $ProjectRoot "config\environments"
+    if (Test-Path $configPath) {
+        Write-Host "✅ Environment configuration directory found" -ForegroundColor Green
+        
+        # List available environments
+        $envFiles = Get-ChildItem -Path $configPath -Filter "*.json" | ForEach-Object { $_.BaseName }
+        if ($envFiles.Count -gt 0) {
+            Write-Host "   Available environments: $($envFiles -join ', ')"
+        }
+        else {
+            Write-Host "   ⚠️  No environment configurations found" -ForegroundColor Yellow
+        }
+    }
+    else {
+        Write-Host "❌ Environment configuration directory missing" -ForegroundColor Red
+    }
+    
+    Write-Host ""
+    return $true
+}
+
+function Initialize-DeveloperEnvironment {
+    Write-Host "⚙️  Setting up developer environment..." -ForegroundColor Blue
+    Write-Host ""
+    
+    # Install npm dependencies if needed
+    $nodeModulesPath = Join-Path $ProjectRoot "node_modules"
+    if (-not (Test-Path $nodeModulesPath)) {
+        Write-Host "Installing npm dependencies..."
+        Push-Location $ProjectRoot
+        try {
+            npm install
+            Write-Host "✅ Dependencies installed" -ForegroundColor Green
+        }
+        catch {
+            Write-Host "❌ Failed to install dependencies: $_" -ForegroundColor Red
+        }
+        finally {
+            Pop-Location
+        }
+    }
+    
+    # Create .env.local template if it doesn't exist
+    $envLocalPath = Join-Path $ProjectRoot ".env.local"
+    if (-not (Test-Path $envLocalPath)) {
+        Write-Host "Creating .env.local template..."
+        
+        $envContent = @"
+# Local environment variables (not committed to git)
+# Add your personal configuration here
+
+# Development environment
+D365_ENVIRONMENT=dev
+D365_CLIENT_ID=your-client-id-here
+D365_CLIENT_SECRET=your-client-secret-here
+
+# Optional: Custom settings
+NODE_ENV=development
+DEBUG=true
+"@
+        
+        Set-Content -Path $envLocalPath -Value $envContent -Encoding UTF8
+        Write-Host "✅ .env.local template created" -ForegroundColor Green
+        Write-Host "   📝 Please edit .env.local with your configuration" -ForegroundColor Yellow
+    }
+    
+    Write-Host ""
+}
+
+function New-PowerShellAliases {
+    Write-Host "🔧 Setting up PowerShell aliases..." -ForegroundColor Blue
+    Write-Host ""
+    
+    # Check if profile exists
+    if (-not (Test-Path $PROFILE)) {
+        Write-Host "Creating PowerShell profile..."
+        New-Item -Type File -Path $PROFILE -Force | Out-Null
+        Write-Host "✅ PowerShell profile created" -ForegroundColor Green
+    }
+    
+    # Check if aliases already exist
+    $profileContent = Get-Content $PROFILE -ErrorAction SilentlyContinue
+    if ($profileContent -notcontains "# Dynamics 365 Development Aliases") {
+        Write-Host "Adding aliases to PowerShell profile..."
+        
+        $aliases = @"
+
+# Dynamics 365 Development Aliases
+Set-Alias d365deploy '$ProjectRoot\deployment\scripts\deploy.ps1'
+Set-Alias d365health '$ProjectRoot\deployment\scripts\health-check.ps1'
+Set-Alias d365rollback '$ProjectRoot\deployment\scripts\rollback.ps1'
+
+function Set-D365Project { Set-Location '$ProjectRoot' }
+Set-Alias d365cd Set-D365Project
+
+function Start-D365Build { npm run build:prod }
+Set-Alias d365build Start-D365Build
+
+function Start-D365Dev { npm run build:dev }
+Set-Alias d365dev Start-D365Dev
+
+function Start-D365Quality { npm run quality }
+Set-Alias d365quality Start-D365Quality
+"@
+        
+        Add-Content -Path $PROFILE -Value $aliases
+        Write-Host "✅ Aliases added to PowerShell profile" -ForegroundColor Green
+        Write-Host "   📝 Restart PowerShell or run '. `$PROFILE' to load aliases" -ForegroundColor Yellow
+    }
+    else {
+        Write-Host "   ⚠️  Aliases already exist in PowerShell profile" -ForegroundColor Yellow
+    }
+    
+    Write-Host ""
+}
+
+function Show-NextSteps {
+    Write-Host "🚀 Next Steps:" -ForegroundColor Cyan
+    Write-Host ""
+    
+    Write-Host "1. 📖 Read the Windows Quick Start Guide:"
+    Write-Host "   start deployment\QUICKSTART-WINDOWS.md" -ForegroundColor Cyan
+    Write-Host ""
+    
+    Write-Host "2. 🔧 Install PowerShell modules (run as Administrator):"
+    Write-Host "   Install-Module Microsoft.PowerApps.Administration.PowerShell" -ForegroundColor Cyan
+    Write-Host "   Install-Module Microsoft.PowerApps.PowerShell" -ForegroundColor Cyan
+    Write-Host ""
+    
+    Write-Host "3. ⚙️  Configure your environment:"
+    Write-Host "   Copy-Item config\environments\template.json config\environments\dev.json" -ForegroundColor Cyan
+    Write-Host "   # Edit dev.json with your D365 settings"
+    Write-Host ""
+    
+    Write-Host "4. 🧪 Test your setup:"
+    Write-Host "   .\deployment\scripts\test-connection.ps1 -Environment dev" -ForegroundColor Cyan
+    Write-Host ""
+    
+    Write-Host "5. 🚀 Deploy to development:"
+    Write-Host "   .\deployment\scripts\deploy.ps1 -Environment dev -DryRun" -ForegroundColor Cyan
+    Write-Host "   .\deployment\scripts\deploy.ps1 -Environment dev" -ForegroundColor Cyan
+    Write-Host ""
+    
+    Write-Host "6. 🔨 Generate your first entity:"
+    Write-Host '   npm run generate:entity -- --entity "customentity" --display-name "Custom Entity"' -ForegroundColor Cyan
+    Write-Host ""
+    
+    Write-Host "📚 Additional Resources:" -ForegroundColor Magenta
+    Write-Host "   • Team Standards: docs\team-standards\"
+    Write-Host "   • Deployment Guide: deployment\README.md"
+    Write-Host "   • Architecture Overview: docs\ARCHITECTURE_OVERVIEW.md"
+    Write-Host "   • Code Review Checklist: docs\team-standards\code-review-checklist.md"
+    Write-Host ""
+    
+    Write-Host "🎉 Welcome to the team! Happy coding!" -ForegroundColor Green
+}
+
+function Start-InteractiveSetup {
+    if ($Interactive) {
+        Write-Host "🧙‍♂️ Starting interactive setup wizard..." -ForegroundColor Blue
+        Write-Host ""
+        
+        # Environment configuration
+        Write-Host "Environment Configuration:" -ForegroundColor Yellow
+        Write-Host "Which environment would you like to configure first?"
+        Write-Host "1) Development (dev)"
+        Write-Host "2) Testing (test)"
+        Write-Host "3) Production (prod)"
+        Write-Host "4) Skip for now"
+        
+        $choice = Read-Host "Enter your choice (1-4)"
+        
+        switch ($choice) {
+            "1" {
+                Write-Host "Setting up development environment..."
+                New-EnvironmentConfig -Environment "dev"
+            }
+            "2" {
+                Write-Host "Setting up testing environment..."
+                New-EnvironmentConfig -Environment "test"
+            }
+            "3" {
+                Write-Host "Setting up production environment..."
+                New-EnvironmentConfig -Environment "prod"
+            }
+            default {
+                Write-Host "Skipping environment configuration"
+            }
+        }
+    }
+}
+
+function New-EnvironmentConfig {
+    param([string]$Environment)
+    
+    $configFile = Join-Path $ProjectRoot "config\environments\$Environment.json"
+    
+    if (Test-Path $configFile) {
+        Write-Host "Configuration file already exists: $configFile" -ForegroundColor Yellow
+        $overwrite = Read-Host "Would you like to overwrite it? (y/n)"
+        if ($overwrite -ne "y" -and $overwrite -ne "Y") {
+            return
+        }
+    }
+    
+    Write-Host "Please provide the following information for $Environment environment:"
+    
+    # Get basic information
+    $orgUrl = Read-Host "Organization URL (e.g., https://yourorg.crm.dynamics.com)"
+    $tenantId = Read-Host "Tenant ID"
+    $clientId = Read-Host "Client ID"
+    $clientSecret = Read-Host "Client Secret" -AsSecureString
+    $clientSecretPlain = [Runtime.InteropServices.Marshal]::PtrToStringAuto([Runtime.InteropServices.Marshal]::SecureStringToBSTR($clientSecret))
+    
+    # Create configuration
+    $config = @{
+        name = $Environment.Substring(0,1).ToUpper() + $Environment.Substring(1)
+        type = $Environment
+        dynamics365 = @{
+            orgUrl = $orgUrl
+            webApiUrl = "$orgUrl/api/data/v9.2"
+            tenantId = $tenantId
+        }
+        authentication = @{
+            type = "oauth2"
+            clientId = $clientId
+            clientSecret = $clientSecretPlain
+        }
+        deployment = @{
+            strategy = "blue-green"
+            rollbackEnabled = $true
+        }
+    }
+    
+    $config | ConvertTo-Json -Depth 3 | Set-Content -Path $configFile -Encoding UTF8
+    Write-Host "✅ Configuration created: $configFile" -ForegroundColor Green
+}
+
+# Main execution
+function Main {
+    Show-Banner
+    
+    $platformInfo = Get-PlatformInfo
+    Show-PlatformInfo -PlatformInfo $platformInfo
+    
+    if (-not $SkipPrerequisites) {
+        if (-not (Test-Prerequisites)) {
+            Write-Host "Please install missing prerequisites and run this script again." -ForegroundColor Red
+            return
+        }
+    }
+    
+    if (-not (Test-ProjectSetup)) {
+        Write-Host "Project setup issues detected. Please resolve them and try again." -ForegroundColor Red
+        return
+    }
+    
+    Initialize-DeveloperEnvironment
+    New-PowerShellAliases
+    
+    # Run interactive setup if requested
+    Start-InteractiveSetup
+    
+    Show-NextSteps
+}
+
+# Run main function
+Main