# naveen359-g/host-resume-on-aws-s3 architecture

> Architecture diagram of the GitHub repository naveen359-g/host-resume-on-aws-s3, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/naveen359-g/host-resume-on-aws-s3
- Repository: https://github.com/naveen359-g/host-resume-on-aws-s3

## Overview

##### Project Type and Purpose
- This is an infrastructure‐focused, static website hosting project. You’re deploying a simple HTML/CSS/JS “resume” site to AWS S3, fronting it with CloudFront for CDN and HTTPS (via ACM), and managing your custom domain and DNS in Route 53.

##### File Structure Analysis
- Top level only contains static assets:
- index.html
- styles.css
- script.js
- No application server code—everything is served statically out of S3.

##### Key Components
a. Client / Browser
b. AWS Route 53 (DNS & domain registration / hosted zone)
c. AWS Certificate Manager (ACM) in us-east-1
d. AWS CloudFront Distribution
e. AWS S3 Bucket (static website hosting)
f. (Optional) ACM DNS validation CNAME record in Route 53

##### Relationships & Data Flows
1. User enters “yourdomain.com” in the browser.
2. DNS query goes to Route 53 → returns alias record pointing to CloudFront distribution.
3. Browser connects (HTTPS) to CloudFront edge location (SSL terminated with ACM certificate).
4. CloudFront edge checks cache; if miss, it fetches objects from S3 website endpoint origin.
5. CloudFront returns static files (HTML/CSS/JS) to the client over HTTPS.

##### Architectural Patterns & Principles
- CDN + static site hosting: offload all dynamic logic; scale globally.
- SSL termination at CDN edge: security and performance.
- DNS alias records: tightly integrate Route 53 with AWS resources.
- Infrastructure components are fully managed (no servers) → high availability, low maintenance.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Client
    Client["Client Browser"]:::external

    %% DNS & CDN Layer
    subgraph "DNS & CDN Layer"
        Route53["Route 53 Hosted Zone"]:::aws
        ACM["ACM (us-east-1) Certificate"]:::aws
        CloudFront["CloudFront Distribution"]:::aws
    end

    %% Origin Storage Layer
    subgraph "Origin Storage Layer"
        S3["S3 Bucket: myresume.com"]:::aws
        Index["index.html"]:::static
        Styles["styles.css"]:::static
        Script["script.js"]:::static
    end

    %% Flow connections
    Client -->|"DNS query"| Route53
    Route53 -->|"Alias to CloudFront"| CloudFront
    Client -->|"HTTPS GET /index.html"| CloudFront
    CloudFront -->|"Fetch static asset (cache miss)"| S3
    S3 -->|"static files"| CloudFront
    CloudFront -->|"HTTPS response"| Client

    %% ACM validation CNAME record
    ACM -.->|"CNAME validation record"| Route53

    %% Click events for static files
    click Index "https://github.com/naveen359-g/host-resume-on-aws-s3/blob/main/index.html"
    click Styles "https://github.com/naveen359-g/host-resume-on-aws-s3/blob/main/styles.css"
    click Script "https://github.com/naveen359-g/host-resume-on-aws-s3/blob/main/script.js"

    %% Styles
    classDef external fill:#cccccc,stroke:#666666,color:#000000
    classDef aws fill:#cceeff,stroke:#0366d6,color:#000000
    classDef static fill:#e0ffe0,stroke:#2e8b57,color:#000000
```
