feat: [#28] Phase 1 foundation - rename 'local' environment to 'development'

- Rename local.defaults → development.defaults for consistency
- Update all script references from 'local' to 'development' environment
- Update Makefile default ENVIRONMENT from 'local' to 'development'
- Update function names: setup_local_environment → setup_development_environment
- Update help text and documentation references
- E2e tests pass: Complete twelve-factor deployment workflow validated

This establishes the foundation for multi-provider architecture by
eliminating confusion between environment names and provider concepts.
Environment 'development' clearly indicates configuration type, while
providers (libvirt, hetzner, etc.) indicate deployment target.

Phase 1 foundation completed successfully - ready for provider interface implementation.

Author: josecelano

Makefile

@@ -10,7 +10,7 @@
 
 # Default variables
 VM_NAME ?= torrust-tracker-demo
-ENVIRONMENT ?= local
+ENVIRONMENT ?= development
 TERRAFORM_DIR = infrastructure/terraform
 INFRA_TESTS_DIR = infrastructure/tests
 TESTS_DIR = tests
@@ -44,9 +44,9 @@ help: ## Show this help message
 	@awk 'BEGIN {FS = ":.*?## "} /^(install-deps|clean).*:.*?## / {printf "  %-20s %s\n", $$1, $$2}' $(MAKEFILE_LIST)
 	@echo ""
 	@echo "Examples:"
-	@echo "  make dev-deploy ENVIRONMENT=local"
-	@echo "  make infra-apply ENVIRONMENT=local"
-	@echo "  make app-deploy ENVIRONMENT=local"
+	@echo "  make dev-deploy ENVIRONMENT=development"
+	@echo "  make infra-apply ENVIRONMENT=development"
+	@echo "  make app-deploy ENVIRONMENT=development"
 
 install-deps: ## Install required dependencies (Ubuntu/Debian)
 	@echo "Installing dependencies..."

infrastructure/config/environments/local.defaults renamed to infrastructure/config/environments/development.defaults

@@ -1,10 +1,10 @@
-# Local Development Environment Default Values
-# These values are used to generate local.env from the base template
+# Development Environment Default Values
+# These values are used to generate development.env from the base template
 # Safe default values for local development and testing
 
-ENVIRONMENT_DESCRIPTION="Local Development Environment Configuration"
-ENVIRONMENT_INSTRUCTIONS="Generated from base template for local development and testing"
-ENVIRONMENT="local"
+ENVIRONMENT_DESCRIPTION="Development Environment Configuration"
+ENVIRONMENT_INSTRUCTIONS="Generated from base template for development and testing"
+ENVIRONMENT="development"
 TEMPLATE_PROCESSING_VARS="
 # Template processing variables
 DOLLAR=\$"

infrastructure/scripts/configure-env.sh

@@ -14,7 +14,7 @@ CONFIG_DIR="${PROJECT_ROOT}/infrastructure/config"
 source "${PROJECT_ROOT}/scripts/shell-utils.sh"
 
 # Default values
-ENVIRONMENT="${1:-local}"
+ENVIRONMENT="${1:-development}"
 VERBOSE="${VERBOSE:-false}"
 
 # Source shared shell utilities
@@ -36,8 +36,8 @@ generate_environment_config() {
 
     # Generate environment-specific variables
     case "${environment}" in
-        "local")
-            generate_local_config "${base_template}" "${env_file}"
+        "development")
+            generate_development_config "${base_template}" "${env_file}"
             ;;
         "production")
             generate_production_config "${base_template}" "${env_file}"
@@ -51,18 +51,18 @@ generate_environment_config() {
     log_success "${environment^} environment file generated: ${env_file}"
 }
 
