# 27sayan/pc-wakeup-alert-using-aws-cloud architecture

> Architecture diagram of the GitHub repository 27sayan/pc-wakeup-alert-using-aws-cloud, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/27sayan/pc-wakeup-alert-using-aws-cloud
- Repository: https://github.com/27sayan/pc-wakeup-alert-using-aws-cloud

## Overview

PC-Wakeup-Alert is a personal-computer startup notification project. Its documented workflow uses a Windows Startup-folder VBScript and the PC-side key listener, which reacts to the first key press by invoking Lambda directly and posting the payload to API Gateway. Lambda sends an SES email; the README also describes an API Gateway/Lambda-to-SNS setup and an SNS email subscription. The VBScript contents and deployed AWS wiring were not sampled, so those links rely on README statements rather than inspected implementation.

Main entry points: [`pc.py`](https://github.com/27sayan/pc-wakeup-alert-using-aws-cloud/blob/main/pc.py) (PC Key Listener), [`awslambda.py`](https://github.com/27sayan/pc-wakeup-alert-using-aws-cloud/blob/main/awslambda.py) (Lambda Handler), [`python.vbs`](https://github.com/27sayan/pc-wakeup-alert-using-aws-cloud/blob/main/python.vbs) (Startup Script)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pc_client["PC Client"]
  node_startup_script["Startup Script<br/>[python.vbs]"]
  node_pc_listener["PC Key Listener<br/>[pc.py]"]
end

subgraph group_aws_delivery["AWS Delivery"]
  node_api_gateway["API Gateway"]
  node_lambda["Lambda Handler<br/>[awslambda.py]"]
end

subgraph group_notifications["Notifications"]
  node_sns["SNS Topic"]
  node_ses["SES Email"]
end

node_user(("PC User"))
node_email_recipient(("Email Recipient"))

node_user -->|"starts PC"| node_startup_script
node_startup_script -.->|"launches listener"| node_pc_listener
node_pc_listener -->|"invokes directly"| node_lambda
node_pc_listener -->|"posts payload"| node_api_gateway
node_api_gateway -->|"integrates with"| node_lambda
node_api_gateway -.->|"sets destination"| node_sns
node_lambda -->|"sends email"| node_ses
node_sns -->|"emails subscription"| node_email_recipient
node_ses -->|"delivers email"| node_email_recipient

click node_startup_script "https://github.com/27sayan/pc-wakeup-alert-using-aws-cloud/blob/main/python.vbs"
click node_pc_listener "https://github.com/27sayan/pc-wakeup-alert-using-aws-cloud/blob/main/pc.py"
click node_lambda "https://github.com/27sayan/pc-wakeup-alert-using-aws-cloud/blob/main/awslambda.py"

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_startup_script,node_pc_listener,node_user toneBlue
class node_api_gateway,node_lambda toneAmber
class node_sns,node_ses toneMint
class node_email_recipient toneIndigo
```

## Components

### PC Client

- [Startup Script](https://github.com/27sayan/pc-wakeup-alert-using-aws-cloud/blob/main/python.vbs): `python.vbs`
- [PC Key Listener](https://github.com/27sayan/pc-wakeup-alert-using-aws-cloud/blob/main/pc.py): `pc.py`

### AWS Delivery

- **API Gateway**
- [Lambda Handler](https://github.com/27sayan/pc-wakeup-alert-using-aws-cloud/blob/main/awslambda.py): `awslambda.py`

### Notifications

- **SNS Topic**
- **SES Email**

### Other components

- **PC User**
- **Email Recipient**

## Connections

- PC User → Startup Script: starts PC (evidence: `README.md`)
- Startup Script → PC Key Listener: launches listener
- PC Key Listener → Lambda Handler: invokes directly (evidence: `pc.py`)
- PC Key Listener → API Gateway: posts payload (evidence: `pc.py`)
- API Gateway → Lambda Handler: integrates with (evidence: `README.md`)
- API Gateway → SNS Topic: sets destination (evidence: `README.md`)
- Lambda Handler → SES Email: sends email (evidence: `awslambda.py`)
- SNS Topic → Email Recipient: emails subscription (evidence: `README.md`)
- SES Email → Email Recipient: delivers email (evidence: `README.md`)
