docs: Revise README to enhance clarity and detail for Easy Deploy platform

- Updated project overview to reflect Easy Deploy as a SaaS platform for simplified AWS application deployment.
- Expanded sections on user onboarding, CI/CD pipelines, and deployment processes for better understanding.
- Added key benefits and detailed steps for AWS user setup, repository integration, and application deployment.
- Included diagrams to illustrate the CI/CD pipelines and deployment processes, improving visual comprehension.

Author: mo7amedgom3a

README.md

@@ -2,8 +2,67 @@
 
 ## Overview
 
-Easy Deploy Backend is a robust and scalable backend system designed to automate the deployment of applications using AWS services. It leverages Amazon ECS, ECR, CodeBuild, and other AWS components to provide a seamless CI/CD pipeline for containerized applications.
-This project aims to simplify the deployment process by providing a pre-configured infrastructure that can be easily customized and extended. It supports both Fargate and EC2 launch types, allowing for flexible resource management based on workload requirements.
+Easy Deploy is a SaaS (Software as a Service) platform that simplifies application deployment on AWS, designed for developers who want to focus on building great applications without worrying about DevOps or cloud infrastructure. Our platform handles all the complex AWS setup, containerization, and deployment processes automatically.
+
+Key benefits:
+- **Zero DevOps Knowledge Required**: Deploy your applications without understanding AWS, containers, or infrastructure
+- **Automated Infrastructure**: We handle all AWS resource provisioning and management
+- **Secure by Default**: Built-in security best practices for your applications
+- **Scalable Architecture**: Applications automatically scale based on demand
+- **Cost-Effective**: Pay only for the resources your application actually uses
+
+## How It Works
+
+### Our CI/CD Pipeline vs Your Application Pipeline
+
+Easy Deploy uses two distinct CI/CD pipelines:
+
+1. **Platform CI/CD Pipeline** (GitHub Actions):
+   - Manages the Easy Deploy platform itself
+   - Builds and deploys platform updates
+   - Handles infrastructure changes
+   - Ensures platform reliability and security
+
+![Platform CI/CD Pipeline](images/cicd_pipline.png)
+
+2. **Application CI/CD Pipeline** (AWS CodeBuild):
+   - Manages your application deployments
+   - Builds your application container
+   - Pushes to Amazon ECR
+   - Deploys to ECS
+   - Handles application updates
+
+![Application Deployment Pipeline](images/codebuild.png)
+
+### Deployment Process
+
+When you deploy an application through Easy Deploy, the following process occurs:
+
+1. **AWS User Setup**:
+   - System checks if you have an AWS user account
+   - If not, creates a new IAM user with necessary permissions
+   - Sets up secure access credentials
+   - Configures user-specific AWS resources
+
+![AWS User Setup](images/aws_user.png)
+
+2. **Repository Setup**:
+   - Clones your GitHub repository
+   - Stores it in a secure EFS (Elastic File System) location
+   - Copies pre-configured pipeline templates
+   - Sets up build and deployment configurations
+
+![Repository Setup](images/setup_user_repo.png)
+
+3. **Application Deployment**:
+   - CodeBuild accesses your code from EFS
+   - Builds your application container
+   - Pushes the image to ECR
+   - Deploys the container to ECS
+   - Configures load balancing and auto-scaling
+   - Stores build artifacts in S3
+
+![Application Deployment](images/deploy_app.png)
 
 ## Architecture
 
@@ -155,63 +214,43 @@ Benefits:
 - Regional service with automatic scaling
 ![ec2_instance_connect_endpoint](images/ec2_instance_connect.png)
 
-
 ## Deployment Process
 
-### 1. Infrastructure Setup
-
-1. Navigate to the Terraform directory:
-   ```bash
-   cd Backend/terraform
-   ```
-
-2. Initialize Terraform:
-Initialize the remote backend by running setup_backend.sh script which:
-- Creates an S3 bucket for storing Terraform state
-- Creates a DynamoDB table for state locking
-- Configures backend.tf with the created resources
-- Ensures proper state management across team members
-   ```bash
-   terraform init
-   ```
-
-3. Apply the infrastructure:
-   Apply the Terraform configuration to create all infrastructure resources:
-   - Creates VPC and networking components
-   - Sets up ECS cluster and services
-   - Configures load balancer and target groups
-   - Creates ECR repository
-   - Sets up CodeBuild project and IAM roles
-   - Establishes security groups and access controls
-   - Provisions NAT Gateway and VPC endpoints
-   - Creates EC2 Instance Connect Endpoint
-   
-   The --auto-approve flag skips the interactive approval step
-   The --lock=false flag allows concurrent Terraform operations
-
-   ```bash
-   terraform apply --auto-approve --lock=false
-   ```
+### 1. User Onboarding
+
+1. **AWS Account Setup**:
+   - System automatically creates an IAM user if needed
+   - Configures necessary permissions and policies
+   - Sets up secure access credentials
+   - Stores user information securely
+
+2. **Repository Integration**:
+   - Connect your GitHub repository
+   - System clones and stores your code in EFS
+   - Sets up build and deployment pipelines
+   - Configures environment variables
 
 ### 2. Application Deployment
 
-1. Build and push your Docker image:
-   ```bash
-   docker build -t your-app:latest .
-   docker tag your-app:latest $ECR_REPO_URL:latest
-   docker push $ECR_REPO_URL:latest
-   ```
-
-2. The CodeBuild pipeline will automatically execute the following steps:
-   - Access the source code from the EFS mount point where repositories are stored
-   - Install dependencies and run tests based on buildspec.yml configuration
-   - Build the application using the specified entry point and port
-   - Create an optimized Docker image with the application
-   - Tag and push the image to Amazon ECR with a unique deployment tag
-   - Update the ECS task definition with the new image
-   - Deploy the updated container to ECS and configure load balancer routing
-   - Monitor deployment health and roll back if needed
-   - Log all build and deployment steps to CloudWatch
+1. **Build Process**:
+   - CodeBuild accesses your code from EFS
+   - Installs dependencies
+   - Builds your application
+   - Creates optimized Docker image
+   - Pushes to ECR with unique tags
+
+2. **Deployment Process**:
+   - Updates ECS task definition
+   - Deploys new container version
+   - Configures load balancer
+   - Sets up auto-scaling
+   - Monitors deployment health
+
+3. **Post-Deployment**:
+   - Stores build artifacts in S3
+   - Updates deployment status
+   - Provides deployment URL
+   - Sets up monitoring and logging
 
 ## CI/CD Pipeline
 
@@ -272,7 +311,6 @@ You can connect to running containers using AWS Systems Manager Session Manager:
 4. Push to the branch
 5. Create a Pull Request
 
-
 ## Contributors
 - [Mohamed Gomaa](https://github.com/mo7amedgom3a)
 - [Adel Kazzaz](https://github.com/Adelkazzaz)