refactor: reorganize repo into infrastructure and application components

- Separate infrastructure (VM/server setup) from application (Docker/app config)
- Move infrastructure files to infrastructure/ (cloud-init, terraform, tests, docs)
- Move application files to application/ (compose, scripts, configs, docs)
- Create distributed .gitignore files for each component
- Add ADR-001 documenting Makefile location decision
- Update all documentation and references to match new structure
- Centralize port documentation in application/docs/firewall-requirements.md
- Add TOML formatting conventions with .taplo.toml and VS Code settings
- Update GitHub Actions workflow for new file paths
- Validate all Makefile commands work after reorganization

Author: josecelano

.editorconfig

@@ -0,0 +1,32 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+# All files
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+# TOML files
+[*.toml]
+indent_style = space
+indent_size = 2
+max_line_length = 100
+
+# JSON files
+[*.json]
+indent_style = space
+indent_size = 2
+
+# Markdown files
+[*.md]
+trim_trailing_whitespace = false
+max_line_length = 80
+
+# YAML files
+[*.{yml,yaml}]
+indent_style = space
+indent_size = 2

.github/copilot-instructions.md

@@ -27,31 +27,46 @@ torrust-tracker-demo/
 │   ├── workflows/           # GitHub Actions CI/CD pipelines
 │   └── copilot-instructions.md  # This contributor guide
 ├── docs/
-│   ├── infrastructure/      # Local testing documentation
-│   │   ├── quick-start.md   # Fast setup guide
-│   │   ├── local-testing-setup.md  # Detailed setup
-│   │   └── libvirt-setup.md # Troubleshooting guide
-│   ├── setup.md            # Production deployment docs
-│   ├── deployment.md       # Deployment procedures
-│   ├── firewall.md         # Security configuration
-│   └── *.md                # Additional operational docs
+│   ├── adr/                # Architecture Decision Records
+│   │   └── 001-makefile-location.md  # Makefile location decision
+│   └── README.md           # Cross-cutting documentation index
 ├── infrastructure/         # Infrastructure as Code
 │   ├── terraform/          # OpenTofu/Terraform configurations
 │   │   ├── main.tf         # VM and infrastructure definition
-│   │   └── local.tfvars    # Local configuration (git-ignored)
+│   │   └── terraform.tfvars.example  # Example configuration
 │   ├── cloud-init/         # VM provisioning templates
 │   │   ├── user-data.yaml.tpl     # Main system configuration
 │   │   ├── user-data-minimal.yaml.tpl  # Debug configuration
 │   │   ├── meta-data.yaml  # VM metadata
 │   │   └── network-config.yaml    # Network setup
-│   └── scripts/           # Infrastructure automation scripts
-├── share/
-│   ├── bin/               # Deployment and utility scripts
-│   └── container/default/config/  # Docker service configurations
-├── tests/infrastructure/  # Infrastructure validation tests
-├── compose.yaml           # Docker Compose for services
+│   ├── scripts/           # Infrastructure automation scripts
+│   ├── tests/             # Infrastructure validation tests
+│   ├── docs/              # Infrastructure documentation
+│   │   ├── quick-start.md  # Fast setup guide
+│   │   ├── local-testing-setup.md  # Detailed setup
+│   │   ├── infrastructure-overview.md  # Architecture overview
+│   │   ├── testing/        # Testing documentation
+│   │   └── third-party/    # Third-party setup guides
+│   ├── .gitignore         # Infrastructure-specific ignores
+│   └── README.md          # Infrastructure overview
+├── application/           # Application deployment and services
+│   ├── share/
+│   │   ├── bin/           # Deployment and utility scripts
+│   │   ├── container/     # Docker service configurations
+│   │   ├── dev/           # Development configs
+│   │   └── grafana/       # Grafana dashboards
+│   ├── docs/              # Application documentation
+│   │   ├── production-setup.md    # Production deployment docs
+│   │   ├── deployment.md          # Deployment procedures
+│   │   ├── firewall-requirements.md # Application firewall requirements
+│   │   ├── useful-commands.md     # Operational commands
+│   │   └── media/         # Screenshots and diagrams
+│   ├── compose.yaml       # Docker Compose for services
+│   ├── .env.production    # Production environment template
+│   ├── .gitignore         # Application-specific ignores
+│   └── README.md          # Application overview
 ├── Makefile              # Main automation interface
