@khester/create-dynamics-app 1.1.0 → 2.1.0

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

@@ -1,486 +0,0 @@
-# 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