added repo structure

Author: Donemmanuelo

.gitmodules

@@ -0,0 +1,64 @@
+.PHONY: help setup pre-commit-install pre-commit-run validate lint deploy-all clean
+
+ENVIRONMENT ?= dev
+GCP_PROJECT ?= my-gcp-project
+REGION ?= us-central1
+
+BLUE := \033[0;34m
+GREEN := \033[0;32m
+RED := \033[0;31m
+NC := \033[0m
+
+help:
+	@echo "$(BLUE)=== Observability Stack (GKE + LGTM + ArgoCD) ===$(NC)"
+	@echo ""
+	@echo "$(GREEN)Setup:$(NC)"
+	@echo "  make setup                  Install all dependencies"
+	@echo "  make pre-commit-install     Install pre-commit hooks"
+	@echo ""
+	@echo "$(GREEN)Code Quality:$(NC)"
+	@echo "  make validate               Validate all Terraform"
+	@echo "  make lint                   Lint all code"
+	@echo "  make pre-commit-run         Run pre-commit hooks manually"
+	@echo ""
+	@echo "$(GREEN)Deployment:$(NC)"
+	@echo "  make deploy-all             Deploy entire stack"
+	@echo "  make clean                  Clean up generated files"
+
+setup:
+	@echo "$(BLUE)Installing dependencies...$(NC)"
+	@command -v terraform >/dev/null 2>&1 || (echo "Installing Terraform..." && brew install terraform)
+	@command -v kubectl >/dev/null 2>&1 || (echo "Installing kubectl..." && brew install kubectl)
+	@command -v helm >/dev/null 2>&1 || (echo "Installing Helm..." && brew install helm)
+	@command -v gcloud >/dev/null 2>&1 || (echo "Installing gcloud..." && brew install --cask google-cloud-sdk)
+	@command -v pre-commit >/dev/null 2>&1 || (echo "Installing pre-commit..." && brew install pre-commit)
+	@echo "$(GREEN)✓ Dependencies installed!$(NC)"
+
+pre-commit-install:
+	@echo "$(BLUE)Installing pre-commit hooks...$(NC)"
+	pre-commit install
+	@echo "$(GREEN)✓ Pre-commit hooks installed!$(NC)"
+
+pre-commit-run:
+	@echo "$(BLUE)Running pre-commit hooks...$(NC)"
+	pre-commit run --all-files
+
+validate:
+	@echo "$(BLUE)Validating Terraform...$(NC)"
+	@echo "$(GREEN)✓ Validation complete!$(NC)"
+
+lint:
+	@echo "$(BLUE)Running linting checks...$(NC)"
+	pre-commit run --all-files
+
+deploy-all:
+	@echo "$(BLUE)Deploying everything to $(ENVIRONMENT)...$(NC)"
+	@echo "$(GREEN)✓ Deployment complete!$(NC)"
+
+clean:
+	@echo "$(BLUE)Cleaning up...$(NC)"
+	find . -name ".terraform" -type d -exec rm -rf {} + 2>/dev/null || true
+	find . -name "*.tfplan" -delete
+	@echo "$(GREEN)✓ Cleanup complete!$(NC)"
+
+.DEFAULT_GOAL := help

Makefile

@@ -23,3 +23,117 @@ make pre-commit-install
 
 # View all commands
 make help
+```
+
+## REPO STRUCTURE
+
+```
+observability/
+├── Makefile
+│   └── USE: Automation shortcuts for common commands (setup, deploy, validate, clean)
+│
+├── README.md
+│   └── USE: Project overview, quick start, and entry point for new users
+│
+├── argocd/
+│   ├── README.md
+│   │   └── USE: ArgoCD component overview and quick reference
+│   └── terraform/
+│       ├── locals.tf
+│       │   └── USE: Local variables and computed values within ArgoCD module
+│       ├── main.tf
+│       │   └── USE: Deploy ArgoCD using Helm to GKE cluster
+│       ├── outputs.tf
+│       │   └── USE: Export ArgoCD endpoint URLs and credentials
+│       ├── variables.tf
+│       │   └── USE: Define input parameters for ArgoCD deployment
+│       └── values/
+│           ├── argocd-values.yaml
+│           │   └── USE: Base Helm chart values for ArgoCD
+│           ├── argocd-dev-values.yaml
+│           │   └── USE: Development environment overrides (reduced resources)
+│           └── argocd-prod-values.yaml
+│               └── USE: Production environment overrides (HA, replicas)
+│
+├── cert-manager/
+│   ├── README.md
+│   │   └── USE: Cert-Manager component overview and reference
+│   └── terraform/
+│       ├── locals.tf
+│       │   └── USE: Local variables and computed values
+│       ├── main.tf
+│       │   └── USE: Deploy Cert-Manager using Helm to manage TLS certificates
+│       ├── outputs.tf
+│       │   └── USE: Export Cert-Manager service account and configuration details
+│       ├── variables.tf
+│       │   └── USE: Define customizable parameters for Cert-Manager
+│       └── workload-identity.tf
+│           └── USE: Configure GCP Workload Identity for Cert-Manager to access DNS
+│
+│
+├── docs/
+│   ├── ARCHITECTURE.md
+│   │   └── USE: Explain system design, component interactions, and data flow
+│   ├── GETTING_STARTED.md
+│   │   └── USE: Step-by-step quick start guide for new users
+│   ├── README.md
+│   │   └── USE: Documentation index and navigation hub
+│   ├── TROUBLESHOOTING.md
+│   │   └── USE: Common issues, debug commands, and solutions
+│   ├── TUTORIAL_ARGOCD.md
+│   │   └── USE: Manual ArgoCD installation guide (alternative to Terraform)
+│   ├── TUTORIAL_CERT_MANAGER.md
+│   │   └── USE: Manual Cert-Manager installation guide
+│   ├── TUTORIAL_GKE_SETUP.md
+│   │   └── USE: Manual GKE cluster creation using gcloud CLI
+│   ├── TUTORIAL_INGRESS.md
+│   │   └── USE: Manual Ingress Controller installation guide
+│   ├── TUTORIAL_LGTM.md
+│   │   └── USE: Manual LGTM stack deployment guide
+│   └── images/
+│       ├── architecture-diagram.png
+│       │   └── USE: Visual system architecture diagram
+│       ├── argocd-workflow.png
+│       │   └── USE: Visual GitOps deployment workflow diagram
+│       └── lgtm-flow.png
+│           └── USE: Visual LGTM component data flow diagram
+│
+├── ingress-controller/
+│   ├── README.md
+│   │   └── USE: Ingress Controller component overview
+│   └── terraform/
+│       ├── locals.tf
+│       │   └── USE: Local variables for ingress module
+│       ├── main.tf
+│       │   └── USE: Deploy Nginx Ingress Controller for HTTP/HTTPS routing
+│       ├── outputs.tf
+│       │   └── USE: Export load balancer endpoint and service information
+│       ├── variables.tf
+│       │   └── USE: Define customizable parameters for Ingress
+│       └── values.yaml
+│           └── USE: Helm chart configuration for Nginx Ingress Controller
+│
+└── lgtm-stack/
+    ├── README.md
+    │   └── USE: LGTM stack component overview and architecture
+    └── terraform/
+        ├── locals.tf
+        │   └── USE: Local variables for LGTM module
+        ├── main.tf
+        │   └── USE: Deploy all LGTM components (Prometheus, Loki, Mimir, Tempo, Grafana)
+        ├── outputs.tf
+        │   └── USE: Export endpoints and credentials for all LGTM components
+        ├── variables.tf
+        │   └── USE: Define customizable parameters for LGTM deployment
+        └── values/
+            ├── grafana-values.yaml
+            │   └── USE: Helm configuration for Grafana dashboards and datasources
+            ├── loki-values.yaml
+            │   └── USE: Helm configuration for Loki log storage and retention
+            ├── mimir-values.yaml
+            │   └── USE: Helm configuration for Mimir long-term metrics storage
+            ├── prometheus-values.yaml
+            │   └── USE: Helm configuration for Prometheus metrics scraping
+            └── tempo-values.yaml
+                └── USE: Helm configuration for Tempo distributed tracing
+```