-└── *.md                  # Project documentation
+└── *.md                  # Project root documentation
 ```
 
 ### Key Components
@@ -61,25 +76,20 @@ torrust-tracker-demo/
 - **OpenTofu/Terraform**: Declarative infrastructure configuration
 - **Cloud-init**: Automated VM provisioning and setup
 - **Scripts**: Automation helpers for libvirt, monitoring, etc.
+- **Tests**: Infrastructure validation and integration tests
+- **Documentation**: Infrastructure-specific guides and references
 
-#### 🐳 Docker Services (`compose.yaml`, `share/container/`)
-
-- **Nginx**: Reverse proxy and SSL termination
-- **Grafana**: Metrics visualization and dashboards
-- **Prometheus**: Metrics collection and storage
-- **Certbot**: Automated SSL certificate management
+#### 🐳 Application Services (`application/`)
 
-#### 🧪 Testing (`tests/infrastructure/`)
-
-- **Validation scripts**: Ensure infrastructure works correctly
-- **Integration tests**: End-to-end deployment verification
-- **CI/CD pipelines**: Automated testing in GitHub Actions
+- **Docker Compose**: Service orchestration configuration
+- **Service Configs**: Nginx, Grafana, Prometheus configurations
+- **Deployment Scripts**: Application deployment and utility scripts
+- **Documentation**: Production setup, deployment, and operational guides
 
 #### 📚 Documentation (`docs/`)
 
-- **Production**: Setup, deployment, and operational guides
-- **Local testing**: Development and testing instructions
-- **Troubleshooting**: Common issues and solutions
+- **Cross-cutting**: Project-wide documentation and ADRs
+- **Architecture Decisions**: Documented design choices and rationale
 
 ## 🛠️ Development Workflow
 
@@ -174,11 +184,22 @@ make test-syntax # Syntax validation only
 - **Links**: Prefer relative links for internal documentation
 - **Code blocks**: Always specify language for syntax highlighting
 
+#### TOML Configuration Files
+
+- **Formatting**: Use [Even Better TOML](https://marketplace.visualstudio.com/items?itemName=tamasfe.even-better-toml) extension for VS Code
+- **Style**: Blank lines between sections, 2-space indentation, preserve comments
+- **Configuration**: Project includes `.taplo.toml` and `.vscode/settings.json` for consistent formatting
+- **Key conventions**:
+  - Blank line before each `[section]` and `[[array]]`
+  - Detailed comments for port configurations
+  - Preserve logical grouping and order
+  - No automatic key reordering
+
 #### Infrastructure as Code
 
 - **Validation**: All Terraform/OpenTofu must pass `tofu validate`
 - **Planning**: Test with `tofu plan` before applying
-- **Variables**: Use `local.tfvars` for sensitive/local config (git-ignored)
+- **Variables**: Use `terraform.tfvars` for sensitive/local config (git-ignored)
 - **Templates**: Use `.tpl` extension for templated files
 
 ### Testing Requirements
@@ -200,8 +221,8 @@ make test-syntax # Syntax validation only
 
 #### Secrets Management
 
-- **SSH Keys**: Use template variables, store in `local.tfvars`
-- **Git Ignore**: All sensitive files must be in `.gitignore`
+- **SSH Keys**: Use template variables, store in `terraform.tfvars`
+- **Git Ignore**: Distributed `.gitignore` files in each component (root, infrastructure, application)
 - **Environment Variables**: Use environment variables for CI/CD secrets
 - **Review**: All security-related changes require review
 
@@ -218,26 +239,49 @@ make test-syntax # Syntax validation only
 
 1. **Read the documentation**:
 
-   - [Quick Start Guide](../docs/infrastructure/quick-start.md)
-   - [Complete Setup Guide](../docs/infrastructure/local-testing-setup.md)
+   - [Quick Start Guide](../infrastructure/docs/quick-start.md)
+   - [Complete Setup Guide](../infrastructure/docs/local-testing-setup.md)
+   - [Production Setup Guide](../application/docs/production-setup.md)
 
-2. **Set up your environment**:
+2. **Set up your development environment**:
 
    ```bash
    make install-deps  # Install dependencies
    make setup-ssh-key # Configure SSH access
    make test-prereq   # Verify setup
    ```
 
-3. **Test a simple change**:
+3. **Install recommended VS Code extensions**:
+
+   - **[Even Better TOML](https://marketplace.visualstudio.com/items?itemName=tamasfe.even-better-toml)** - TOML syntax highlighting and formatting
+   - **[ShellCheck](https://marketplace.visualstudio.com/items?itemName=timonwong.shellcheck)** - Shell script linting
+   - **[YAML](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml)** - YAML support with schema validation
+   - **[markdownlint](https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint)** - Markdown linting
+   - **[HashiCorp Terraform](https://marketplace.visualstudio.com/items?itemName=HashiCorp.terraform)** - Terraform/OpenTofu support
+
+4. **Configure VS Code workspace**:
+
+   - Project includes `.vscode/settings.json` with TOML formatting configuration
+   - Extensions will use project-specific settings automatically
+   - Reload VS Code after installing extensions for settings to take effect
+
+5. **TOML Formatting Setup**:
+
+   - **Configuration files**: `.taplo.toml` and `.vscode/settings.json` control formatting
+   - **Format on save**: TOML files auto-format when saved (`Ctrl+S`)
+   - **Manual format**: Use `Shift+Alt+F` (Windows/Linux) or `Shift+Option+F` (Mac)
+   - **Style**: Blank lines between sections, 2-space indentation, preserved comments
+   - **Reload required**: After changing settings, reload VS Code window (`Ctrl+Shift+P` → "Developer: Reload Window")
+
+6. **Test a simple change**:
 
    ```bash
    make apply        # Deploy test VM
    make ssh          # Verify access
    make destroy      # Clean up
    ```
 
-4. **Review existing issues**: Check [GitHub Issues](https://github.com/torrust/torrust-tracker-demo/issues) for good first contributions
+7. **Review existing issues**: Check [GitHub Issues](https://github.com/torrust/torrust-tracker-demo/issues) for good first contributions
 
 ### For Infrastructure Changes
 

.github/workflows/infrastructure.yml

@@ -5,14 +5,14 @@ on:
     branches: [main, develop]
     paths:
       - "infrastructure/**"
-      - "tests/infrastructure/**"
+      - "infrastructure/tests/**"
       - "Makefile"
       - ".github/workflows/infrastructure.yml"
   pull_request:
     branches: [main, develop]
     paths:
       - "infrastructure/**"
-      - "tests/infrastructure/**"
+      - "infrastructure/tests/**"
       - "Makefile"
       - ".github/workflows/infrastructure.yml"
 
@@ -39,8 +39,8 @@ jobs:
 
       - name: Test script permissions
         run: |
-          test -x tests/infrastructure/test-local-setup.sh
-          test -x tests/infrastructure/test-integration.sh
+          test -x infrastructure/tests/test-local-setup.sh
+          test -x infrastructure/tests/test-integration.sh
 
       - name: Run syntax tests
         env:
@@ -65,11 +65,12 @@ jobs:
       - name: Check documentation links
         run: |
           # Verify documentation files exist
-          test -f docs/infrastructure/quick-start.md
-          test -f docs/infrastructure/local-testing-setup.md
+          test -f infrastructure/docs/quick-start.md
+          test -f infrastructure/docs/local-testing-setup.md
           test -f infrastructure/README.md
+          test -f application/README.md
 
           # Check for common documentation issues
-          grep -q "Quick Start" docs/infrastructure/quick-start.md
-          grep -q "OpenTofu" docs/infrastructure/local-testing-setup.md
+          grep -q "Quick Start" infrastructure/docs/quick-start.md
+          grep -q "OpenTofu" infrastructure/docs/local-testing-setup.md
           grep -q "make" README.md

.gitignore

@@ -1,3 +1,10 @@
-.env
+# Project-level gitignore - cross-cutting files only
+# Specific ignores are in infrastructure/.gitignore and application/.gitignore
+
+# Repository organization tool output
 repomix-output.xml
-storage/
+
+# Note: This repository uses distributed .gitignore files:
+# - infrastructure/.gitignore: Infrastructure-specific files (Terraform, VMs, etc.)
+# - application/.gitignore: Application-specific files (Docker, logs, data, etc.)
+# - .gitignore (this file): Project-wide cross-cutting files only

.taplo.toml

@@ -0,0 +1,31 @@
+# Taplo (Even Better TOML) configuration
+# This configures the TOML formatter for this project
+[formatting]
+# Column width for wrapping
+column_width = 100
+# Indentation (2 spaces)
+indent_string = "  "
+# Alignment and spacing
+align_entries = false
+align_comments = true
+indent_tables = false
+indent_entries = false
+# Compact settings - set to false to preserve spacing
+compact_arrays = false
+compact_inline_tables = false
+compact_entries = false
+# Array formatting
+array_trailing_comma = true
+array_auto_expand = true
+array_auto_collapse = false
+# Inline table settings
+inline_table_expand = true
+# Blank lines - allow up to 2 consecutive blank lines
+allowed_blank_lines = 2
+# Preserve key/array order (don't reorder across blank lines)
+reorder_keys = false
+reorder_arrays = false
+reorder_inline_tables = false
+# Line endings and trailing newline
+trailing_newline = true
+crlf = false

.vscode/settings.json

@@ -0,0 +1,27 @@
+{
+    // Even Better TOML formatter configuration (camelCase for VS Code)
+    "evenBetterToml.formatter.columnWidth": 100,
+    "evenBetterToml.formatter.indentString": "  ",
+    "evenBetterToml.formatter.alignEntries": false,
+    "evenBetterToml.formatter.alignComments": true,
+    "evenBetterToml.formatter.indentTables": false,
+    "evenBetterToml.formatter.indentEntries": false,
+    "evenBetterToml.formatter.compactArrays": false,
+    "evenBetterToml.formatter.compactInlineTables": false,
+    "evenBetterToml.formatter.compactEntries": false,
+    "evenBetterToml.formatter.arrayTrailingComma": true,
+    "evenBetterToml.formatter.arrayAutoExpand": true,
+    "evenBetterToml.formatter.arrayAutoCollapse": false,
+    "evenBetterToml.formatter.inlineTableExpand": true,
+    "evenBetterToml.formatter.allowedBlankLines": 2,
+    "evenBetterToml.formatter.reorderKeys": false,
+    "evenBetterToml.formatter.reorderArrays": false,
+    "evenBetterToml.formatter.reorderInlineTables": false,
+    "evenBetterToml.formatter.trailingNewline": true,
+    "evenBetterToml.formatter.crlf": false,
+    // Format on save for TOML files
+    "[toml]": {
+        "editor.formatOnSave": true,
+        "editor.defaultFormatter": "tamasfe.even-better-toml"
+    }
+}

MAKEFILE_TESTING_TODO.md

@@ -4,7 +4,7 @@
 # Default variables
 VM_NAME ?= torrust-tracker-demo
 TERRAFORM_DIR = infrastructure/terraform
-TESTS_DIR = tests/infrastructure
+TESTS_DIR = infrastructure/tests
 
 # Help target
 help: ## Show this help message