# sricharanreddy5414/cloudcart-elevance-internship architecture

> Architecture diagram of the GitHub repository sricharanreddy5414/cloudcart-elevance-internship, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sricharanreddy5414/cloudcart-elevance-internship
- Repository: https://github.com/sricharanreddy5414/cloudcart-elevance-internship

## Overview

CloudCart is an e-commerce project centered on EverShop, accompanied by local models and infrastructure designs for six AWS capabilities; the README explicitly says none has been deployed. The clearest implemented runtime path is the local upload API through upload authorization and presigning, with a separate EICAR-only scan worker. The graph also preserves the documented database, scaling, container-delivery, DNS/security, and CloudFront/image-storage capabilities. Relationships involving unsampled infrastructure are documented at the capability level, not verified as deployed wiring.

Main entry points: [`infrastructure/terraform/task-5-cloudfront-edge/main.tf`](https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/infrastructure/terraform/task-5-cloudfront-edge/main.tf) (CloudFront Distribution), [`application/evershop`](https://github.com/sricharanreddy5414/cloudcart-elevance-internship/tree/main/application/evershop) (EverShop Store), [`application/api/server.py`](https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/application/api/server.py) (Local Upload API), [`cloudcart/pipeline.py`](https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/cloudcart/pipeline.py) (Upload Authorization)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_store["Store and Database"]
  node_evershop["EverShop Store"]
  node_postgres[("PostgreSQL Store DB<br/>[docker-compose.yml]")]
  node_dbmodel["Database Security Model<br/>[db.py]"]
end

subgraph group_images["Image Storage"]
  node_uploadapi["Local Upload API<br/>[server.py]"]
  node_pipeline["Upload Authorization<br/>[pipeline.py]"]
  node_s3helpers["Image Storage Helpers<br/>[s3.py]"]
  node_scanworker["Quarantine Scan Worker<br/>[scan_worker.py]"]
  node_malwarehandler["EICAR Event Handler<br/>[handler.py]"]
  node_imagebucket[("Private Image Storage<br/>[main.tf]")]
end

subgraph group_edge["Image Delivery Edge"]
  node_cloudfront["CloudFront Distribution<br/>[main.tf]"]
  node_image_request["Image Request Handler<br/>[image-request.js]"]
  node_query_filter["Query Filter<br/>[query-filter.js]"]
  node_cache_headers["Cache Headers<br/>[cache-headers.js]"]
  node_signed_url["Signed URL Logic<br/>[signed-url.js]"]
  node_webp["WebP Response Logic<br/>[webp.js]"]
end

subgraph group_platform["AWS Platform Design"]
  node_dns_security["DNS and Edge Security<br/>[main.tf]"]
  node_rds_design[("Private RDS Design<br/>[main.tf]")]
  node_scaling_model["Scaling Model<br/>[scaling.py]"]
  node_ecs_design["ECS and ECR Delivery<br/>[main.tf]"]
  node_pipeline_config["CodePipeline Design<br/>[pipeline.json]"]
end

node_customer(("Store User"))

node_customer -->|"uses store"| node_evershop
node_evershop -->|"uses database"| node_postgres
node_uploadapi -->|"authorizes uploads"| node_pipeline
node_uploadapi -->|"presigns objects"| node_s3helpers
node_pipeline -->|"generates upload form"| node_s3helpers
node_scanworker -->|"processes objects"| node_pipeline
node_customer -.->|"requests upload"| node_uploadapi
node_image_request -->|"handles viewer request"| node_cloudfront
node_query_filter -->|"filters query"| node_cloudfront
node_cache_headers -->|"sets cache headers"| node_cloudfront
node_signed_url -->|"signs image access"| node_cloudfront
node_webp -->|"plans response conversion"| node_cloudfront
node_cloudfront -->|"uses private origin"| node_imagebucket
node_dns_security -.->|"secures store entry"| node_customer
node_rds_design -.->|"models database controls"| node_dbmodel
node_scaling_model -.->|"models store capacity"| node_evershop
node_ecs_design -->|"targets store deployment"| node_evershop
node_pipeline_config -->|"delivers containers"| node_ecs_design
node_imagebucket -.->|"supports image scanning"| node_malwarehandler

click node_evershop "https://github.com/sricharanreddy5414/cloudcart-elevance-internship/tree/main/application/evershop"
click node_postgres "https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/docker-compose.yml"
click node_dbmodel "https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/cloudcart/db.py"
click node_uploadapi "https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/application/api/server.py"
click node_pipeline "https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/cloudcart/pipeline.py"
click node_s3helpers "https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/cloudcart/s3.py"
click node_scanworker "https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/security/malware/scan_worker.py"
click node_malwarehandler "https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/security/malware/handler.py"
click node_imagebucket "https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/infrastructure/terraform/task-6-s3-storage/main.tf"
click node_cloudfront "https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/infrastructure/terraform/task-5-cloudfront-edge/main.tf"
click node_image_request "https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/application/edge-functions/image-request.js"
click node_query_filter "https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/application/edge-functions/query-filter.js"
click node_cache_headers "https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/application/edge-functions/cache-headers.js"
click node_signed_url "https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/application/edge-functions/signed-url.js"
click node_webp "https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/application/edge-functions/webp.js"
click node_dns_security "https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/infrastructure/terraform/task-1-route53-acm-waf/main.tf"
click node_rds_design "https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/infrastructure/terraform/task-2-secure-rds/main.tf"
click node_scaling_model "https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/cloudcart/scaling.py"
click node_ecs_design "https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/infrastructure/terraform/task-4-ecs-ecr/main.tf"
click node_pipeline_config "https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/ci-cd/codepipeline/pipeline.json"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_evershop,node_postgres,node_dbmodel,node_customer toneBlue
class node_uploadapi,node_pipeline,node_s3helpers,node_scanworker,node_malwarehandler,node_imagebucket toneAmber
class node_cloudfront,node_image_request,node_query_filter,node_cache_headers,node_signed_url,node_webp toneMint
class node_dns_security,node_rds_design,node_scaling_model,node_ecs_design,node_pipeline_config toneRose
```

## Components

### Store and Database

- [EverShop Store](https://github.com/sricharanreddy5414/cloudcart-elevance-internship/tree/main/application/evershop): `application/evershop`
- [PostgreSQL Store DB](https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/docker-compose.yml): `docker-compose.yml`
- [Database Security Model](https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/cloudcart/db.py): `cloudcart/db.py`

### Image Storage

- [Local Upload API](https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/application/api/server.py): `application/api/server.py`
- [Upload Authorization](https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/cloudcart/pipeline.py): `cloudcart/pipeline.py`
- [Image Storage Helpers](https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/cloudcart/s3.py): `cloudcart/s3.py`
- [Quarantine Scan Worker](https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/security/malware/scan_worker.py): `security/malware/scan_worker.py`
- [EICAR Event Handler](https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/security/malware/handler.py): `security/malware/handler.py`
- [Private Image Storage](https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/infrastructure/terraform/task-6-s3-storage/main.tf): `infrastructure/terraform/task-6-s3-storage/main.tf`

### Image Delivery Edge

- [CloudFront Distribution](https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/infrastructure/terraform/task-5-cloudfront-edge/main.tf): `infrastructure/terraform/task-5-cloudfront-edge/main.tf`
- [Image Request Handler](https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/application/edge-functions/image-request.js): `application/edge-functions/image-request.js`
- [Query Filter](https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/application/edge-functions/query-filter.js): `application/edge-functions/query-filter.js`
- [Cache Headers](https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/application/edge-functions/cache-headers.js): `application/edge-functions/cache-headers.js`
- [Signed URL Logic](https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/application/edge-functions/signed-url.js): `application/edge-functions/signed-url.js`
- [WebP Response Logic](https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/application/edge-functions/webp.js): `application/edge-functions/webp.js`

### AWS Platform Design

- [DNS and Edge Security](https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/infrastructure/terraform/task-1-route53-acm-waf/main.tf): `infrastructure/terraform/task-1-route53-acm-waf/main.tf`
- [Private RDS Design](https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/infrastructure/terraform/task-2-secure-rds/main.tf): `infrastructure/terraform/task-2-secure-rds/main.tf`
- [Scaling Model](https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/cloudcart/scaling.py): `cloudcart/scaling.py`
- [ECS and ECR Delivery](https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/infrastructure/terraform/task-4-ecs-ecr/main.tf): `infrastructure/terraform/task-4-ecs-ecr/main.tf`
- [CodePipeline Design](https://github.com/sricharanreddy5414/cloudcart-elevance-internship/blob/main/ci-cd/codepipeline/pipeline.json): `ci-cd/codepipeline/pipeline.json`

### Other components

- **Store User**

## Connections

- Store User → EverShop Store: uses store (evidence: `README.md`)
- EverShop Store → PostgreSQL Store DB: uses database (evidence: `README.md`)
- Local Upload API → Upload Authorization: authorizes uploads (evidence: `application/api/server.py`)
- Local Upload API → Image Storage Helpers: presigns objects (evidence: `application/api/server.py`)
- Upload Authorization → Image Storage Helpers: generates upload form (evidence: `cloudcart/pipeline.py`)
- Quarantine Scan Worker → Upload Authorization: processes objects (evidence: `security/malware/scan_worker.py`)
- Store User → Local Upload API: requests upload
- Image Request Handler → CloudFront Distribution: handles viewer request (evidence: `README.md`)
- Query Filter → CloudFront Distribution: filters query (evidence: `README.md`)
- Cache Headers → CloudFront Distribution: sets cache headers (evidence: `README.md`)
- Signed URL Logic → CloudFront Distribution: signs image access (evidence: `README.md`)
- WebP Response Logic → CloudFront Distribution: plans response conversion (evidence: `README.md`)
- CloudFront Distribution → Private Image Storage: uses private origin (evidence: `README.md`)
- DNS and Edge Security → Store User: secures store entry
- Private RDS Design → Database Security Model: models database controls
- Scaling Model → EverShop Store: models store capacity
- ECS and ECR Delivery → EverShop Store: targets store deployment (evidence: `README.md`)
- CodePipeline Design → ECS and ECR Delivery: delivers containers (evidence: `README.md`)
- Private Image Storage → EICAR Event Handler: supports image scanning