-# Generate local development configuration
-generate_local_config() {
+# Generate development configuration
+generate_development_config() {
     local template_file="$1"
     local output_file="$2"
-    local defaults_file="${CONFIG_DIR}/environments/local.defaults"
+    local defaults_file="${CONFIG_DIR}/environments/development.defaults"
 
     if [[ ! -f "${defaults_file}" ]]; then
-        log_error "Local defaults file not found: ${defaults_file}"
+        log_error "Development defaults file not found: ${defaults_file}"
         exit 1
     fi
 
-    log_info "Loading local environment defaults from: ${defaults_file}"
+    log_info "Loading development environment defaults from: ${defaults_file}"
 
     # Export all variables from defaults file for envsubst
     set -a # automatically export all variables
@@ -108,13 +108,13 @@ generate_production_config() {
     log_warning "File location: ${output_file}"
 }
 
-# Setup local environment from base template
-setup_local_environment() {
-    local env_file="${CONFIG_DIR}/environments/local.env"
+# Setup development environment from base template
+setup_development_environment() {
+    local env_file="${CONFIG_DIR}/environments/development.env"
 
-    # Always regenerate local.env from base template for consistency
-    generate_environment_config "local"
-    log_success "Local environment file created from base template: ${env_file}"
+    # Always regenerate development.env from base template for consistency
+    generate_environment_config "development"
+    log_success "Development environment file created from base template: ${env_file}"
 }
 
 # Setup production environment from base template  
@@ -140,8 +140,8 @@ load_environment() {
     # Special handling for template-based environments
     if [[ "${ENVIRONMENT}" == "production" ]]; then
         setup_production_environment
-    elif [[ "${ENVIRONMENT}" == "local" ]]; then
-        setup_local_environment
+    elif [[ "${ENVIRONMENT}" == "development" ]]; then
+        setup_development_environment
     fi
 
     if [[ ! -f "${env_file}" ]]; then
@@ -360,14 +360,14 @@ Configuration Processing Script
 Usage: $0 [ENVIRONMENT|COMMAND]
 
 Arguments:
-    ENVIRONMENT         Environment name (local, production)
+    ENVIRONMENT         Environment name (development, production)
     generate-secrets    Generate secure secrets for production
 
 Commands:
     generate-secrets    Generate secure random secrets and show configuration guidance
 
 Examples:
-    $0 local            # Process local environment configuration
+    $0 development      # Process development environment configuration
     $0 production       # Process production environment configuration (requires configured secrets)
     $0 generate-secrets # Generate secure secrets for production setup
 

infrastructure/scripts/deploy-app.sh

@@ -11,7 +11,7 @@ PROJECT_ROOT="$(cd "${SCRIPT_DIR}/../.." && pwd)"
 TERRAFORM_DIR="${PROJECT_ROOT}/infrastructure/terraform"
 
 # Default values
-ENVIRONMENT="${1:-local}"
+ENVIRONMENT="${1:-development}"
 VM_IP="${2:-}"
 SKIP_HEALTH_CHECK="${SKIP_HEALTH_CHECK:-false}"
 SKIP_WAIT="${SKIP_WAIT:-false}"  # New parameter for skipping waiting
@@ -62,7 +62,7 @@ check_git_status() {
 
     # Determine deployment approach based on environment
     local deployment_approach
-    if [[ "${ENVIRONMENT}" == "local" ]]; then
+    if [[ "${ENVIRONMENT}" == "development" ]]; then
         deployment_approach="working tree (includes uncommitted changes)"
     else
         deployment_approach="git archive (committed changes only)"
@@ -82,8 +82,8 @@ check_git_status() {
         done
         log_warning ""
 
-        if [[ "${ENVIRONMENT}" == "local" ]]; then
-            log_info "ℹ️  LOCAL TESTING: Uncommitted changes WILL be deployed (using working tree)"
+        if [[ "${ENVIRONMENT}" == "development" ]]; then
+            log_info "ℹ️  DEVELOPMENT TESTING: Uncommitted changes WILL be deployed (using working tree)"
             log_info "This includes your configuration changes and any other uncommitted modifications."
         else
             log_warning "IMPORTANT: Production deployment uses 'git archive' which only includes committed files."
@@ -544,7 +544,7 @@ release_stage() {
     log_info "Deploying application with environment: ${ENVIRONMENT}"
 
     # Choose deployment method based on environment
-    if [[ "${ENVIRONMENT}" == "local" ]]; then
+    if [[ "${ENVIRONMENT}" == "development" ]]; then
         deploy_local_working_tree "${vm_ip}"
     else
         deploy_git_archive "${vm_ip}"
@@ -1062,7 +1062,7 @@ Application Deployment Script (Twelve-Factor Release + Run Stages)
 Usage: $0 [ENVIRONMENT] [VM_IP]
 
 Arguments:
-    ENVIRONMENT    Environment name (local, production)
+    ENVIRONMENT    Environment name (development, production)
     VM_IP          VM IP address (optional, will get from Terraform if not provided)
 
 Environment Variables:

infrastructure/scripts/health-check.sh

@@ -11,7 +11,7 @@ PROJECT_ROOT="$(cd "${SCRIPT_DIR}/../.." && pwd)"
 TERRAFORM_DIR="${PROJECT_ROOT}/infrastructure/terraform"
 
 # Default values
-ENVIRONMENT="${1:-local}"
+ENVIRONMENT="${1:-development}"
 VM_IP="${2:-}"
 VERBOSE="${VERBOSE:-false}"
 
@@ -216,7 +216,7 @@ test_storage() {
     fi
 
     # Test database connectivity (MySQL)
-    if [[ "${ENVIRONMENT}" == "local" ]]; then
+    if [[ "${ENVIRONMENT}" == "development" ]]; then
         ((TOTAL_TESTS++))
         if vm_exec "${vm_ip}" "cd /home/torrust/github/torrust/torrust-tracker-demo/application && docker compose exec mysql mysqladmin ping -h localhost --silent"; then
             log_test_pass "MySQL database connectivity"
@@ -324,7 +324,7 @@ Health Check Script for Torrust Tracker Demo
 Usage: $0 [ENVIRONMENT] [VM_IP]
 
 Arguments:
-    ENVIRONMENT    Environment name (local, production)
+    ENVIRONMENT    Environment name (development, production)
     VM_IP          VM IP address (optional, will get from Terraform if not provided)
 
 Environment Variables:

infrastructure/scripts/provision-infrastructure.sh

@@ -11,7 +11,7 @@ PROJECT_ROOT="$(cd "${SCRIPT_DIR}/../.." && pwd)"
 TERRAFORM_DIR="${PROJECT_ROOT}/infrastructure/terraform"
 
 # Default values
-ENVIRONMENT="${1:-local}"
+ENVIRONMENT="${1:-development}"
 ACTION="${2:-apply}"
 SKIP_WAIT="${SKIP_WAIT:-false}"  # New parameter for skipping waiting
 SKIP_WAIT="${SKIP_WAIT:-false}"  # New parameter for skipping waiting
@@ -49,7 +49,7 @@ validate_prerequisites() {
     fi
 
     # Check if libvirt is available (for local environment)
-    if [[ "${ENVIRONMENT}" == "local" ]]; then
+    if [[ "${ENVIRONMENT}" == "development" ]]; then
         if ! command -v virsh >/dev/null 2>&1; then
             log_error "virsh not found. Please install libvirt-clients."
             exit 1
@@ -190,7 +190,7 @@ Infrastructure Provisioning Script (Twelve-Factor Build Stage)
 Usage: $0 [ENVIRONMENT] [ACTION]
 
 Arguments:
-    ENVIRONMENT    Environment name (local, production)
+    ENVIRONMENT    Environment name (development, production)
     ACTION         Action to perform (init, plan, apply, destroy)
 
 Examples:

infrastructure/scripts/validate-config.sh

@@ -13,7 +13,7 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PROJECT_ROOT="$(cd "${SCRIPT_DIR}/../.." && pwd)"
 
 # Default values
-ENVIRONMENT="${1:-local}"
+ENVIRONMENT="${1:-development}"
 VERBOSE="${VERBOSE:-false}"
 
 # Source shared shell utilities
@@ -301,7 +301,7 @@ Configuration Validation Script
 Usage: $0 [ENVIRONMENT]
 
 Arguments:
-    ENVIRONMENT    Environment name (local, production)
+    ENVIRONMENT    Environment name (development, production)
 
 Examples:
     $0 local       # Validate local environment configuration