@khester/create-dynamics-app 1.0.8 → 1.1.0

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

@@ -0,0 +1,567 @@
+#!/bin/bash
+
+# Team Onboarding Script with Platform Detection
+# Automatically detects platform and guides developer through setup
+
+set -euo pipefail
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+MAGENTA='\033[0;35m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+# Script configuration
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "${SCRIPT_DIR}/../.." && pwd)"
+
+# Platform detection
+detect_platform() {
+    case "$(uname -s)" in
+        Darwin*)    echo "mac" ;;
+        Linux*)     echo "linux" ;;
+        CYGWIN*|MINGW32*|MSYS*|MINGW*) echo "windows" ;;
+        *)          echo "unknown" ;;
+    esac
+}
+
+# Architecture detection
+detect_arch() {
+    case "$(uname -m)" in
+        x86_64|amd64) echo "x64" ;;
+        arm64|aarch64) echo "arm64" ;;
+        *) echo "unknown" ;;
+    esac
+}
+
+show_banner() {
+    echo -e "${CYAN}"
+    echo "╔══════════════════════════════════════════════════════════════╗"
+    echo "║            Dynamics 365 Team Onboarding Assistant           ║"
+    echo "║                  Enterprise Consulting Edition              ║"
+    echo "╚══════════════════════════════════════════════════════════════╝"
+    echo -e "${NC}"
+}
+
+show_platform_info() {
+    local platform="$1"
+    local arch="$2"
+    
+    echo -e "${BLUE}🔍 Platform Detection:${NC}"
+    echo "   Platform: $platform"
+    echo "   Architecture: $arch"
+    echo
+    
+    case "$platform" in
+        mac)
+            echo -e "${GREEN}✅ macOS detected - You'll use Bash scripts${NC}"
+            echo "   📖 Quick Start Guide: deployment/QUICKSTART-MAC.md"
+            ;;
+        linux)
+            echo -e "${GREEN}✅ Linux detected - You'll use Bash scripts${NC}"
+            echo "   📖 Quick Start Guide: deployment/QUICKSTART-MAC.md (compatible)"
+            ;;
+        windows)
+            echo -e "${GREEN}✅ Windows detected - You can use PowerShell or Bash scripts${NC}"
+            echo "   📖 PowerShell Guide: deployment/QUICKSTART-WINDOWS.md"
+            echo "   📖 Bash Alternative: deployment/QUICKSTART-MAC.md"
+            ;;
+        *)
+            echo -e "${YELLOW}⚠️  Unknown platform - Please check system requirements${NC}"
+            ;;
+    esac
+    echo
+}
+
+check_prerequisites() {
+    local platform="$1"
+    local missing_tools=()
+    local all_good=true
+    
+    echo -e "${BLUE}🔧 Checking Prerequisites...${NC}"
+    echo
+    
+    # Common tools
+    local common_tools=("node" "npm" "git")
+    
+    # Platform-specific tools
+    case "$platform" in
+        mac|linux)
+            local platform_tools=("jq" "curl")
+            ;;
+        windows)
+            local platform_tools=("jq" "curl")
+            ;;
+        *)
+            local platform_tools=()
+            ;;
+    esac
+    
+    # Check common tools
+    for tool in "${common_tools[@]}"; do
+        if command -v "$tool" &> /dev/null; then
+            local version=$(eval "$tool --version" 2>/dev/null | head -n1 || echo "unknown")
+            echo -e "   ${GREEN}✅ $tool${NC} - $version"
+        else
+            echo -e "   ${RED}❌ $tool${NC} - Not installed"
+            missing_tools+=("$tool")
+            all_good=false
+        fi
+    done
+    
+    # Check platform-specific tools
+    for tool in "${platform_tools[@]}"; do
+        if command -v "$tool" &> /dev/null; then
+            local version=$(eval "$tool --version" 2>/dev/null | head -n1 || echo "unknown")
+            echo -e "   ${GREEN}✅ $tool${NC} - $version"
+        else
+            echo -e "   ${RED}❌ $tool${NC} - Not installed"
+            missing_tools+=("$tool")
+            all_good=false
+        fi
+    done
+    
+    # Check PowerShell on Windows
+    if [ "$platform" = "windows" ]; then
+        if command -v pwsh &> /dev/null; then
+            local ps_version=$(pwsh -c '$PSVersionTable.PSVersion.ToString()' 2>/dev/null || echo "unknown")
+            echo -e "   ${GREEN}✅ PowerShell Core${NC} - $ps_version"
+        elif command -v powershell &> /dev/null; then
+            local ps_version=$(powershell -c '$PSVersionTable.PSVersion.ToString()' 2>/dev/null || echo "unknown")
+            echo -e "   ${GREEN}✅ Windows PowerShell${NC} - $ps_version"
+        else
+            echo -e "   ${YELLOW}⚠️  PowerShell${NC} - Not detected (optional)"
+        fi
+    fi
+    
+    echo
+    
+    if [ "$all_good" = true ]; then
+        echo -e "${GREEN}🎉 All prerequisites are installed!${NC}"
+        return 0
+    else
+        echo -e "${RED}❌ Missing tools detected${NC}"
+        show_installation_instructions "$platform" "${missing_tools[@]}"
+        return 1
+    fi
+}
+
+show_installation_instructions() {
+    local platform="$1"
+    shift
+    local missing_tools=("$@")
+    
+    echo -e "${YELLOW}📦 Installation Instructions:${NC}"
+    echo
+    
+    case "$platform" in
+        mac)
+            echo "Install missing tools using Homebrew:"
+            echo
+            if [[ " ${missing_tools[*]} " =~ " node " ]] || [[ " ${missing_tools[*]} " =~ " npm " ]]; then
+                echo "   brew install node"
+            fi
+            if [[ " ${missing_tools[*]} " =~ " git " ]]; then
+                echo "   brew install git"
+            fi
+            if [[ " ${missing_tools[*]} " =~ " jq " ]]; then
+                echo "   brew install jq"
+            fi
+            if [[ " ${missing_tools[*]} " =~ " curl " ]]; then
+                echo "   brew install curl"
+            fi
+            echo
+            echo "If Homebrew is not installed:"
+            echo '   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"'
+            ;;
+        linux)
+            echo "Install missing tools using your package manager:"
+            echo
+            echo "Ubuntu/Debian:"
+            if [[ " ${missing_tools[*]} " =~ " node " ]] || [[ " ${missing_tools[*]} " =~ " npm " ]]; then
+                echo "   sudo apt-get install nodejs npm"
+            fi
+            if [[ " ${missing_tools[*]} " =~ " git " ]]; then
+                echo "   sudo apt-get install git"
+            fi
+            if [[ " ${missing_tools[*]} " =~ " jq " ]]; then
+                echo "   sudo apt-get install jq"
+            fi
+            if [[ " ${missing_tools[*]} " =~ " curl " ]]; then
+                echo "   sudo apt-get install curl"
+            fi
+            echo
+            echo "CentOS/RHEL:"
+            if [[ " ${missing_tools[*]} " =~ " node " ]] || [[ " ${missing_tools[*]} " =~ " npm " ]]; then
+                echo "   sudo yum install nodejs npm"
+            fi
+            if [[ " ${missing_tools[*]} " =~ " git " ]]; then
+                echo "   sudo yum install git"
+            fi
+            if [[ " ${missing_tools[*]} " =~ " jq " ]]; then
+                echo "   sudo yum install jq"
+            fi
+            if [[ " ${missing_tools[*]} " =~ " curl " ]]; then
+                echo "   sudo yum install curl"
+            fi
+            ;;
+        windows)
+            echo "Install missing tools using Chocolatey or manual installation:"
+            echo
+            echo "Using Chocolatey (recommended):"
+            if [[ " ${missing_tools[*]} " =~ " node " ]] || [[ " ${missing_tools[*]} " =~ " npm " ]]; then
+                echo "   choco install nodejs"
+            fi
+            if [[ " ${missing_tools[*]} " =~ " git " ]]; then
+                echo "   choco install git"
+            fi
+            if [[ " ${missing_tools[*]} " =~ " jq " ]]; then
+                echo "   choco install jq"
+            fi
+            if [[ " ${missing_tools[*]} " =~ " curl " ]]; then
+                echo "   choco install curl"
+            fi
+            echo
+            echo "Or download from official websites:"
+            echo "   Node.js: https://nodejs.org/"
+            echo "   Git: https://git-scm.com/"
+            ;;
+    esac
+    echo
+}
+
+check_project_setup() {
+    echo -e "${BLUE}📁 Checking Project Setup...${NC}"
+    echo
+    
+    # Check if we're in a project directory
+    if [ ! -f "$PROJECT_ROOT/package.json" ]; then
+        echo -e "${RED}❌ Not in a Dynamics 365 project directory${NC}"
+        echo "   Please navigate to your project root directory"
+        return 1
+    fi
+    
+    echo -e "${GREEN}✅ Project directory detected${NC}"
+    
+    # Check package.json
+    if [ -f "$PROJECT_ROOT/package.json" ]; then
+        echo -e "${GREEN}✅ package.json found${NC}"
+    else
+        echo -e "${RED}❌ package.json not found${NC}"
+        return 1
+    fi
+    
+    # Check node_modules
+    if [ -d "$PROJECT_ROOT/node_modules" ]; then
+        echo -e "${GREEN}✅ node_modules exists${NC}"
+    else
+        echo -e "${YELLOW}⚠️  node_modules not found - run 'npm install'${NC}"
+    fi
+    
+    # Check deployment scripts
+    if [ -f "$PROJECT_ROOT/deployment/scripts/deploy.sh" ]; then
+        echo -e "${GREEN}✅ Bash deployment script found${NC}"
+    else
+        echo -e "${RED}❌ Bash deployment script missing${NC}"
+    fi
+    
+    if [ -f "$PROJECT_ROOT/deployment/scripts/deploy.ps1" ]; then
+        echo -e "${GREEN}✅ PowerShell deployment script found${NC}"
+    else
+        echo -e "${YELLOW}⚠️  PowerShell deployment script missing${NC}"
+    fi
+    
+    # Check configuration directory
+    if [ -d "$PROJECT_ROOT/config/environments" ]; then
+        echo -e "${GREEN}✅ Environment configuration directory found${NC}"
+        
+        # List available environments
+        local env_files=($(find "$PROJECT_ROOT/config/environments" -name "*.json" -exec basename {} .json \; 2>/dev/null || true))
+        if [ ${#env_files[@]} -gt 0 ]; then
+            echo "   Available environments: ${env_files[*]}"
+        else
+            echo -e "${YELLOW}   ⚠️  No environment configurations found${NC}"
+        fi
+    else
+        echo -e "${RED}❌ Environment configuration directory missing${NC}"
+    fi
+    
+    echo
+    return 0
+}
+
+setup_developer_environment() {
+    local platform="$1"
+    
+    echo -e "${BLUE}⚙️  Setting up developer environment...${NC}"
+    echo
+    
+    # Make scripts executable (Unix-like systems)
+    if [ "$platform" != "windows" ]; then
+        echo "Making deployment scripts executable..."
+        find "$PROJECT_ROOT/deployment/scripts" -name "*.sh" -exec chmod +x {} \; 2>/dev/null || true
+        echo -e "${GREEN}✅ Scripts are now executable${NC}"
+    fi
+    
+    # Install npm dependencies if needed
+    if [ ! -d "$PROJECT_ROOT/node_modules" ]; then
+        echo "Installing npm dependencies..."
+        cd "$PROJECT_ROOT"
+        npm install
+        echo -e "${GREEN}✅ Dependencies installed${NC}"
+    fi
+    
+    # Create .env.local template if it doesn't exist
+    if [ ! -f "$PROJECT_ROOT/.env.local" ]; then
+        echo "Creating .env.local template..."
+        cat > "$PROJECT_ROOT/.env.local" << 'EOF'
+# 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
+EOF
+        echo -e "${GREEN}✅ .env.local template created${NC}"
+        echo -e "${YELLOW}   📝 Please edit .env.local with your configuration${NC}"
+    fi
+    
+    echo
+}
+
+create_platform_aliases() {
+    local platform="$1"
+    
+    echo -e "${BLUE}🔧 Setting up platform-specific aliases...${NC}"
+    echo
+    
+    case "$platform" in
+        mac)
+            local shell_config=""
+            if [ -n "${ZSH_VERSION:-}" ] || [ "$SHELL" = "/bin/zsh" ]; then
+                shell_config="$HOME/.zshrc"
+            elif [ -n "${BASH_VERSION:-}" ] || [ "$SHELL" = "/bin/bash" ]; then
+                shell_config="$HOME/.bash_profile"
+            fi
+            
+            if [ -n "$shell_config" ]; then
+                echo "Adding aliases to $shell_config..."
+                
+                # Check if aliases already exist
+                if ! grep -q "# Dynamics 365 Development Aliases" "$shell_config" 2>/dev/null; then
+                    cat >> "$shell_config" << EOF
+
+# Dynamics 365 Development Aliases
+alias d365deploy="./deployment/scripts/deploy.sh"
+alias d365health="./deployment/scripts/health-check.sh"
+alias d365rollback="./deployment/scripts/rollback.sh"
+alias d365cd="cd $PROJECT_ROOT"
+alias d365build="npm run build:prod"
+alias d365dev="npm run build:dev"
+alias d365quality="npm run quality"
+
+EOF
+                    echo -e "${GREEN}✅ Aliases added to $shell_config${NC}"
+                    echo -e "${YELLOW}   📝 Run 'source $shell_config' or restart your terminal${NC}"
+                else
+                    echo -e "${YELLOW}   ⚠️  Aliases already exist in $shell_config${NC}"
+                fi
+            fi
+            ;;
+        windows)
+            echo "For Windows, you can create PowerShell aliases in your profile:"
+            echo
+            echo "PowerShell Profile Setup:"
+            echo '   if (!(Test-Path $PROFILE)) { New-Item -Type File -Path $PROFILE -Force }'
+            echo '   Add-Content $PROFILE "Set-Alias d365deploy .\deployment\scripts\deploy.ps1"'
+            echo '   Add-Content $PROFILE "Set-Alias d365health .\deployment\scripts\health-check.ps1"'
+            echo
+            ;;
+    esac
+    
+    echo
+}
+
+show_next_steps() {
+    local platform="$1"
+    
+    echo -e "${CYAN}🚀 Next Steps:${NC}"
+    echo
+    
+    case "$platform" in
+        mac|linux)
+            echo "1. 📖 Read the Mac/Linux Quick Start Guide:"
+            echo "   open deployment/QUICKSTART-MAC.md"
+            echo
+            echo "2. 🔧 Configure your environment:"
+            echo "   cp config/environments/template.json config/environments/dev.json"
+            echo "   # Edit dev.json with your D365 settings"
+            echo
+            echo "3. 🧪 Test your setup:"
+            echo "   ./deployment/scripts/test-connection.sh dev"
+            echo
+            echo "4. 🚀 Deploy to development:"
+            echo "   ./deployment/scripts/deploy.sh dev --dry-run"
+            echo "   ./deployment/scripts/deploy.sh dev"
+            echo
+            echo "5. 🔨 Generate your first entity:"
+            echo '   npm run generate:entity -- --entity "customentity" --display-name "Custom Entity"'
+            ;;
+        windows)
+            echo "1. 📖 Read the Windows Quick Start Guide:"
+            echo "   start deployment/QUICKSTART-WINDOWS.md"
+            echo
+            echo "2. 🔧 Install PowerShell modules (run as Administrator):"
+            echo "   Install-Module Microsoft.PowerApps.Administration.PowerShell"
+            echo "   Install-Module Microsoft.PowerApps.PowerShell"
+            echo
+            echo "3. ⚙️  Configure your environment:"
+            echo "   Copy-Item config\\environments\\template.json config\\environments\\dev.json"
+            echo "   # Edit dev.json with your D365 settings"
+            echo
+            echo "4. 🧪 Test your setup:"
+            echo "   .\\deployment\\scripts\\test-connection.ps1 -Environment dev"
+            echo
+            echo "5. 🚀 Deploy to development:"
+            echo "   .\\deployment\\scripts\\deploy.ps1 -Environment dev -DryRun"
+            echo "   .\\deployment\\scripts\\deploy.ps1 -Environment dev"
+            echo
+            echo "6. 🔨 Generate your first entity:"
+            echo '   npm run generate:entity -- --entity "customentity" --display-name "Custom Entity"'
+            ;;
+    esac
+    
+    echo
+    echo -e "${MAGENTA}📚 Additional Resources:${NC}"
+    echo "   • Team Standards: docs/team-standards/"
+    echo "   • Deployment Guide: deployment/README.md"
+    echo "   • Architecture Overview: docs/ARCHITECTURE_OVERVIEW.md"
+    echo "   • Code Review Checklist: docs/team-standards/code-review-checklist.md"
+    echo
+    echo -e "${GREEN}🎉 Welcome to the team! Happy coding!${NC}"
+}
+
+run_interactive_setup() {
+    echo -e "${YELLOW}Would you like to run the interactive setup wizard? (y/n)${NC}"
+    read -r response
+    
+    if [[ "$response" =~ ^[Yy]$ ]]; then
+        echo
+        echo -e "${BLUE}🧙‍♂️ Starting interactive setup wizard...${NC}"
+        echo
+        
+        # Environment configuration
+        echo -e "${YELLOW}Environment Configuration:${NC}"
+        echo "Which environment would you like to configure first?"
+        echo "1) Development (dev)"
+        echo "2) Testing (test)"  
+        echo "3) Production (prod)"
+        echo "4) Skip for now"
+        
+        read -r env_choice
+        
+        case "$env_choice" in
+            1)
+                echo "Setting up development environment..."
+                setup_environment_config "dev"
+                ;;
+            2)
+                echo "Setting up testing environment..."
+                setup_environment_config "test"
+                ;;
+            3)
+                echo "Setting up production environment..."
+                setup_environment_config "prod"
+                ;;
+            *)
+                echo "Skipping environment configuration"
+                ;;
+        esac
+    fi
+}
+
+setup_environment_config() {
+    local env="$1"
+    local config_file="$PROJECT_ROOT/config/environments/$env.json"
+    
+    if [ -f "$config_file" ]; then
+        echo -e "${YELLOW}Configuration file already exists: $config_file${NC}"
+        echo "Would you like to overwrite it? (y/n)"
+        read -r overwrite
+        if [[ ! "$overwrite" =~ ^[Yy]$ ]]; then
+            return
+        fi
+    fi
+    
+    echo "Please provide the following information for $env environment:"
+    
+    # Get basic information
+    read -p "Organization URL (e.g., https://yourorg.crm.dynamics.com): " org_url
+    read -p "Tenant ID: " tenant_id
+    read -p "Client ID: " client_id
+    read -s -p "Client Secret: " client_secret
+    echo
+    
+    # Create configuration
+    cat > "$config_file" << EOF
+{
+  "name": "${env^}",
+  "type": "$env",
+  "dynamics365": {
+    "orgUrl": "$org_url",
+    "webApiUrl": "${org_url}/api/data/v9.2",
+    "tenantId": "$tenant_id"
+  },
+  "authentication": {
+    "type": "oauth2",
+    "clientId": "$client_id",
+    "clientSecret": "$client_secret"
+  },
+  "deployment": {
+    "strategy": "blue-green",
+    "rollbackEnabled": true
+  }
+}
+EOF
+    
+    echo -e "${GREEN}✅ Configuration created: $config_file${NC}"
+}
+
+# Main execution
+main() {
+    show_banner
+    
+    local platform=$(detect_platform)
+    local arch=$(detect_arch)
+    
+    show_platform_info "$platform" "$arch"
+    
+    if ! check_prerequisites "$platform"; then
+        echo -e "${RED}Please install missing prerequisites and run this script again.${NC}"
+        exit 1
+    fi
+    
+    if ! check_project_setup; then
+        echo -e "${RED}Project setup issues detected. Please resolve them and try again.${NC}"
+        exit 1
+    fi
+    
+    setup_developer_environment "$platform"
+    create_platform_aliases "$platform"
+    
+    # Run interactive setup if requested
+    run_interactive_setup
+    
+    show_next_steps "$platform"
+}
+
+# Run main function
+main "$@"