Update README to enhance project description and add monitoring details

Author: karimzakzouk

README.md

@@ -1,7 +1,6 @@
-
 # 🌌 Solar System - Enterprise DevOps Application
 
-A comprehensive Node.js web application demonstrating enterprise-grade DevOps practices with complete CI/CD pipeline, Infrastructure as Code, and GitOps implementation.
+A comprehensive Node.js web application demonstrating enterprise-grade DevOps practices with complete CI/CD pipeline, Infrastructure as Code, GitOps implementation, and comprehensive monitoring.
 
 [![Node.js CI](https://github.com/KarimZakzouk/Graduation-Project-Devops/actions/workflows/ci.yml/badge.svg)](https://github.com/KarimZakzouk/Graduation-Project-Devops/actions/workflows/ci.yml)
 [![Docker Build](https://github.com/KarimZakzouk/Graduation-Project-Devops/actions/workflows/docker.yml/badge.svg)](https://github.com/KarimZakzouk/Graduation-Project-Devops/actions/workflows/docker.yml)
@@ -17,7 +16,8 @@ This project showcases a **Solar System visualization web application** built wi
 - **Node.js/Express backend** with MongoDB integration
 - **Complete CI/CD pipeline** with GitHub Actions
 - **Infrastructure as Code** using Terraform and AWS EKS
-- **GitOps deployment** with ArgoCD
+- **GitOps deployment** with ArgoCD for automated application delivery
+- **Comprehensive monitoring** with Prometheus and Grafana
 - **Containerized deployment** with Docker and Kubernetes
 - **Multi-registry container support** (Docker Hub + GitHub Container Registry)
 
@@ -34,13 +34,14 @@ This project showcases a **Solar System visualization web application** built wi
                                 ▼
 ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
 │   Terraform     │───▶│   AWS EKS       │───▶│     ArgoCD      │
-│  Infrastructure │    │   Kubernetes    │    │    GitOps       │
+│  Infrastructure │    │   Kubernetes    │    │  GitOps Deploy  │
 └─────────────────┘    └─────────────────┘    └─────────────────┘
                                 │
                                 ▼
 ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
-│    MongoDB      │───▶│  Solar System   │───▶│   LoadBalancer  │
-│   Database      │    │   Application   │    │   Public Access │
+│   Prometheus    │───▶│  Solar System   │───▶│   LoadBalancer  │
+│   + Grafana     │    │   Application   │    │   Public Access │
+│   Monitoring    │    │   + MongoDB     │    │                 │
 └─────────────────┘    └─────────────────┘    └─────────────────┘
 ```
 
@@ -60,9 +61,12 @@ This project showcases a **Solar System visualization web application** built wi
 - **Cloud Provider**: AWS (EKS, VPC, Load Balancers, S3)
 - **Infrastructure as Code**: Terraform with modular design
 - **CI/CD**: GitHub Actions with workflow orchestration
-- **GitOps**: ArgoCD for automated deployments
+- **GitOps**: ArgoCD for automated deployments and drift detection
 - **Container Registry**: Docker Hub + GitHub Container Registry
-- **Monitoring**: Built-in health checks and logging
+- **Monitoring & Observability**: 
+  - **Prometheus**: Metrics collection and alerting
+  - **Grafana**: Visualization dashboards and analytics
+  - Built-in health checks and structured logging
 
 ---
 
@@ -93,7 +97,18 @@ This project showcases a **Solar System visualization web application** built wi
 │   ├── 5-outputs.tf         # Output values
 │   └── modules/
 │       ├── vpc/             # VPC module
-│       └── eks/             # EKS cluster module
+│       ├── eks/             # EKS cluster module
+│       ├── monitoring/      # Prometheus & Grafana setup
+│       └── argocd/          # ArgoCD installation
+│
+├── 📊 Monitoring & GitOps
+│   ├── monitoring/
+│   │   ├── prometheus/      # Prometheus configuration
+│   │   ├── grafana/        # Grafana dashboards
+│   │   └── alerting/       # Alert rules & notifications
+│   └── argocd/
+│       ├── applications/    # ArgoCD application definitions
+│       └── projects/       # ArgoCD project configurations
 │
 ├── 🔄 CI/CD Workflows
 │   └── .github/workflows/
@@ -121,7 +136,7 @@ This project showcases a **Solar System visualization web application** built wi
 ### **2. Continuous Deployment (CD)**
 - **Multi-Registry Push**: Docker Hub + GitHub Container Registry
 - **Infrastructure Deployment**: Terraform-managed AWS EKS
-- **GitOps Deployment**: ArgoCD automated sync
+- **GitOps Deployment**: ArgoCD automated sync and self-healing
 - **Environment Promotion**: Automated deployment pipeline
 
 ### **3. GitHub Actions Workflows**
@@ -145,6 +160,7 @@ This project showcases a **Solar System visualization web application** built wi
 - Infrastructure planning & deployment
 - State management with S3 backend
 - AWS EKS cluster provisioning
+- ArgoCD and monitoring stack deployment
 
 #### **Deploy Workflow** (`deploy.yml`)
 - Kubernetes secret management
@@ -153,220 +169,59 @@ This project showcases a **Solar System visualization web application** built wi
 
 ---
 
-## ☸️ Kubernetes Infrastructure
-
-### **AWS EKS Cluster**
-- **Cluster Version**: Kubernetes 1.30
-- **Node Groups**: Auto-scaling worker nodes
-- **Networking**: VPC with public/private subnets
-- **Security**: RBAC, Security Groups, IAM roles
-
-### **Application Deployment**
-- **Helm Charts**: Templated Kubernetes manifests
-- **ConfigMaps & Secrets**: Environment configuration
-- **Services**: LoadBalancer for external access
-- **Health Checks**: Readiness and liveness probes
-
-### **GitOps with ArgoCD**
-- **Automated Sync**: Git-based deployments
-- **Self-Healing**: Automatic drift correction
-- **Rollback**: Easy revert capabilities
-- **UI Dashboard**: Visual deployment management
+## 🎯 GitOps with ArgoCD
 
----
+### **ArgoCD Implementation**
+- **Declarative GitOps**: Git repository as single source of truth
+- **Automated Sync**: Continuous monitoring and deployment of changes
+- **Self-Healing**: Automatic correction of configuration drift
+- **Rollback Capabilities**: Easy revert to previous application states
+- **Multi-Environment Support**: Separate configurations for dev/staging/prod
+- **RBAC Integration**: Role-based access control for team collaboration
 
-## � Getting Started
-
-### **Prerequisites**
-- AWS Account with appropriate permissions
-- Docker Desktop
-- Node.js 18+ 
-- Git
-
-### **Local Development**
-
-1. **Clone the repository**
-   ```bash
-   git clone https://github.com/KarimZakzouk/Graduation-Project-Devops.git
-   cd Graduation-Project-Devops
-   ```
-
-2. **Install dependencies**
-   ```bash
-   npm install
-   ```
-
-3. **Run tests**
-   ```bash
-   npm test
-   npm run coverage
-   ```
-
-4. **Start the application**
-   ```bash
-   npm start
-   # Application available at http://localhost:3000
-   ```
-
-### **Docker Development**
-
-1. **Build the image**
-   ```bash
-   docker build -t solar-system:latest .
-   ```
-
-2. **Run the container**
-   ```bash
-   docker run -p 3000:3000 \
-     -e MONGO_URI="your-mongo-uri" \
-     -e MONGO_USERNAME="your-username" \
-     -e MONGO_PASSWORD="your-password" \
-     solar-system:latest
-   ```
+### **ArgoCD Features Used**
+- **Application Sets**: Manage multiple applications across environments
+- **Sync Policies**: Automated and manual sync strategies
+- **Health Checks**: Application health monitoring and reporting
+- **Resource Hooks**: Pre/post deployment hooks for complex workflows
+- **Notifications**: Integration with Slack/email for deployment status
 
 ---
 
-## 🔧 Production Deployment
-
-### **Required Secrets**
-Configure the following in GitHub Secrets:
-
-```bash
-# AWS Credentials
-AWS_ACCESS_KEY_ID
-AWS_SECRET_ACCESS_KEY
-
-# Container Registry
-DOCKER_USERNAME
-DOCKER_TOKEN
-
-# Database
-MONGO_URI
-MONGO_USERNAME
-MONGO_PASSWORD
-```
-
-### **Deployment Steps**
+## 📊 Monitoring & Observability
 
-1. **Trigger Main Pipeline**
-   - Go to Actions → Solar System - Main Pipeline
-   - Click "Run workflow"
-   - Configure options as needed
+### **Prometheus Stack**
+- **Metrics Collection**: Application, infrastructure, and Kubernetes metrics
+- **Service Discovery**: Automatic discovery of monitoring targets
+- **Alerting Rules**: Custom alerts for application and infrastructure health
+- **Data Retention**: Configurable metric storage and cleanup policies
+- **High Availability**: Multi-replica Prometheus setup with persistent storage
 
-2. **Monitor Deployment**
-   - Infrastructure: Check Terraform workflow
-   - Application: Check ArgoCD dashboard
-   - Access: Get LoadBalancer URL from AWS console
+### **Grafana Dashboards**
+- **Application Metrics**: Request rates, response times, error rates
+- **Infrastructure Monitoring**: Node CPU, memory, disk, and network usage
+- **Kubernetes Cluster**: Pod status, resource utilization, cluster health
+- **Business Metrics**: User interactions, feature usage analytics
+- **Custom Dashboards**: Solar system specific metrics and visualizations
 
-### **Manual Deployment**
+### **Key Monitoring Features**
+- **Real-time Dashboards**: Live metrics visualization
+- **Alerting**: Slack/email notifications for critical issues
+- **Log Aggregation**: Centralized logging with structured format
+- **Distributed Tracing**: Request flow tracking across services
+- **SLA Monitoring**: Service level objectives tracking
 
-```bash
-# 1. Deploy Infrastructure
-cd Terraform
-terraform init
-terraform plan
-terraform apply
-
-# 2. Configure kubectl
-aws eks update-kubeconfig --name otel-cluster --region us-east-1
-
-# 3. Deploy Application (handled by ArgoCD automatically)
-kubectl get applications -n argocd
-```
 
 ---
 
-## 🔍 Monitoring & Operations
-
-### **Application Monitoring**
-- Health check endpoints
-- Application logs via kubectl
-- Performance metrics
-
-### **Infrastructure Monitoring**
-- AWS CloudWatch integration
-- EKS cluster metrics
-- Node and pod resource usage
-
-### **Access & Management**
-```bash
-# Get application URL
-kubectl get svc solar-system-svc
-
-# Check ArgoCD dashboard
-kubectl get svc argocd-server -n argocd
-
-# View application logs
-kubectl logs -l app=solar-system-helm
-
-# Scale application
-kubectl scale deployment solar-system-helm --replicas=3
-```
-
----
-
-## 🗑️ Cleanup
-
-To destroy all resources:
-
-```bash
-# Via GitHub Actions
-# Go to Actions → Terraform Destroy Workflow → Run workflow
-
-# Or manually
-cd Terraform
-terraform destroy -auto-approve
-```
-
----
-
-## 📊 Project Metrics
-
-- **Test Coverage**: 85%+ enforced
-- **Build Time**: ~5-8 minutes end-to-end
-- **Deployment Time**: ~10-15 minutes for full infrastructure
-- **Container Size**: Optimized with Alpine Linux
-- **Uptime**: High availability with auto-scaling
-
----
-
-## 🤝 Contributing
-
-1. Fork the repository
-2. Create a feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit changes (`git commit -m 'Add amazing feature'`)
-4. Push to branch (`git push origin feature/amazing-feature`)
-5. Open a Pull Request
-
----
-
-## 📄 License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
----
-
-## 👥 Authors
-
-- **Karim Zakzouk** - *DevOps Implementation* - [@KarimZakzouk](https://github.com/KarimZakzouk)
-- **Siddharth Barahalikar** - *Original Application* - [LinkedIn](https://www.linkedin.com/in/barahalikar-siddharth/)
-
----
-
-## 🙏 Acknowledgments
-
-- Solar System data and images
-- Open source DevOps tools community
-- AWS EKS documentation and best practices
-- ArgoCD project for GitOps capabilities
-
----
-
-<div align="center">
-
-**🌟 Star this repository if you found it helpful! 🌟**
+## ☸️ Kubernetes Infrastructure
 
-[![GitHub stars](https://img.shields.io/github/stars/KarimZakzouk/Graduation-Project-Devops?style=social)](https://github.com/KarimZakzouk/Graduation-Project-Devops/stargazers)
-[![GitHub forks](https://img.shields.io/github/forks/KarimZakzouk/Graduation-Project-Devops?style=social)](https://github.com/KarimZakzouk/Graduation-Project-Devops/network/members)
+### **AWS EKS Cluster**
+- **Cluster Version**: Kubernetes 1.30
+- **Node Groups**: Auto-scaling worker nodes (t3.medium instances)
+- **Networking**: VPC with public/private subnets across multiple AZs
 
-</div>
+### **Application Deployment**
+- **Helm Charts**: Templated Kubernetes manifests with values override
+- **Secrets**: Environment configuration and sensitive data
+- **Services**: LoadBalancer for external access with health checks