docs: [#21] add comprehensive application installation automation plan

- Create detailed implementation plan for Phase 3: Maximum Practical Application Installation Automation
- Document current state analysis with accurate status of implemented vs missing components
- Provide technical implementation details for SSL certificate automation and MySQL backup automation
- Include testing strategy with unit, integration, SSL workflow, and end-to-end testing approaches
- Define success criteria focusing on 90%+ automation with minimal manual steps
- Add risk assessment and mitigation strategies for high-risk areas
- Establish timeline and dependencies for SSL automation (Week 1) and MySQL backup automation (Week 1-2)
- Document extension points for existing twelve-factor deployment workflow
- Include comprehensive crontab template integration and cloud-init automation
- Provide detailed technical specifications for supporting scripts and environment template updates

Critical Review Findings:
- Updated status table to reflect actual repository state (40% complete, 4/12 components)
- Identified missing files: mysql-backup.sh, crontab_utils.sh
- Clarified nginx template state (HTTP active, HTTPS commented out)
- Corrected environment template status (SSL/backup variables already present)
- Fixed all markdown linting issues and improved documentation structure

This plan provides the foundation for implementing maximum practical automation while maintaining
the existing robust twelve-factor deployment architecture.

Author: josecelano

README.md

@@ -56,31 +56,31 @@ This project implements a complete [twelve-factor app](https://12factor.net/) ar
 clear separation between infrastructure provisioning and application deployment:
 
 ```text
-┌─────────────────────────────────────────────────────────────┐
-│                 Configuration Management                    │
-├─────────────────────────────────────────────────────────────┤
+┌───────────────────────────────────────────────────────────────┐
+│                 Configuration Management                      │
+├───────────────────────────────────────────────────────────────┤
 │  • Environment Templates (local.env.tpl, production.env.tpl)  │
-│  • Configuration Processing (configure-env.sh)              │
-│  • Template Rendering (.tpl → actual configs)               │
-└─────────────────────────────────────────────────────────────┘
+│  • Configuration Processing (configure-env.sh)                │
+│  • Template Rendering (.tpl → actual configs)                 │
+└───────────────────────────────────────────────────────────────┘
                             │
                             ▼
-┌─────────────────────────────────────────────────────────────┐
-│                     Infrastructure Layer                    │
-├─────────────────────────────────────────────────────────────┤
-│  • VM Provisioning (provision-infrastructure.sh)            │
-│  • Environment-specific Setup (templated cloud-init)        │
-│  • Provider Abstraction (local implemented, cloud planned)  │
-└─────────────────────────────────────────────────────────────┘
+┌───────────────────────────────────────────────────────────────┐
+│                     Infrastructure Layer                      │
+├───────────────────────────────────────────────────────────────┤
+│  • VM Provisioning (provision-infrastructure.sh)              │
+│  • Environment-specific Setup (templated cloud-init)          │
+│  • Provider Abstraction (local implemented, cloud planned)    │
+└───────────────────────────────────────────────────────────────┘
                             │
                             ▼
-┌─────────────────────────────────────────────────────────────┐
-│                    Application Layer                        │
-├─────────────────────────────────────────────────────────────┤
-│  • Environment-aware Deployment (templated configs)         │
-│  • Dynamic Service Configuration                            │
-│  • Comprehensive Health Validation                          │
-└─────────────────────────────────────────────────────────────┘
+┌───────────────────────────────────────────────────────────────┐
+│                    Application Layer                          │
+├───────────────────────────────────────────────────────────────┤
+│  • Environment-aware Deployment (templated configs)           │
+│  • Dynamic Service Configuration                              │
+│  • Comprehensive Health Validation                            │
+└───────────────────────────────────────────────────────────────┘
 ```
 
 ### Key Features
@@ -105,6 +105,9 @@ peer connections, and system health.
 
 ## 🚀 Quick Start
 
+**New users start here**: [**Deployment Guide**](docs/guides/cloud-deployment-guide.md) -
+Complete guide for deploying Torrust Tracker locally or in the cloud
+
 For detailed setup instructions, see the specific documentation:
 
 - **Infrastructure**: [Infrastructure Quick Start](infrastructure/docs/quick-start.md)
@@ -153,7 +156,8 @@ make dev-deploy ENVIRONMENT=local      # Does all steps 3-4
   deployment
 - [Production Setup](application/docs/production-setup.md) - Production
   deployment with MySQL
-- [Deployment Guide](application/docs/deployment.md) - Deployment procedures
+- [Application Deployment Procedures](application/docs/deployment.md) - Detailed
+  application deployment procedures
 - [Backup Procedures](application/docs/backups.md) - Data backup and recovery
 - [Rollback Guide](application/docs/rollbacks.md) - Application rollbacks
 - [Useful Commands](application/docs/useful-commands.md) - Common operations
@@ -162,6 +166,8 @@ make dev-deploy ENVIRONMENT=local      # Does all steps 3-4
 
 ### General Documentation
 
+- [Deployment Guide](docs/guides/cloud-deployment-guide.md) - **Main deployment
+  guide** for local development and planned cloud deployment
 - [Documentation Structure](docs/README.md) - Cross-cutting documentation
 - [Architecture Decisions](docs/adr/) - Design decisions and rationale
   - [ADR-001: Makefile Location](docs/adr/001-makefile-location.md) - Why the

docs/README.md

@@ -52,8 +52,12 @@ that span multiple components.
 
 - [Integration Testing Guide](guides/integration-testing-guide.md) - Step-by-step
   guide for running integration tests following twelve-factor methodology
-- [Quick Start Guide](guides/quick-start.md) - Fast setup guide for getting
-  started quickly
+- [Infrastructure Quick Start Guide](../infrastructure/docs/quick-start.md) - Fast
+  setup guide for getting started quickly with local development
+- [Cloud Deployment Guide](guides/cloud-deployment-guide.md) - Complete deployment
+  guide for local development and planned cloud deployment
+- [Grafana Setup Guide](guides/grafana-setup-guide.md) - Manual setup and
+  configuration of Grafana monitoring dashboards
 - [Smoke Testing Guide](guides/smoke-testing-guide.md) - End-to-end testing
   using official Torrust client tools